pdms installation guia

54
7/14/2019 PDMS Installation Guia http://slidepdf.com/reader/full/pdms-installation-guia 1/54  Installation Guide Version 11.6.SP1 Windows 2000 and Windows XP pdms116SP1/PDMS Installation Guide issue 180505

Upload: maping

Post on 29-Oct-2015

95 views

Category:

Documents


1 download

TRANSCRIPT

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 154

Installation GuideVersion 116SP1

Windows 2000 and Windows XP

pdms116SP1PDMS Installation Guide issue 180505

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 254

PLEASE NOTE

AVEVA Solutions has a policy of continuing product development therefore the

information contained in this document may be subject to change without notice

AVEVA SOLUTIONS MAKES NO WARRANTY OF ANY KIND WITH REGARD TO

THIS DOCUMENT INCLUDING BUT NOT LIMITED TO THE IMPLIED

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

PURPOSE

While every effort has been made to verify the accuracy of this document AVEVA

Solutions shall not be liable for errors contained herein or direct indirect special

incidental or consequential damages in connection with the furnishing performance or

use of this material

This manual provides documentation relating to products to which you may not have

access or which may not be licensed to you For further information on which Products

are licensed to you please refer to your licence conditions

copy Copyright 1991 through 2005 AVEVA Solutions Limited

All rights reserved No part of this document may be reproduced stored in a retrieval

system or transmitted in any form or by any means electronic mechanical

photocopying recording or otherwise without prior written permission of AVEVA

Solutions

The software programs described in this document are confidential information and

proprietary products of AVEVA Solutions or its licensors

For details of AVEVAs worldwide sales and support offices see our website athttpwwwavevacom

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

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 354

Revision History

Date Version Notes

Sept 2004 116 Updated

Hardware recommendation Upgrading Licensing

AutoDRAFT chapter (versions supported)

New

Information on NET and its effect on PDMS installation

Background Process Manager

Minor corrections and updates

Added Section 47 ndash Running PDMS in batch

May 2005 116SP1 Updated

pdms116SP1PDMS Installation Guide issue 180505

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 454

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 554

Contents

1 Introduct ion 1-1 11 Contents of this Guide 1-1 12 Associated products 1-2

2 Hardware and Software Requirements 2-1 21 Hardware 2-1

211 Graphics Cards 2-1 22 Software and Configuration 2-2

3 Installing PDMS 3-1 31 Basic Installation 3-1

311 NET Framework Installation 3-2 32 Uninstalling and Reinstalling 3-2 33 FLEXMAN License Manager 3-2 34 Remote Installation 3-3

4 Setting Up the Windows Environment 4-1 41 Windows Control Panel 4-1 42 Graphics Card Settings 4-2 43 Setting the License File Location 4-2 44 PDMS Environment Variables 4-3 45 Running PDMS from a Command Prompt Window 4-5 46 Customising PDMS Start-Up 4-5 47 Running PDMS in batch4-7 48 Plotting 4-7

5 Language Support 5-1 51 Preparing Windows to use Supported Languages 5-2

511 Windows 20005-2 512 Windows XP5-2

52 Preparing PDMS to use Latin Languages 5-3 53 Preparing PDMS to use Far Eastern Languages 5-3

6 Running PDMS under Windows 6-1 61 Spaces in Windows pathnames 6-1

VANTAGE PDMS Installation Guide contents-iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 654

Contents

62 Linking to Microsoft Excel 6-1 63 Windows Parameters 6-2

7 PDMS Projects 7-1 71 The Sample Project 7-1

711 Copying Project SAM to Your User Area 7-1 712 Users and Teams in the Sample Project 7-2 713 MDBs in the Sample Project 7-3

72 Creating PDMS Projects 7-3 721 The Sample Project and your own Projects 7-4

8 Installing AutoDRAFT 8-1 81 Compatibility 8-1 82 The AutoDRAFT Software 8-1 83 Configuring AutoDRAFT with AutoCAD 8-2 84 Installing and configuring AutoCAD 8-2

841 AutoCAD R2002 8-3 842 AutoCAD R2004 8-3

85 Getting Started with AutoCAD 8-3 86 Application Macros for use with PDMS DRAFT 8-4

9 Upgrading Projects to Version 116SP1 9-1 10 Troubleshooting10-1

101 General10-1 102 License Manager Errors10-1 103 Entering PDMS 10-2 104 Problems with Graphics 10-3

11 Structure of PDMS on NET11-1 111 Overview 11-1 112 PDMSEXE11-1 113 GUI module structure 11-1

1131 Wrappers 11-2 1132 NET Loading rules11-2 1133 Win32 DLLs 11-3

114 Components 11-3 1141 PDMSEXE directory 11-3 1142 PDMSEXEDesign subdirectory11-5 1143 PDMSEXEDraft subdirectory 11-5

contents-ii VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 754

Contents

1144 PDMSEXEMonitor subdirectory 11-5 1145 PDMSEXEIsodraft subdirectory 11-5 1146

PDMSEXEAdmin subdirectory 11-5

1147 Add-ins 11-5

115 Forms and Menus 11-5 12 Troubleshoot ing the NET installation 12-1

121 Version Error 12-1 122 Wrappers or a dependency missing 12-1 123 Interface incompatibility 12-2 124 Security error with thin client 12-2 125

No Add-ins12-4

126 Window Layout 12-4 127 Serialization 12-4

VANTAGE PDMS Installation Guide contents-ii iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 254

PLEASE NOTE

AVEVA Solutions has a policy of continuing product development therefore the

information contained in this document may be subject to change without notice

AVEVA SOLUTIONS MAKES NO WARRANTY OF ANY KIND WITH REGARD TO

THIS DOCUMENT INCLUDING BUT NOT LIMITED TO THE IMPLIED

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

PURPOSE

While every effort has been made to verify the accuracy of this document AVEVA

Solutions shall not be liable for errors contained herein or direct indirect special

incidental or consequential damages in connection with the furnishing performance or

use of this material

This manual provides documentation relating to products to which you may not have

access or which may not be licensed to you For further information on which Products

are licensed to you please refer to your licence conditions

copy Copyright 1991 through 2005 AVEVA Solutions Limited

All rights reserved No part of this document may be reproduced stored in a retrieval

system or transmitted in any form or by any means electronic mechanical

photocopying recording or otherwise without prior written permission of AVEVA

Solutions

The software programs described in this document are confidential information and

proprietary products of AVEVA Solutions or its licensors

For details of AVEVAs worldwide sales and support offices see our website athttpwwwavevacom

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

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 354

Revision History

Date Version Notes

Sept 2004 116 Updated

Hardware recommendation Upgrading Licensing

AutoDRAFT chapter (versions supported)

New

Information on NET and its effect on PDMS installation

Background Process Manager

Minor corrections and updates

Added Section 47 ndash Running PDMS in batch

May 2005 116SP1 Updated

pdms116SP1PDMS Installation Guide issue 180505

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 454

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 554

Contents

1 Introduct ion 1-1 11 Contents of this Guide 1-1 12 Associated products 1-2

2 Hardware and Software Requirements 2-1 21 Hardware 2-1

211 Graphics Cards 2-1 22 Software and Configuration 2-2

3 Installing PDMS 3-1 31 Basic Installation 3-1

311 NET Framework Installation 3-2 32 Uninstalling and Reinstalling 3-2 33 FLEXMAN License Manager 3-2 34 Remote Installation 3-3

4 Setting Up the Windows Environment 4-1 41 Windows Control Panel 4-1 42 Graphics Card Settings 4-2 43 Setting the License File Location 4-2 44 PDMS Environment Variables 4-3 45 Running PDMS from a Command Prompt Window 4-5 46 Customising PDMS Start-Up 4-5 47 Running PDMS in batch4-7 48 Plotting 4-7

5 Language Support 5-1 51 Preparing Windows to use Supported Languages 5-2

511 Windows 20005-2 512 Windows XP5-2

52 Preparing PDMS to use Latin Languages 5-3 53 Preparing PDMS to use Far Eastern Languages 5-3

6 Running PDMS under Windows 6-1 61 Spaces in Windows pathnames 6-1

VANTAGE PDMS Installation Guide contents-iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 654

Contents

62 Linking to Microsoft Excel 6-1 63 Windows Parameters 6-2

7 PDMS Projects 7-1 71 The Sample Project 7-1

711 Copying Project SAM to Your User Area 7-1 712 Users and Teams in the Sample Project 7-2 713 MDBs in the Sample Project 7-3

72 Creating PDMS Projects 7-3 721 The Sample Project and your own Projects 7-4

8 Installing AutoDRAFT 8-1 81 Compatibility 8-1 82 The AutoDRAFT Software 8-1 83 Configuring AutoDRAFT with AutoCAD 8-2 84 Installing and configuring AutoCAD 8-2

