pdms installation guia
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