841 AutoCAD R2002 8-3 842 AutoCAD R2004 8-3

85 Getting Started with AutoCAD 8-3 86 Application Macros for use with PDMS DRAFT 8-4

9 Upgrading Projects to Version 116SP1 9-1 10 Troubleshooting10-1

101 General10-1 102 License Manager Errors10-1 103 Entering PDMS 10-2 104 Problems with Graphics 10-3

11 Structure of PDMS on NET11-1 111 Overview 11-1 112 PDMSEXE11-1 113 GUI module structure 11-1

1131 Wrappers 11-2 1132 NET Loading rules11-2 1133 Win32 DLLs 11-3

114 Components 11-3 1141 PDMSEXE directory 11-3 1142 PDMSEXEDesign subdirectory11-5 1143 PDMSEXEDraft subdirectory 11-5

contents-ii VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 754

Contents

1144 PDMSEXEMonitor subdirectory 11-5 1145 PDMSEXEIsodraft subdirectory 11-5 1146

PDMSEXEAdmin subdirectory 11-5

1147 Add-ins 11-5

115 Forms and Menus 11-5 12 Troubleshoot ing the NET installation 12-1

121 Version Error 12-1 122 Wrappers or a dependency missing 12-1 123 Interface incompatibility 12-2 124 Security error with thin client 12-2 125

No Add-ins12-4

126 Window Layout 12-4 127 Serialization 12-4

VANTAGE PDMS Installation Guide contents-ii iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 354

Revision History

Date Version Notes

Sept 2004 116 Updated

Hardware recommendation Upgrading Licensing

AutoDRAFT chapter (versions supported)

New

Information on NET and its effect on PDMS installation

Background Process Manager

Minor corrections and updates

Added Section 47 ndash Running PDMS in batch

May 2005 116SP1 Updated

pdms116SP1PDMS Installation Guide issue 180505

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 454

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 554

Contents

1 Introduct ion 1-1 11 Contents of this Guide 1-1 12 Associated products 1-2

2 Hardware and Software Requirements 2-1 21 Hardware 2-1

211 Graphics Cards 2-1 22 Software and Configuration 2-2

3 Installing PDMS 3-1 31 Basic Installation 3-1

311 NET Framework Installation 3-2 32 Uninstalling and Reinstalling 3-2 33 FLEXMAN License Manager 3-2 34 Remote Installation 3-3

4 Setting Up the Windows Environment 4-1 41 Windows Control Panel 4-1 42 Graphics Card Settings 4-2 43 Setting the License File Location 4-2 44 PDMS Environment Variables 4-3 45 Running PDMS from a Command Prompt Window 4-5 46 Customising PDMS Start-Up 4-5 47 Running PDMS in batch4-7 48 Plotting 4-7

5 Language Support 5-1 51 Preparing Windows to use Supported Languages 5-2

511 Windows 20005-2 512 Windows XP5-2

52 Preparing PDMS to use Latin Languages 5-3 53 Preparing PDMS to use Far Eastern Languages 5-3

6 Running PDMS under Windows 6-1 61 Spaces in Windows pathnames 6-1

VANTAGE PDMS Installation Guide contents-iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 654

Contents

62 Linking to Microsoft Excel 6-1 63 Windows Parameters 6-2

7 PDMS Projects 7-1 71 The Sample Project 7-1

711 Copying Project SAM to Your User Area 7-1 712 Users and Teams in the Sample Project 7-2 713 MDBs in the Sample Project 7-3

72 Creating PDMS Projects 7-3 721 The Sample Project and your own Projects 7-4

8 Installing AutoDRAFT 8-1 81 Compatibility 8-1 82 The AutoDRAFT Software 8-1 83 Configuring AutoDRAFT with AutoCAD 8-2 84 Installing and configuring AutoCAD 8-2

841 AutoCAD R2002 8-3 842 AutoCAD R2004 8-3

85 Getting Started with AutoCAD 8-3 86 Application Macros for use with PDMS DRAFT 8-4

9 Upgrading Projects to Version 116SP1 9-1 10 Troubleshooting10-1

101 General10-1 102 License Manager Errors10-1 103 Entering PDMS 10-2 104 Problems with Graphics 10-3

11 Structure of PDMS on NET11-1 111 Overview 11-1 112 PDMSEXE11-1 113 GUI module structure 11-1

1131 Wrappers 11-2 1132 NET Loading rules11-2 1133 Win32 DLLs 11-3

114 Components 11-3 1141 PDMSEXE directory 11-3 1142 PDMSEXEDesign subdirectory11-5 1143 PDMSEXEDraft subdirectory 11-5

contents-ii VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 754

Contents

1144 PDMSEXEMonitor subdirectory 11-5 1145 PDMSEXEIsodraft subdirectory 11-5 1146

PDMSEXEAdmin subdirectory 11-5

1147 Add-ins 11-5

115 Forms and Menus 11-5 12 Troubleshoot ing the NET installation 12-1

121 Version Error 12-1 122 Wrappers or a dependency missing 12-1 123 Interface incompatibility 12-2 124 Security error with thin client 12-2 125

No Add-ins12-4

126 Window Layout 12-4 127 Serialization 12-4

VANTAGE PDMS Installation Guide contents-ii iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 454

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 554

Contents

1 Introduct ion 1-1 11 Contents of this Guide 1-1 12 Associated products 1-2

2 Hardware and Software Requirements 2-1 21 Hardware 2-1

211 Graphics Cards 2-1 22 Software and Configuration 2-2

3 Installing PDMS 3-1 31 Basic Installation 3-1

311 NET Framework Installation 3-2 32 Uninstalling and Reinstalling 3-2 33 FLEXMAN License Manager 3-2 34 Remote Installation 3-3

4 Setting Up the Windows Environment 4-1 41 Windows Control Panel 4-1 42 Graphics Card Settings 4-2 43 Setting the License File Location 4-2 44 PDMS Environment Variables 4-3 45 Running PDMS from a Command Prompt Window 4-5 46 Customising PDMS Start-Up 4-5 47 Running PDMS in batch4-7 48 Plotting 4-7

5 Language Support 5-1 51 Preparing Windows to use Supported Languages 5-2

511 Windows 20005-2 512 Windows XP5-2

52 Preparing PDMS to use Latin Languages 5-3 53 Preparing PDMS to use Far Eastern Languages 5-3

6 Running PDMS under Windows 6-1 61 Spaces in Windows pathnames 6-1

VANTAGE PDMS Installation Guide contents-iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 654

Contents

62 Linking to Microsoft Excel 6-1 63 Windows Parameters 6-2

7 PDMS Projects 7-1 71 The Sample Project 7-1

711 Copying Project SAM to Your User Area 7-1 712 Users and Teams in the Sample Project 7-2 713 MDBs in the Sample Project 7-3

72 Creating PDMS Projects 7-3 721 The Sample Project and your own Projects 7-4

8 Installing AutoDRAFT 8-1 81 Compatibility 8-1 82 The AutoDRAFT Software 8-1 83 Configuring AutoDRAFT with AutoCAD 8-2 84 Installing and configuring AutoCAD 8-2

841 AutoCAD R2002 8-3 842 AutoCAD R2004 8-3

85 Getting Started with AutoCAD 8-3 86 Application Macros for use with PDMS DRAFT 8-4

9 Upgrading Projects to Version 116SP1 9-1 10 Troubleshooting10-1

101 General10-1 102 License Manager Errors10-1 103 Entering PDMS 10-2 104 Problems with Graphics 10-3

11 Structure of PDMS on NET11-1 111 Overview 11-1 112 PDMSEXE11-1 113 GUI module structure 11-1

1131 Wrappers 11-2 1132 NET Loading rules11-2 1133 Win32 DLLs 11-3

114 Components 11-3 1141 PDMSEXE directory 11-3 1142 PDMSEXEDesign subdirectory11-5 1143 PDMSEXEDraft subdirectory 11-5

contents-ii VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 754

Contents

1144 PDMSEXEMonitor subdirectory 11-5 1145 PDMSEXEIsodraft subdirectory 11-5 1146

PDMSEXEAdmin subdirectory 11-5

1147 Add-ins 11-5

115 Forms and Menus 11-5 12 Troubleshoot ing the NET installation 12-1

121 Version Error 12-1 122 Wrappers or a dependency missing 12-1 123 Interface incompatibility 12-2 124 Security error with thin client 12-2 125

No Add-ins12-4

126 Window Layout 12-4 127 Serialization 12-4

VANTAGE PDMS Installation Guide contents-ii iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 554

Contents

1 Introduct ion 1-1 11 Contents of this Guide 1-1 12 Associated products 1-2

2 Hardware and Software Requirements 2-1 21 Hardware 2-1

211 Graphics Cards 2-1 22 Software and Configuration 2-2

3 Installing PDMS 3-1 31 Basic Installation 3-1

311 NET Framework Installation 3-2 32 Uninstalling and Reinstalling 3-2 33 FLEXMAN License Manager 3-2 34 Remote Installation 3-3

4 Setting Up the Windows Environment 4-1 41 Windows Control Panel 4-1 42 Graphics Card Settings 4-2 43 Setting the License File Location 4-2 44 PDMS Environment Variables 4-3 45 Running PDMS from a Command Prompt Window 4-5 46 Customising PDMS Start-Up 4-5 47 Running PDMS in batch4-7 48 Plotting 4-7

5 Language Support 5-1 51 Preparing Windows to use Supported Languages 5-2

511 Windows 20005-2 512 Windows XP5-2

52 Preparing PDMS to use Latin Languages 5-3 53 Preparing PDMS to use Far Eastern Languages 5-3

6 Running PDMS under Windows 6-1 61 Spaces in Windows pathnames 6-1

VANTAGE PDMS Installation Guide contents-iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 654

Contents

62 Linking to Microsoft Excel 6-1 63 Windows Parameters 6-2

7 PDMS Projects 7-1 71 The Sample Project 7-1

711 Copying Project SAM to Your User Area 7-1 712 Users and Teams in the Sample Project 7-2 713 MDBs in the Sample Project 7-3

72 Creating PDMS Projects 7-3 721 The Sample Project and your own Projects 7-4

8 Installing AutoDRAFT 8-1 81 Compatibility 8-1 82 The AutoDRAFT Software 8-1 83 Configuring AutoDRAFT with AutoCAD 8-2 84 Installing and configuring AutoCAD 8-2

841 AutoCAD R2002 8-3 842 AutoCAD R2004 8-3

85 Getting Started with AutoCAD 8-3 86 Application Macros for use with PDMS DRAFT 8-4

9 Upgrading Projects to Version 116SP1 9-1 10 Troubleshooting10-1

101 General10-1 102 License Manager Errors10-1 103 Entering PDMS 10-2 104 Problems with Graphics 10-3

11 Structure of PDMS on NET11-1 111 Overview 11-1 112 PDMSEXE11-1 113 GUI module structure 11-1

1131 Wrappers 11-2 1132 NET Loading rules11-2 1133 Win32 DLLs 11-3

114 Components 11-3 1141 PDMSEXE directory 11-3 1142 PDMSEXEDesign subdirectory11-5 1143 PDMSEXEDraft subdirectory 11-5

contents-ii VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 754

Contents

1144 PDMSEXEMonitor subdirectory 11-5 1145 PDMSEXEIsodraft subdirectory 11-5 1146

PDMSEXEAdmin subdirectory 11-5

1147 Add-ins 11-5

115 Forms and Menus 11-5 12 Troubleshoot ing the NET installation 12-1

121 Version Error 12-1 122 Wrappers or a dependency missing 12-1 123 Interface incompatibility 12-2 124 Security error with thin client 12-2 125

No Add-ins12-4

126 Window Layout 12-4 127 Serialization 12-4

VANTAGE PDMS Installation Guide contents-ii iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 654

Contents

62 Linking to Microsoft Excel 6-1 63 Windows Parameters 6-2

7 PDMS Projects 7-1 71 The Sample Project 7-1

711 Copying Project SAM to Your User Area 7-1 712 Users and Teams in the Sample Project 7-2 713 MDBs in the Sample Project 7-3

72 Creating PDMS Projects 7-3 721 The Sample Project and your own Projects 7-4

8 Installing AutoDRAFT 8-1 81 Compatibility 8-1 82 The AutoDRAFT Software 8-1 83 Configuring AutoDRAFT with AutoCAD 8-2 84 Installing and configuring AutoCAD 8-2

841 AutoCAD R2002 8-3 842 AutoCAD R2004 8-3

85 Getting Started with AutoCAD 8-3 86 Application Macros for use with PDMS DRAFT 8-4

9 Upgrading Projects to Version 116SP1 9-1 10 Troubleshooting10-1

101 General10-1 102 License Manager Errors10-1 103 Entering PDMS 10-2 104 Problems with Graphics 10-3

11 Structure of PDMS on NET11-1 111 Overview 11-1 112 PDMSEXE11-1 113 GUI module structure 11-1

1131 Wrappers 11-2 1132 NET Loading rules11-2 1133 Win32 DLLs 11-3

114 Components 11-3 1141 PDMSEXE directory 11-3 1142 PDMSEXEDesign subdirectory11-5 1143 PDMSEXEDraft subdirectory 11-5

contents-ii VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 754

Contents

1144 PDMSEXEMonitor subdirectory 11-5 1145 PDMSEXEIsodraft subdirectory 11-5 1146

PDMSEXEAdmin subdirectory 11-5

1147 Add-ins 11-5

115 Forms and Menus 11-5 12 Troubleshoot ing the NET installation 12-1

121 Version Error 12-1 122 Wrappers or a dependency missing 12-1 123 Interface incompatibility 12-2 124 Security error with thin client 12-2 125

No Add-ins12-4

126 Window Layout 12-4 127 Serialization 12-4

VANTAGE PDMS Installation Guide contents-ii iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 754

Contents

1144 PDMSEXEMonitor subdirectory 11-5 1145 PDMSEXEIsodraft subdirectory 11-5 1146

PDMSEXEAdmin subdirectory 11-5

1147 Add-ins 11-5

115 Forms and Menus 11-5 12 Troubleshoot ing the NET installation 12-1

121 Version Error 12-1 122 Wrappers or a dependency missing 12-1 123 Interface incompatibility 12-2 124 Security error with thin client 12-2 125

No Add-ins12-4

126 Window Layout 12-4 127 Serialization 12-4

VANTAGE PDMS Installation Guide contents-ii iVersion 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 854

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 954

1 Introduction

This guide explains how to install and set up PDMS Version 116SP1 on

a workstation running the Microsoft Windows 2000 or Windows XP

operating system (hereafter referred to jointly as Windows) Local

Administrator rights are required to perform the installation

This guide assumes you are familiar with the concepts of folderfile

hierarchies for storing data on disks and with basic Windows

terminology and commands If you are not you may also need to refer toyour operating system documentation while you carry out the

installation

The guide also assumes that you have already gained access to the

PDMS installation files via a CD from the AVEVA Web site or by some

other route

11 Contents of this Guide

Hardware and software requirements are described in Chapter 2 For completely up-to-date information please see the AVEVA Website at

httpwwwavevacomproductssupportsupporthtmland refer to the

Customer Support Hardware pages The Web pages also give hints on

ways of setting up and running PDMS on different computers in order to

achieve the most efficient performance

Chapter 3 Installing PDMS describes how to install PDMS 116SP1

and license the software

Chapter 4 Setting Up the Windows Environment explains how to

configure the Windows operating system before you run PDMS

Chapter 5 Language Support describes how to set up the Windows

Environment to use PDMS with different Language options

Chapter 6 Running PDMS under Windows gives some advice on using

PDMS in a Windows environment

Chapter 7 PDMS Projects describes the sample project that is supplied

as part of PDMS and how to set up your own projects

Chapter 8 Installing AutoDRAFT describes how to install and configure

PDMS AutoDRAFT

VANTAGE PDMS Installation Guide 1-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1054

Introduction

Chapter 9 Upgrading Projects to Version 116SP1 describes how to

upgrade your projects from PDMS 116 PDMS 115 PDMS 115SP1 or

earlier releases for use with PDMS 116SP1Chapter 10 Troubleshooting describes solutions for some of the errors

that you could encounter when running PDMS

Chapter 11 Structure of PDMS on NET outlines the way in which

PDMS in installed and configured in a Microsoft NET environment

Chapter 12 Troubleshooting the NET installation describes solutions to

some of the NET related issues you might encounter

12 Associated products

There are various other VANTAGE products that may be used in

conjunction with PDMS You may wish to consider installing these at

the same time Those closely associated with PDMS include the

following VANTAGE Plant Design products

frac34 Router for automatic rule-based pipe routing within

PDMS

frac34 Global for synchronisation of PDMS projects between

world-wide sites

frac34 Model Management for change amp status control of engineering

objects (eg pipes welds hellip) from system

design through detailing and into deliverable

production

And new at PDMS 116

frac34 Final Designer AutoCAD editing of PDMS DRAFT drawings

including final detailing

For details of the installation of these lsquoadd-onrsquo products please refer to

the relevant installation guide If they are required it may be advisableto read these before installing PDMS

1-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1154

2 Hardware and Software Requirements

This section describes the hardware and software configurations that

PDMS requires to run under Windows

21 Hardware

The following list gives a minimum specification for your computer

bull Processor Intel IA-32 architecture eg Pentium

- at least 1 GHz

bull Memory 256 MB minimum

512 MB or more highly recommended

bull Graphics Card High performance card recommended

- see below

bull Display A resolution of at least 1024x768 (XGA) is

strongly recommended

bull Storage Approximately 670 MB- see AVEVA web-site for details

bull CD drive CD-ROM will be used for media distribution

bull Mouse 3-Button mouse required

Mouse with wheel strongly recommended

211 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics

Due to the continuously and rapidly changing list of hardware

accelerated OpenGL graphics cards commercially available an up-to-

date list of supported graphics cards cannot be included in this

document

However the AVEVA Web pages

httpwwwavevacomproductssupportsupporthtmlcontain a current

list of both tested and supported graphics cards in the Support section

Other graphics cards which fully support the OpenGL standard should

also work but AVEVA cannot offer assistance in configuring these You

may also find some problems for example when picking items in PDMS

VANTAGE PDMS Installation Guide 2-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1254

Hardware and Software Requirements

22 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 116SP1 to run

bull PDMS 116SP1 is fully supported under

frac34 Windows 2000 Professional with Service Pack 4

frac34 Windows XP Professional with Service Pack 11

Note that Windows 2000 and Windows XP Service Packs and Hot

Fixes from Microsoft are required for PDMS to run effectively

Please refer to the AVEVA Support web site or contact the AVEVA

Support team for details of the latest recommended Windows 2000

and Windows XP environment for PDMS

bull PDMS 116SP1 databases must be on an NTFS File System FATC

partitions are not supported

bull The license manager must have a drive called C available for

writing temporary information In the case of double boot machines

where D is the system disk for Windows XP2000 and C is used for

an earlier version of Windows the license manager will still work

since it does not require NTFS

bull PDMS 116SP1 requires Microsoftrsquos NET Framework it will beinstalled from the CD if necessary

bull Optionally you can have Microsoft Excel installed for outputting

reports

1PDMS 116 will run on Windows XP SP2 but requires changes to the default settings The Internet

Connection Firewall (ICF) should be turned off or configured to ensure access to the database serverIn addition Group Policy changes (which alter the registry) are required for VANTAGE Plant DesignGlobal to ensure that RPC requests do not require authentication Details are given in the Global

Installation Guide

2-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1354

3 Installing PDMS

31 Basic Installation

Local Administrator rights are normally required to install PDMS

1 To install PDMS from CD ndash Insert the CD into your CD-ROM drive

If you have AutoPlay enabled for the drive the installation starts

automatically Otherwise run Starthtm on the CD

If you are installing PDMS from the network ndash Click StartgtRun on

the Windows taskbar and type the path to the Starthtm file on

your network

2 Click on CD CONTENTS and select the product which you want to

install (in this case PDMS Version 116SP1) then click INSTALL

Click OK on any confirmation forms which appear

3 On the File Download form select Run this program from its current

location (IE 50) or Open (IE 55 or later) to install the program files

directly from their current location onto your hard disk Select Yes on the Security Warning query about an Authenticode signature

4 This starts the InstallShieldreg Wizard which will lead you through

the rest of the installation process

During the installation sequence follow the on-screen instructions as

they appear You will be given a choice between two levels of installation

bull Full installation Installs all available product components

(recommended for a new installation unless there are good reasons

for restricting the options available to end users)

bull Custom installation Presents you with a list of all available product

components 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 use

embedded spaces in folder path names

The process needs at least 670MB of free disk space for a full installation

of all options InstallShield checks that there is enough space available

before it starts and warns you if there is not

VANTAGE PDMS Installation Guide 3-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1454

Installing PDMS

When the process is complete select StartgtProgramsAVEVAVANTAGE

PDMS 116SP1 to reach the Run PDMS Make PDMS project Run

Background Process Manager and PDMS manuals options

311 NET Framework Installation

The new graphical user interface included in PDMS 116SP1 requires

that Microsoftrsquos NET Framework 11 be installed The NET Framework

is supplied on the installation CD and is installed automatically if it is

not already installed

32 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation it will display the

options for modifyingrepairingremoving the files rather than simply

offering the standard installation options

To remove installed components from your hard disk or to add additional

components to an existing installation select StartgtSettingsgtControl Panel

and use the AddRemove Programs tool

As an alternative procedure repeat Steps 1 to 4 of the installation

sequence detailed above The InstallShieldreg Wizard will detect yourexisting installation and will give you the following options

bull Modify Displays the same list of options as the Custom installation

Select new components to be added andor deselect any currently

installed components to be removed

bull Repair Reinstalls all currently installed components (to correct any

corrupted files etc)

bull Remove Removes all currently installed components

NOTE

Uninstalling PDMS will not uninstall Microsoftrsquos NET Framework

this must be removed separately if required

33 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMS

can be used This will usually be done only on the server Please see the

FLEXMAN Installation Guide News and update information is also

available for FLEXMAN on the AVEVA support web-site

3-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1554

Installing PDMS

34 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations you must ensure that the Windows system DLLs on each

remote workstation are upgraded to a suitable version for running the

PDMS 116SP1 application programs You can achieve this by installing

PDMS 116SP1 itself in minimal form that is select the Custom

Installation type and then deselect everything except PDMS Core

Components

In addition this release includes a stand-alone Thin Client installer

which can be used on individual workstations to update the necessary

Windows system DLLs and which also provides start menu shortcuts to

the main PDMS installation

The Thin Client installer is a self-extracting InstallShieldreg executable

which is held in the CAVEVAPDMS116SP1thin_client_installer

subfolder It is applicable when the main PDMS 116SP1 product is

installed either from the Full Installation option or the Custom

Installation option with the Thin Client Installer component selected

VANTAGE PDMS Installation Guide 3-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1654

Installing PDMS

3-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1754

4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating system

before you run PDMS Following installation of PDMS you should

perform the following steps

bull Check the settings for your graphics board See Section 42

bull Ensure the FLEXMAN License Manager daemon is running and

set environment variables relating to FLEXMAN See Section 43

bull Configure Windows parameters for PDMS see Section 44

bull 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 116SP1

has been installed in folder CAVEVA If it has been installed

elsewhere substitute CAVEVA with the name of the installation

folder

41 Windows Control Panel

The Windows Control Panel contains tools that are used to change the

way Windows looks and behaves This Install Guide describes how to use

Control 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 XP

If 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 Start

and then click Control Panel

VANTAGE PDMS Installation Guide 4-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1854

Setting Up the Windows Environment

42 Graphics Card Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 167 million colours

This can be set by opening the Control Panel Select Display and select the

Settings tab Make the appropriate selections on the form for your

graphics card

Due to the rapidly changing list of hardware accelerated OpenGL

graphics cards commercially available an up-to-date list of supported

graphics cards graphics device drivers and recommended device driver

configuration cannot be included in this document However the AVEVA

Support Web pages (httpwwwavevacomengineeringit) contain acurrent list of both tested and supported graphics cards along with

advice on configuration of graphics device drivers

43 Setting the License File Location

Before you can use PDMS you must set up the FLEXMAN license

system and connect to the FLEXMAN License Manager daemon (see the

FLEXMAN 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 the

environment variable LM_LICENSE_FILE did this However this

applied to all software using FLEXlm You can now set

CADCENTRE_LICENSE_FILE instead that applies only to software

using 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 Windows

Registry This Registry setting will initially come from the value of the

corresponding environment variable but cannot then be modified by

changing the environment variable ndash you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the license

path These utilities are installed with FLEXMAN

The environment variable can be set in one of three ways either in the

PDMS entry script as a User Environment Variable in the Control Panel

or manually in a command window

To set manually or in the PDMS entry script type the following in a

command window or in the entry script before starting PDMS

set CADCENTRE_LI CENSE_FI LE=Por t Comput er name

4-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 1954

Setting Up the Windows Environment

To set automatically

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA

(PortComputername) For example

CADCENTRE_LI CENSE_FI LE744licserv

To confirm the licence environment variable setting open a commandwindow and type the command SET You should see a list of

environment variables including

CADCENTRE_LI CENSE_FI LE=Por t Comput er name

To check the Registry setting you will need to use the FLEXMAN utility

l mpath ndashst atus

You should see an output including the following

l mpat h - Copyri ght ( C) 1989- 2002 Gl obet r ott er Sof t war e I nc

Known Vendor s

cadcent r e 744l i cserv

hellip

44 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containing

PDMS system files and users project data This allows you to locate these

folders anywhere on the file system The default location for PDMS

system files is CAVEVAPDMS116SP1 but the location of the

pdms116SP1 folder can be changed if desired when PDMS is installed

PDMS is supplied with a file evarsbat in the PDMS executables folder

(CAVEVApdms116SP1) which sets default values for the environment

variables so that they point to the folder structure as installed It also

sets the PATH variable to include the PDMSEXE folder containing PDMS

executables

You may need to modify this file to reflect the folder structure of your

own installation The following is a list of the variables you may need to

reset with a brief description of each one and the default setting

VANTAGE PDMS Installation Guide 4-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2054

Setting Up the Windows Environment

Note that all environment variables must be UPPERCASE

It is recommended that users should not write to the pdms116SP1

installation folder or any of its contents

PDMS System Environment Variables

The following environment variables refer to the location of PDMS

system files

PDMSEXE Executable folderC AVEVA pdms11 6 SP1

PDMSEXEMAI N Copy of PDMSEXE but can be a search pathC AVEVA pdms11 6 SP1

CADCENTRE_LI CENSE_FI LE License fileNote that this variable relates to AVEVArsquos former name

for historical reasons

See section 43 Setting the License File Location

PDMSUI Application User Interface folder (PML 1)C AVEVApdms11 6 SP1 pdmsui

PMLLI B Application User Interface folder (PML 2)C AVEVApdms11 6 SP1 pml l i b

PDMSDFLTS Applications defaults folderC AVEVApdms11 6 SP1 pdmsui df l t s

PDMSPLOTS Applications PLOTS folderC AVEVA pdms11 6 SP1 pdmsui pl ot s

PLOTCADC Pointer to the PLOT executableC AVEVApdms11 6 SP1 pl ot pl ot exe

PDMSHELPDI R Online help data filesC AVEVA pdms11 6 SP1 onl i nehel p

PDMS User Envi ronment Variables

The following environment variables refer to the location of users PDMS

folders Users must have write permission to these foldersPDMSWK Temporary PDMS work file folder

C t emp

PDMSUSER Application Users saverestore setup area (or the users

home folder) C AVEVApdms11 6 SP1 pdmsuser

PDMSREPDI R PDMS Applicationware Report Input and Output folderC AVEVApdms11 6 SP1 pdmsui r epor t s

PDMSDFLTS Applications defaults folder Note that individual users

may not have permission to change PDMS System

defaults in C AVEVApdms11 6 SP1 pdmsui df l t s

4-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2154

Setting Up the Windows Environment

but they should have their own local defaults area This is

achieved by setting a PDMSDFLTS search path eglsquo C USERDFLTS C AVEVApdms11 6 SP1 pdmsui df l t srsquo

Project Environment Variables

For each PDMS project four more environment variables must be set

For example for a project ABC

ABC000 Project database folder

ABCI SO Project ISODRAFT options folder

ABCMAC Project Inter-DB connection macro folder

ABCPI C Project DRAFT picture file folder

PDMS is installed with sample project data (See Chapter 7 PDMSProjects) PDMS Project Environment variables for these projects are set

in evarsbat

45 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than using

the StartPrograms menu To do this you must set your PATH variable

to include the folder where PDMS is installed

Windows 2000 and Windows XP

bull Open the Control Panel

bull Select System and pick the Advanced tab

bull Click on the Environment Variables button

bull Edit the system variable Path to add the PDMS folder (for example

CAVEVA pdms116SP1) to the list of folders in the Path

variable

Once the Path variable includes the pdms116SP1 folder you can run

PDMS by typing pdms at a command prompt

46 Customising PDMS Start-Up

There is a batch (bat) file supplied in C AVEVApdms11 6 SP1 called

pdmsbat which allows entry into PDMS

You can run PDMS using this batch file in any of the following ways

bull Use the shortcut in the Windows Start menu

StartgtProgramsgtAVEVAgtVANTAGE PDMS 116SP1gtRun PDMS

VANTAGE PDMS Installation Guide 4-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2254

Setting Up the Windows Environment

bull You can create a shortcut on your desktop to run your batch file

With the cursor in the desktop area click with the right-hand

button and select NewgtShortcut This shows a sequence of dialogs tohelp you create the shortcut Type in the location of pdmsbat for

exampleC AVEVApdms11 6 SP1 pdms bat

then press Next and give the shortcut a name

Press Finish

You should now be able to double-click on the shortcut icon to enter

PDMS

bull If you have C AVEVApdms11 6 SP1( the path name for the

pdmsbat file) in your PATH environment variable just type pdms

in a command window to execute the batch filebull Otherwise navigate to the folder where the batch file is stored and

type pdms or pdmsbat

You can set up your own batch files to run PDMS For example you may

wish to run design checking utilities every night or update batches of

drawings overnight

Begin by creating a batch file for example runpdmsmacrobat

Type the following line into this file

C AVEVA pdms11 6 SP1 pdms bat TTY SAM SYSTEM XXXXXX STRUC

$M mymacr of i l e

Where

bull TTY tells PDMS not to start the PDMS GUI This gives command line

only operation

bull SAM is the project name

bull SYSTEMXXXXXX is the PDMS usernamepassword to be used

when running the command macro

bull STRUC selects the required MDB

bull mymacrofile is the pathname of a PDMS command macro containing

the commands that you want to execute in PDMS

In this example running runpdmsmacrobat will enter PDMS in project

SAM as user SYSTEMXXXXXX in MDB STRUC and run the PDMS

command macro mymacrofile

4-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2354

Setting Up the Windows Environment

47 Running PDMS in batch

PDMS creates a separate PDMSConsole process to manage thecommand-line inputoutput for all modules When PDMS is invoked

from a bat file processing of this file resumes as soon as you leave

Monitor ndash even though you are still using PDMS

To help manage this situation PDMSWaitexe is distributed as part of

PDMS and can be used to make a PDMS script wait for PDMS to

complete before continuing

PDMSWait uses Windows facilities to wait for an event triggered by

PDMSConsole when PDMS finishes Because you can be running more

than one PDMS session on any one computer both PDMSWait andPDMSConsole look for an environment variable

PDMS_CONSOLE_ I DENTI FI ER before doing this You can set

PDMS_CONSOLE_ I DENTI FI ER to any unique string In a bat file you can

use the RANDOMor TI MEvalues provided by Windows in a Perl script

you can use the process number accessible as $$

Example

echo St ar t PDMS at TI ME

set PDMS_CONSOLE_I DENTI FI ER=RANDOM

cal l PDMSEXE pdms

cal l PDMSEXE pdmswai t

echo Returned t o bat at TI ME

This will start PDMS then wait until it has finished before resuming the

script

The VANTAGE PDMS MONITOR Reference Manual provides more

details on running PDMS batch programs

48 Plotting

To plot in a Windows environment we recommend that you use the

plotcadcbat file supplied in the pdms116SP1 folder Note that you may

have to modify the plotcadcbat file to suit your local printer installation

The Network Plotter must be mapped using the NET USE command See

your network documentation for more information

To run the plotcadcbat file give a command in the format

C AVEVApdms11 6 SP1 pl otcadc bat plotfile format printer

options

VANTAGE PDMS Installation Guide 4-7Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2454

Setting Up the Windows Environment

Where options are the AVEVA PLOT utility options and may be omitted

See the PLOT User Guide for more information Note that the options

must be enclosed in quotesFor example

pl ot cadc bat c pdms pl ot 1 ps nt ser ver NTPost Scr i pt

pl ot cadc bat c pdms pl ot 1 hpgl nt ser ver NThpgl CE=Y

4-8 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2554

5 Language Support

By default your PDMS project can use any language whose characters

are contained within the Latin-1 character set The Languages covered

by the Latin-1 character set a listed in the table below If you want to use

any of the other non-Latin-1 languages supported by PDMS it is

necessary to configure your PDMS project and the Windows operating

system This chapter describes how to use PDMS on Windows 2000 and

Windows XP Professional in each of the supported language groups

bull Latin-1

bull Latin-2

bull Latin-Cyrillic

bull 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 LatinCyrillicalphabet

Bulgarian ByelorussianEnglish Macedonian Serbo-

Croatian Ukrainian Russian

Far Eastern J apanese Korean Simplified

Chinese Traditional Chinese

PDMS does not support any other language character set nor does it

support the mixing of any of the above except for mixing one Far

Eastern language with English

VANTAGE PDMS Installation Guide 5-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2654

Language Support

51 Preparing Windows to use Supported Languages

511 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 Properties5 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 The

system will either prompt for a Windows 2000 CD-ROM or access

the system files across the network Once the language is

installed Windows 2000 will prompt you to restart the computer

512 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 ldquoStandards and formatsrdquo

select the required language from the list

4 Click the Languages tab and then click Details under Text

services and input languages

5 Under ldquoDefault input languagerdquo 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 Installed

Services and then click the language you want to add and the

keyboard layout you want to use for that language

To configure the settings for the Language bar click Language

Bar under Preferences The Language bar is used to switch

between languages while you are using PDMS Click OK to close

the Language Bar Settings dialog

Click OK to close the ldquoText Services and Input Languagesrdquo dialog

5-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2754

Language Support

6 Click the Advanced tab Under rdquoLanguages for non-Unicode

programsrdquo select the required language Click Apply It may be

necessary to install new code page conversion tables Only memberof the Administrators group can install code page conversion

tables The system will either prompt for a Windows XP CD-ROM

or access the system files across the network Once the language is

installed Windows XP will prompt you to restart the computer

Note For Far Eastern language support it is necessary have the East

Asian support option installed

52 Preparing PDMS to use Latin Languages

In PDMS ADMIN you must specify a character set for each project by

using one of the following commands on the PDMS ADMIN command

line

Command Languages covered

PROJ ECT CHARSET LATIN 1

(default)

Danish Dutch English Faroese

Finnish French German Icelandic

Irish Italian Norwegian Portuguese

Spanish Swedish

PROJ ECT CHARSET LATIN 2 Albanian Czech English German

Hungarian Polish Rumanian Serbo-

Croat Slovak Slovene

PROJ ECT CHARSET LATIN CYRILLIC Bulgarian Byelorussian English

Macedonian Serbo-Croatian

Ukrainian Russian

The corresponding font family must be selected for Draft and Isodraft

drawings Use ProjectgtFont Families and select the Font Type appropriate

for you chosen language

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

53 Preparing PDMS to use Far Eastern Languages

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

require

VANTAGE PDMS Installation Guide 5-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2854

Language Support

Before you use PDMS you must set the environment variable

CADC_LANG as follows

CADC_LANG=Japanese Kanji

CADC_LANG=Korean

CADC_LANG=Chinese Simplified Chinese

CADC_LANG= TChinese Traditional Chinese

In PDMS ADMIN you must specify the multibyte character set for each

project by using the command corresponding to your required language

PROJECT MBCHARSET JAP

PROJECT MBCHARSET KOR FILE lt font filenamegt

PROJECT MBCHARSET CHI Simplified Chinese

PROJECT MBCHARSET TCHIN FILE lt font filenamegt

Traditional Chinese

For details see the VANTAGE PDMS ADMIN User Guide and

VANTAGE PDMS ADMIN Command Reference Manual

5-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 2954

6 Running PDMS under Windows

61 Spaces in Windows pathnames

To run macros with spaces in the filenames you must enclose the

filename in quotes without a leading slash For example

$m c Pr ogr am Fi l es Macr os space mac ar g1 ar g2

Due to the way in which PDMS parses its command lines this format is

also recommended for use with filenames containing Asian characters

62 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excel

spreadsheet as comma-separated files

bull Select UtilitiesgtReportsgtModify from the PDMS main menu bar

bull Pick a report template

bull Click on OK the Modify Template form is displayed

bull Select OptionsgtOther Formats from the Modify Template form menu

bar This displays the Report Format form From this form

bull Choose the CSV option from the Format drop-down list

bull Click on OK this returns you to the Modify Template form

bull Select the Overwrite radio button

bull

For the filename enter PDMSUSER f name csv (the csv extension is important)

bull In the System command text box enter

cmdc ldquoCltexcel foldergtexcelexerdquo PDMSUSERfnamecsv where C ltexcel foldergt is the location of Excel on your system

Note that it is necessary to enclose Windows command arguments

in double quotation marks if the argument contains embedded

spaces ltexcel foldergt

VANTAGE PDMS Installation Guide 6-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3054

Running PDMS under Windows

63 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS These are optional Windows Parameter

settings

Windows 2000

Open the Control Panel Select Display and select the Effects tab On the

form uncheck Show Window Contents While Dragging

Windows XP

Open the Control Panel Select Display then select the Appearance tab and

click on the Effectshellip button On the form uncheck Show Window ContentsWhile Dragging and Show shadows under menus

6-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3154

7 PDMS Projects

71 The Sample Project

PDMS is supplied with a sample project which can be used in several

ways

bull It provides you with examples of the use of PDMS

bull

It provides you with sample libraries catalogues and specificationswhich enable you to use PDMS before you set up your own and can

be used as starting points when you do start to create your own

bull It provides you with starting points for the tutorials in the following

manuals

Pipework Design Using PDMS

Pipework Spooling Using PDMS

Structural Design Using PDMS

Industrial Building Design Using PDMS

Support Design Using PDMS

HVAC Design Using PDMS

Reporting from PDMS

Drawing Production Using PDMS

bull It provides an example of how to set up your own projects

The sample project is actually two projects in PDMS terms

bull 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

bull SAM (Sample) contains several MDBs which can be modified and

so they can be used for training

711 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS You

should copy the sample project to your user area and run it as supplied

VANTAGE PDMS Installation Guide 7-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3254

PDMS Projects

The project files are held in two directories sam000 holds all design

data and catalogue data sampic holds the DRAFT picture libraries

712 Users and Teams in the Sample Project

Free User

The Free user has usernamepassword SYSTEMXXXXXX

General Users

Team Usernamepassword

CATS CATSCATS

DEMO DEMODEMOEQUI EQUIEQUIHANGER HANGERHANGERHVAC HVACHVACPIPE PIPEPIPESAMPLE SAMPLESAMPLESTRUC STRUCSTRUCUSERA USERAAUSERB USERBBUSERC USERCCUSERD USERDDUSERE USEREEUSERF USERFFUSERG USERGG

General User with Adminis tration Rights

There is a user named ADMIN who is a member of all teams except

MASTER In particular ADMIN is a member of the following teams

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights within

the corresponding constructor module

Each MDB contains databases with appropriate access rights There are

also teams and users associated with each MDB with appropriate access

rights

7-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3354

PDMS Projects

713 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases

The sample project contains the following MDBs which can be used for

demonstration or training purposes

CATS An MDB for practising using Catalogues and

Specifications

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 a

starting point

HVAC An MDB for the HVAC Design tutorial This MDB

contains suitable steelwork and civils as a starting

point

MASTER An MDB containing the master Catalogues and

Specifications Lexicon Dictionaries etc

MASTERCAT An MDB used for practising the use of Catalogues and

Specifications

PIPE An MDB for the Pipework Design and Pipework

Spooling tutorials

SAMPLE An MDB for the Reporting from PDMS and Drawing

Production tutorials This MDB contains design data

from which reports and drawings can be produced You

can also produce isometrics

STRUC An MDB for the Structural Design tutorial

TRAINA to

TRAING Additional MDBs available for training purposes

72 Creating PDMS Projects

For full information on setting up your own projects see the VANTAGE

PDMS ADMIN User Guide

You will need to create project folders for each project for example for a

project xyz

VANTAGE PDMS Installation Guide 7-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3454

PDMS Projects

md xyz000md xyzpi cmd xyzi somd xyzmac

Set the corresponding environment variables that point to these

directories You can do this by setting Environment Variables using the

Control Panel or by modifying the evarsbat file used to configure

your PDMS Windows installation (see Chapter 4 Setting Up the

Windows Environment for further details) Alternatively type the

following in an MS-DOS window

set XYZ000= pathnamexyz000

set XYZPI C= pathnamexyzpi c

set XYZI SO= pathnamexyzi soset XYZMAC= pathnamexyzmac

Note Users converting from UNIX should note that there is no direct

equivalent of the cshr c file in which these variables can be set

Use the Make PDMS project icon supplied to start the PDMS Make

program then enter

XYZ$m PDMSEXE makemac macFI NI SH

Note Users converting from UNIX should note that the makemac mac

file is the same as on UNIX The executable for each module is

also named identically to that on UNIX eg DESIGN runs

PDMSEXE des The extension exe needed by Windows is

added automatically

721 The Sample Project and your own Projects

You can add databases from the sample projects SAM and MAS to your

own projects from within PDMS ADMIN using the Install options on the

main 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 before

you can enter the module You may find it convenient to install the

libraries supplied by AVEVA in the MAS project (using the Install

options) even if you wish to create your own libraries for the project

7-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3554

8 Installing AutoDRAFT

This chapter explains the steps needed to install and configure

AutoDRAFT

AutoDRAFT may be run in stand-alone mode or it may be run from

PDMS DRAFT or ISODRAFT You can use the adraftde adraftbe and

adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User

Guide The DRAFT and ISODRAFT applicationware generates interface

files for AutoCAD which are then used by the scripts AutoDRAFT generates interface files for DRAFT which can be imported

using the DRAFT applicationware

81 Compatibility

The version of AutoDRAFT released with PDMS 116SP1 is compatible

with AutoCAD Releases 2002 and 2004

82 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that run

with AutoCAD Releases 2002 and 2004 and PDMS application macros to

link these AutoDRAFT applications with PDMS DRAFT and ISODRAFT

The three AutoCAD applications are

bull AutoDRAFT Drawing Editor

bull AutoDRAFT Frame Editor

bull AutoDRAFT Symbol Editor

The Drawing Editor is used to modify drawings transferred from DRAFT

or ISODRAFT Please note that the new Final Designer product provides

much closer integration between DRAFT and AutoCAD

The Frame Editor is used to transfer AutoCAD drawings into backing

sheets or overlay sheets in DRAFT

The Symbol Editor is used to convert AutoCAD graphics into symbol

templates within DRAFT symbol libraries

VANTAGE PDMS Installation Guide 8-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3654

Installing AutoDRAFT

83 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 116SP1 software is installed under the PDMSexecutables folder

autodraftACAD

pdms116

autodraftfonts autodraftACADsource

bull The autodraftACAD folder contains bat files AutoDRAFT scripts

AutoLISP programs binary DRAFT menu files and an AutoCAD

linestyle file

bull The autodraftfonts folder contains AutoCAD font files All of these

are needed to run AutoDRAFT programs in AutoCAD

bull In addition to the AutoDRAFT binary menu files text versions are

also provided These are supplied in the autodraftACADsource folder

for referencecustomisation This folder should not be visible by

AutoCAD

Note The AutoDRAFT software will operate properly only if AutoCAD

can be run using the acad command AutoDRAFT may not work if

the AutoCAD executable acad has been renamed or if the acad

command runs a user-supplied file which itself runs AutoCAD

84 Installing and configuring AutoCAD

In order to use AutoDRAFT AutoCAD must be installed and configured

for each computer where AutoDRAFT will be used The AutoCAD

Installation and Performance Guide supplied with AutoCAD describes

how to do this

AutoCAD should be configured to locate the extra menus and fonts used

in AutoDRAFT the method depends on the AutoCAD version typically

bull Add the appropriate paths to the autodraftACADautodraftACADsource and autodraftfonts directories to the

gtToolsgtOptionsgtSupport File Search Path field

The AutoDRAFT environment variable setting commands applicable to

each release of AutoCAD are listed in the following sections The

environment variables are set within the supplied pdmsbat file These

should be edited to suit the installed version of AutoCAD

8-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3754

Installing AutoDRAFT

841 AutoCAD R2002

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

eg CProgram FilesAcad2002CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACAD

set path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2002 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directoryLocation of autodraftfonts directory

842 AutoCAD R2004

set PDMS_ACAD=2004

set PDMS_ACAD_PATH= pathname for AutoCAD R2004 files

eg CProgram FilesAcad2004CProgram FilesCommon

FilesAutodesk Shared

set ACAD_VERSION=PDMS_ACADset path=location of autodraftACAD directoryPDMS_ACAD_PATH

path

Before running AutoDRAFT you need to run AutoCAD R2004 and add

the following as file paths

Location of autodraftACAD directory

Location of autodraftACADsource directory

Location of autodraftfonts directory

85 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has been

correctly installed and configured by entering the command acad at the

operating system command prompt

VANTAGE PDMS Installation Guide 8-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3854

Installing AutoDRAFT

86 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 and

ISODRAFT

8-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 3954

9 Upgrading Projects to Version 116SP1

It is necessary to upgrade your PDMS projects by using the appropriate

upgrade procedure The procedure supplied with PDMS 116SP1 will

work with all releases from PDMS 112 onwards If you are upgrading

from an earlier version of PDMS it is necessary to upgrade from each

PDMS version to the next by using the upgrade procedure supplied with

the appropriate version of PDMS

For example to upgrade a project from PDMS 105 to PDMS 116SP1 itis necessary first to load the PDMS 112 product and use its upgrade

procedure to create a PDMS 112 version of your project before using the

upgrade scripts supplied with 116SP1

No database upgrade is necessary for PDMS 114 or 115 projects The

only action of the upgrade in this case is to remove the virdat files from

the project ndash if you say yes to the prompt These files are now stored in

PDMSEXE to simplify the upgrade process the change was made at

PDMS 114sp1

VANTAGE PDMS Installation Guide 9-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4054

Upgrading Projects to Version 116SP1

9-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4154

10 Troubleshooting

Here are some suggestions about solving some problems you may

encounter when using PDMS under Windows

101 General

Error The dynamic link library DFORMDdll could not be found in the

specified path

Explanation This is supplied with PDMS Perhaps you have not set your PATH

variable The PATH setting must include lsquoCAVEVA pdms116SP1rsquo

Error STOP The application failed to initialise properly (0xc0000135) Click

on OK to terminate the application

Explanation This occurs after a number of other errors The most likely reason is a

problem with the PATH variable

102 License Manager Errors

Error When you start up lmgrd it says lttimegt (lmgrd) Cant make folder

CFLEXlm errno 2 No such file or folder etc

Solution There is no C drive for the license manager to write to As the System

Administrator or a Power User you need to make a shared disk called

C This can be done on a networked or non-networked computer

Within the Windows Explorerrsquos File menu create a new folder (eg

D C_dr i ve) and make it current Select FilegtProperties and select

the Share tab Click on the Shared As radio button and then click OK

Then from the Tools menu select Map Network Drive Select C from

the Drive drop-down list in the displayed form and type

hostnameC_drive

in the Path box Then click on OK (C) should now appear in the list of

available drives in Explorer

Error lttimegt (lmgrd) lthostgt 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 The

hostname comes from the variable COMPUTERNAME which you can

VANTAGE PDMS Installation Guide 10-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4254

Troubleshooting

obtain by typing env| f i ndst r COMPUTERNAME in a Command

Prompt window Compare this with the license file contents and

resubmit if necessary

Pop-up Mess FLEXlm checkout failed Cannot connect to license server (-15

1010061) WinSock error code

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

Pop-up Mess FlexLM checkout failed Cannot find license file (-1732) No such file

or folder

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

Pop-up Mess FlexLM checkout failed Licensed number of users already reached

(-4132)

Explanation You have exceeded the permitted number of users specified in your

license file

103 Entering PDMS

Error (439) Environment Variable not defined for project name

Explanation You have not set the environment variable for the project eg XYZ000

Error (431) Project ltxxxgt not available

Error 7 allocating system database

Explanation The environment variable for the project does not point to the correct

location Either the disk andor folder do not exist or are not readable

Error ltusernamegt not found

or

Bad password

Explanation You are trying to enter PDMS without a valid PDMS username andor

password

Error PDMSWK environment variable not set

Solution Set PDMSWK to ctemp 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

10-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4354

Troubleshooting

Error Project ltxxxgt is pre version 8

Explanation This can happen if you have transferred the project from UNIX using

FTP in ASCII rather than Binary format

104 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 display

driver 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

lsquoTrue Colourrsquo or 167 million colours

Error Graphics speed (for example in 3D views) is poor

Solution Check the setting of your Display

VANTAGE PDMS Installation Guide 10-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4454

Troubleshooting

10-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4554

11 Structure of PDMS on NET

From PDMS 116SP1 the GUI uses the Microsoft NET environment including

the latest WinForms based user interface components Using this state-of-the-

art technology enables docking forms and toolbars in PDMS and provides a

robust foundation for the future provision of standard application programming

interfaces

This does affect the way PDMS is installed this section gives a brief overview

and the following one outlines how to troubleshoot the installation

111 Overview

This section describes the overall structure and components of the PDMS NET

installation and the environment necessary to run it Each PDMS GUI module

now consists of a thin NET exe a NET Wrapper DLL and a Win32 DLL plus

some other shared components including 3rd party controls from Infragistics

The NET components are private assemblies installed under the root directory

PDMSEXE

112 PDMSEXE

The environment variable PDMSEXE is used to locate the executable on

module switch It is also used to locate attlibdat (attribute and noun definitions)

messagedat (message definitions) desvirdat (schema definition) etc Normally

PDMS is started from pdmsbat which is located in your PATH Both

PDMSEXE and PATH should include the install directory

113 GUI module structure

Each GUI module is structured in the same way For Design the structure looks

like this

VANTAGE PDMS Installation Guide 11-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4654

Structure of PDMS on NET

desexe

Wrappersdll

desdll

where desexe and desdll live in the directory PDMSEXE and Wrappersdll

lives in the Design subdirectory below PDMSEXE So when running a PDMS

GUI module PDMSEXE is used to locate the executable NET loading rules

are used to load Wrappersdll and Win32 DLL loading rules are used to load

desdll (and other Win32 DLLs on which desdll depends)

1131 Wrappers

For each GUI module (Design Draft Admin Isodraft and Monitor) there is a

Wrappersdll in a subdirectory with the same name as the module Each

Wrapperdll has a dynamic link to the appropriate Win32 DLL for that module

NET loading rules are used to load the appropriate Wrappersdll for a givenmodule So when running desexe the version of Wrappersdll linked with

desdll will be loaded Design and Draft subdirectories also contain a

drawlistWrapper dll which is used by the Drawlist add-in

1132 NET Loading rules

All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applications configuration file calledltmodulegtexeconfig to see whether it contains any path hints Path hints are

stored in the ltprobinggt element So for example desexeconfig has the

following probing path ltprobing privatePath=Design gt This means that

Wrappersdll is loaded from the subdirectory Design below the application

directory

11-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4754

Structure of PDMS on NET

1133 Win32 DLLs

Each Wrappersdll depends on the given modulersquos Win32 DLL eg DesignrsquosWrappersdll found in the Design subdirectory depends on desdll Win32 DLL

loading rules apply here These are

bull The directory from which the importing component loaded (eg the

Design subdirectory where Wrappersdll is loaded)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything

here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll

then unless you are running from PDMSEXE your PATH will be used to

locate the module DLL (The Wrappersdll subdirectory is the directory which is

first searched for all the Win32 DLLrsquos on which Wrappers depends ie

ltmodulegtdll sglNetdll udDNetdll hellip)

114 Components

The following components will be installed under PDMSEXE or one of its

subdirectories This is not a complete list but a list of all NET related files for

GUI modules (Design Draft Isodraft Admin and Monitor) Each module has an

exe and corresponding dll eg desexe and desdll a config file a manifest file

and an Addins file The config file is used to specify the location of the Wrappers

dllrsquos for each application the manifest file is used to set the visual style of the

application and the Addins file defines which add-ins the application will load

(eg Explorer Drawlist hellip)

1141 PDMSEXE directory

DesignSpooler

desexe desdll desexeconfig desexemanifest DesignAddinsxml

SpoolerAddinsxml

Draft

draexe dradll draexeconfig draexemanifest DraftAddinsxml

VANTAGE PDMS Installation Guide 11-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4854

Structure of PDMS on NET

Monitor

monexe mondll monexeconfig monexemanifest

Isodraft

issexe issdll issexeconfig issexemanifest IsodraftAddinsxml

Admin

admexe admdll admexeconfig admexemanifest

Shared

Dependsdll DrawListdll DrawListAddindll ExplorerAddindllExplorerControldll ForeignLanguagedll HistoryAddIndll MyDataAddIndll

ReferenceListAddindll PDMSCommandsdll PDMSFiltersdll

PDMSResourcesdll PDMSResourcesresources StartUpdll

ApplicationFrameworkdll udNetdll DruidNetdll

Infragistics

This is a third-party GUI tool-kit

InfragisticsSharedv3dll InfragisticsWinUltraWinDockv3dll

InfragisticsWinUltraWinExplorerBarv3dll

InfragisticsWinUltraWinGridv3dll

InfragisticsWinUltraWinStatusBarv3dll

InfragisticsWinUltraWinTabbedMdiv3dll

InfragisticsWinUltraWinTabControlv3dll

InfragisticsWinUltraWinToolbarsv3dll InfragisticsWinUltraWinTreev3dll

InfragisticsWinv3dll InfragisticsWinMiscv3dll

System

msvcp71dll msvcr71dll

Other DLLs required by DRAFT

These DLLs are loaded as required by specific DRAFT commands

Draft_DXF_LIdll Draft_DGN_LIdll Draft_Test_LIdll Draft_SVG_LIdll

Other DLLs required by DESIGN

sgl5NETdll

11-4 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 4954

Structure of PDMS on NET

1142 PDMSEXEDesign subdirectory

drawlistWrappersdll Wrappersdll

1143 PDMSEXEDraft subdirectory

drawlistWrappersdll Wrappersdll

1144 PDMSEXEMonitor subdirectory

Wrappersdll

1145 PDMSEXEIsodraft subdirectory

drawlistWrappersdll Wrappersdll

1146 PDMSEXEAdmin subdirectory

Wrappersdll

1147 Add-ins

These new user interface NET components are loaded by the Application

Framework Each module has an addin file which defines the set of add-ins it

will load eg for Design this file is DesignAddinsxml The toolbar entries to

show and hide each add-in are defined in PML

115 Forms and Menus

Most of the User Interface is still defined in PML located in PMLLIB andPDMSUI

VANTAGE PDMS Installation Guide 11-5Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5054

11-6 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5154

12 Troubleshooting the NET installation

121 Version Error

Error SystemIOFileLoadException The located assemblys manifest

definition with name PDMSResources does not match the assembly reference

Solution All Net assemblies must be the same version Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whateverthe current version is

122 Wrappers or a dependency missing

Error An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in

monexe

Additional information File or assembly name Wrappers or one of its dependencies

was not found

Solution All the NET assemblies are Private assemblies and are installed under

PDMSEXE (Assembly Base directory) or a subdirectory below NET loads

private assemblies from the base directory of the application If it canrsquot find the

private assembly here it uses the applicationrsquos configuration file called

ltmodulegtexeconfig to see whether it contains any path hints Path hints are stored

in the ltprobinggt element So for example desexeconfig has the following probing

path ltprobing privatePath=Design gt This means that Wrappersdll is loaded

from the subdirectory Design below the application directory Each Wrappersdll

depends on the given modules Win32 DLL eg Designrsquos Wrappersdll found in the

Design subdirectory depends on desdll Win32 DLL loading rules apply here These

are

bull The directory from which the importing component loaded (ie the Design

subdirectory where Wrappersdll is loaded in the case of Design)

bull The (applications) current directory (where itrsquos run from)

bull The Windows directory (default CWindows) (we donrsquot install anything here)

bull The directories that are listed in the PATH environment variable

Since the module DLL does not live in the same directory as the Wrappersdll then

unless PDMS is running from PDMSEXE the PATH will be used to locate

VANTAGE PDMS Installation Guide 12-1Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5254

Troubleshooting the NET installation

the module DLL (The Wrappersdll subdirectory is effectively is the directory which

is first looked in for all the Win32 DLLrsquos which Wrappers depends on ie

ltmodulegtdll sglNetdll udDNetdll hellip)

Make sure that both PDMSEXE and PATH point to the root directory in

which PDMS is installed

123 Interface incompatibil ity

Error

An exception lsquoSystemMissingMethodExceptionrsquo has occurred in monexe

Or

An exception lsquoSystemIOFileNotFoundExceptionrsquo has occurred in monexe

Additional information A procedure imported by Wrappers could not be loaded

Solution The interfaces between components are not compatible Check

FilegtPropertiesgtVersion Assembly Version on all assemblies is 11610 or whatever

the current version is

124 Security error with thin client

Error An unhandled exception of type SystemIOFileLoadException occurred

in Unknown Module

Additional information Unverifiable assembly Wrappers failed policy check

Solution NET security gets in the way when running PDMS across the network

where the assemblies reside on a different machine to the NET runtime The

default security level for the local intranet is not set to Full Trust which means that

programs may not be able to access resources on the local machine To overcome

this the intranet security may be set to Full Trust However this means that anyNET assembly may run Alternatively Full Trust may be given to a specified group

of strongly named assemblies This is done using the code access security policy tool

caspol This should be run on each client machine to add all the assemblies on a

given server directory to a group and give Full Trust to this group

Use Administrative ToolsgtNet Configuration 11gtMy ComputergtRuntime Security

PolicygtMachinegtCode GroupsgtAll CodegtLocalIntranet_Zone to check the group

properties

If the security Policy has not been set this can be done by hand using

12-2 VANTAGE PDMS Installation Guide Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5354

Troubleshooting the NET installation

caspol -m -ag LocalIntranet_Zone -urlltServerNamegtltFolderNamegt FullTrust -n ltNamegt -d ltDescr ipt iongt

where ltServerNamegt is the UNC (Uniform Naming Convention) - the format of a

UNC path is ltservernamegtltsharenamegtltdirectorygt

Or

If you are not concerned about other NET remote assemblies running on your

machine this can be set for the entire intranet using

Control PanelgtAdministrative ToolsgtMicrosoft Net Framework 11

ConfigurationgtConfigure Code Access Security PolicygtAdjust Zone SecuritygtMake

changes to this computer

Then change Local Intranet to Full Trust

VANTAGE PDMS Installation Guide 12-3Version 116SP1

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project

7142019 PDMS Installation Guia

httpslidepdfcomreaderfullpdms-installation-guia 5454

Troubleshooting the NET installation

125 No Add-ins

Problem Add-ins missing from module

Solution

Add-ins loaded by each module are defined in the following xml files

DesignAddinsxml

DraftAddinsxml

IsodraftAddinsxml

SpoolerAddinsxml

If Add-ins are missing check that these files exist in PDMSEXE

126 Window Layout

Problem Window layout is not restored eg Add-ins position andor docked

state hellip

Solution The file ltmodulegtltversiongtWindowLayoutxml in the PDMSUSER

directory stores this information for the each GUI module If this file is deleted then

the window layout will return to its default

127 Serialization

Serialization is the process used to store the data ndash eg history stacks toolbar state

ndash for the GUI in a NET environment

Problem Information is stored per project and per module in the following files

in the PDMSUSER directory

ltprojectgtltversiongtSettingsbin

ltmodulegtltversiongtSettingsbin

Solution These files may be deleted or transferred between users working on thesame project