Professional Documents
Culture Documents
Disclaimer
Information of a technical nature, and particulars of the product and its use, is given by AVEVA Solutions Ltd and its subsidiaries without warranty. AVEVA Solutions Ltd and its subsidiaries disclaim any and all warranties and conditions, expressed or implied, to the fullest extent permitted by law. Neither the author nor AVEVA Solutions Ltd, or any of its subsidiaries, shall be liable to any person or entity for any actions, claims, loss or damage arising from the use or possession of any information, particulars, or errors in this publication, or any incorrect use of the product, whatsoever.
Copyright
Copyright and all other intellectual property rights in this manual and the associated software, and every part of it (including source code, object code, any data contained in it, the manual and any other documentation supplied with it) belongs to AVEVA Solutions Ltd or its subsidiaries. All other rights are reserved to AVEVA Solutions Ltd and its subsidiaries. The information contained in this document is commercially sensitive, and shall not be copied, reproduced, stored in a retrieval system, or transmitted without the prior written permission of AVEVA Solutions Ltd Where such permission is granted, it expressly requires that this Disclaimer and Copyright notice is prominently displayed at the beginning of every copy that is made. The manual and associated documentation may not be adapted, reproduced, or copied, in any material or electronic form, without the prior written permission of AVEVA Solutions Ltd. The user may also not reverse engineer, decompile, copy, or adapt the associated software. Neither the whole, nor part of the product described in this publication may be incorporated into any third-party software, product, machine, or system without the prior written permission of AVEVA Solutions Ltd, save as permitted by law. Any such unauthorised action is strictly prohibited, and may give rise to civil liabilities and criminal prosecution. The AVEVA products described in this guide are to be installed and operated strictly in accordance with the terms and conditions of the respective licence agreements, and in accordance with the relevant User Documentation. Unauthorised or unlicensed use of the product is strictly prohibited. First published September 2007 AVEVA Solutions Ltd, and its subsidiaries 2007 AVEVA Solutions Ltd, High Cross, Madingley Road, Cambridge, CB3 0HB, United Kingdom
Trademarks
AVEVA and Tribon are registered trademarks of AVEVA Solutions Ltd or its subsidiaries. Unauthorised use of the AVEVA or Tribon trademarks is strictly forbidden. AVEVA product names are trademarks or registered trademarks of AVEVA Solutions Ltd or its subsidiaries, registered in the UK, Europe and other countries (worldwide). The copyright, trade mark rights, or other intellectual property rights in any other product, its name or logo belongs to its respective owner.
Contents
Page
PDMS
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
Contents of this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1 Associated Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:2
Uninstalling and Reinstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2 Flexman License Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2 Remote Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2 Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2
Deployment across a network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deployment using SMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deployment using logon script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deployment using GPO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example of deploy.bat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:4 3:4 3:5 3:6 3:6
12.0
Graphics Card Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1 Setting the License File Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:2 PDMS Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:2 Running PDMS from a Command Prompt Window . . . . . . . . . . . . . . . . . . . . . . 4:4 Customising PDMS Start-Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:4
Creating Your Own Batch File to Run PDMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:5
Preparing PDMS to use Latin Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:2 Preparing PDMS to use Far Eastern Languages. . . . . . . . . . . . . . . . . . . . . . . . . 5:3
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:1
General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:1 License Manager Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:1 Entering PDMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:2 Problems with Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:3
ii
12.0
Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9:3
PDMSEXE Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PDMSEXE/DESIGN subdirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PDMSEXE/DRAFT subdirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PDMSEXE/MONITOR subdirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PDMSEXE/ISODRAFT subdirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PDMSEXE/ADMIN subdirectory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Add-ins .............................................................. 9:3 9:4 9:4 9:4 9:4 9:4 9:4
iii
12.0
iv
12.0
Introduction
This guide explains how to install and set up PDMS 12 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 folder/file hierarchies for storing data on disks and with basic Windows terminology and commands. If you are not, you may also need to refer to your 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/DVD, from the AVEVA Web site, or by some other route.
1.1
1:1
12.0
1.2
Associated Products
There are various AVEVA 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 DESIGN products: Global - for synchronisation of PDMS projects between world-wide sites Model Management - for change & status control of engineering objects (e.g. pipes, welds, ) from system DESIGN through detailing and into deliverable production
For details of the installation of these add-on products, please refer to the relevant installation guide. If they are required, it may be advisable to read these before installing PDMS.
1:2
12.0
2.1
First insert the disk in your Workstation DVD drive, and then follow the InstallShield instructions. If the disk does not start, click Start>Run, and then browse for the Setup.exe or Install.exe file.
2.1.1
Licence File
To operate, AVEVA software must be able to access the correct Flexman 3.1 licence file, which should be installed on either the Server, on your workstation, or on a networked workstation. Note: Although the disk contains several AVEVA products, you will only be able to use the items that are licensed to you. You will get an on-screen notification to warn you when the licence is due renewal.
2:1
12.0
2:2
12.0
3
3.1
It is recommended that you use the default settings for folder paths etc. unless you have good reasons for doing otherwise. Important: You must not use embedded spaces in folder path names. The process needs at least 3GB 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. When the process is complete, select Start>Programs/AVEVA 12 to reach the Make Project, PDMS Documentation, Project Creation Wizard, Run Background Process Manager and Run PDMS options.
3.1.1
3:1
12.0
3.2
Note: Uninstalling PDMS will not uninstall Microsofts .NET Framework, which must be removed separately if required.
3.3
3.4
Remote Installation
If you wish to have one server installation of PDMS accessed from remote workstations, you must ensure that the Windows system DLLs on each remote workstation are upgraded to a suitable version for running the AVEVA PDMS application programs. You can achieve this by installing AVEVA PDMS 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.
3.5
Silent Installation
This section will instruct the user on how to perform a silent installation of PDMS. The following assumptions are made: User defined path names do not contain spaces. The network share that is being used is shared and that the users performing the installations have access rights to the necessary folder. You can access these
3:2
12.0
commands either from a UNC path or a network drive. A network drive is used in this manual. 1. The folder names in this manual are variable and the user can specify their personal choices. The number of files demonstrated may vary depending on what version is being implemented. Copy the content from the PDMS 12 DVD to a network share. The following screen shot will demonstrate this:
2.
On a workstation create an InstallShield Response File. Please see the following screen shot to create the setup.iss file:
Follow the instructions in the PDMS installation wizard to complete the creation of the InstallShield Response File. 3. To deploy the software silently on other computers use the /s /w switches in conjunction with setup.exe. It is also optional to create a log file of the installation using the f2
3:3
12.0
This can be
3.5.1
3.5.2
3:4
12.0
3.5.3
3:5
12.0
Logonscript example:
3.5.4
Reference here: http://technet2.microsoft.com/ windowsserver/en/library/3512b600-5bb4-4dae-8b2c7b71ef9951a01033.mspx?pf=true [Application] FriendlyName = "AVEVA PDMS 12" SetupCommand = "\\Server\Install\PDMS12\int\t51677\PDMS\Installation4\De ploy.bat" DisplayVersion = 12.0 Publisher = AVEVA
3.5.5
Example of deploy.bat
:InstallPDMS12 :: Install AVEVA PDMS 12.0 Silently echo Installing AVEVA PDMS 12.0 if exist "%TEMP%\PDMS12Inst.log" "%TEMP%\PDMS12Inst.log" del /Q /F
3:6
12.0
/C:"resultcode=0"
"%temp%\PDMS12inst.log"
IF "%ERRORLEVEL%" EQU "0" ( echo Installation succeeded exit /b 0 ) ELSE ( echo Installation failed exit /b 1 )
3:7
12.0
3:8
12.0
Note: In the following instructions it is assumed that AVEVA PDMS has been installed in folder C:\AVEVA. If it has been installed elsewhere, substitute C:\AVEVA with the name of the installation folder.
4.1
4.2
4:1
12.0
list of both tested and supported graphics cards, along with advice on configuration of graphics device drivers.
4.3
4.4
4:2
12.0
PDMS User Environment Variables The following environment variables refer to the location of users PDMS folders. Users must have write permission to these folders. PDMSWK PDMSUSER Temporary PDMS work file folder C:\temp Application Users save/restore setup area (or the users 'home' folder) C:\AVEVA\Plant\PDMS12.0\pdmsuser
4:3
12.0
PDMSREPDIR PDMSDFLTS
PDMS Applicationware Report Input and Output folder. C:\AVEVA\Plant\PDMS12.0\pdmsui\reports Applications defaults folder. Note that individual users may not have permission to change PDMS System defaults in C:\AVEVA\Plant\PDMS12.0\pdmsui\dflts, but they should have their own local defaults area. This is achieved by setting a PDMSDFLTS search path, e.g. C:\USERDFLTS C:\AVEVA\Plant\PDMS12.0\pdmsui\dflts.
Project Environment Variables For each PDMS project, four more environment variables must be set. For example, for a project ABC: ABC000 ABCISO ABCMAC ABCPIC Project database folder Project ISODRAFT options folder Project Inter-DB connection macro folder Project DRAFT picture file folder
PDMS is installed with sample project data (See PDMS Projects). PDMS Project Environment variables for these projects are set in evars.bat.
4.5
Once the Path variable includes the AVEVA PDMS folder, you can run PDMS by typing pdms at a command prompt.
4.6
4:4
12.0
sequence of dialogs to help you create the shortcut. Type in the location of pdms.bat, for example: C:\AVEVA\plant\PDMS12.0\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. If you have C:\AVEVA\plant\PDMS12.0\ (the path name for the pdms.bat file) in your PATH environment variable, just type pdms in a command window to execute the batch file. Otherwise, navigate to the folder where the batch file is stored and type pdms or pdms.bat.
4.6.1
In this example, running runpdmsmacro.bat will enter PDMS in project SAM, as user SYSTEM/XXXXXX, in MDB /STRUC, and run the PDMS command macro mymacrofile.
4.7
4:5
12.0
Example:
set PDMS_CONSOLE_IDENTIFIER=%RANDOM% call %PDMSEXE%\pdms call %PDMSEXE%\pdmswait echo Returned to .bat at %TIME%
This will start PDMS, then wait until it has finished before resuming the script. The MONITOR Reference Manual provides more details on running PDMS batch programs.
4.8
Plotting
To plot in a Windows environment, we recommend that you use the plotcadc.bat file supplied in the AVEVA PDMS folder. Note that you may have to modify the plotcadc.bat 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 plotcadc.bat file, give a command in the format: C:\AVEVA\Plant\PDMS12.0\plotcadc.bat plotfile format printer options 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 quotes. Example:
4:6
12.0
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: Latin-1 Latin-2 Latin-Cyrillic Far Eastern
Supported Languages Name Latin 1 Description ISO 8859-1 Latin alphabet 1 Languages covered Danish, Dutch, English, Faroese, Finnish, French, German, Icelandic, Irish, Italian, Norwegian, Portuguese, Spanish, Swedish, Albanian, Czech, English, German, Hungarian, Polish, Rumanian, SerboCroat, Slovak, Slovene Bulgarian, Byelorussian, English, Macedonian, Serbo-Croatian, Ukrainian, Russian Japanese, Korean, Simplified Chinese, Traditional Chinese
Latin 2
Latin Cyrillic
Far Eastern
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.
5.1
5.1.1
5:1
12.0
2. Double-click Regional Options to show the Regional Options dialog. 3. Click the Input Locales tab. 4. In the Input Locales box, click the required language, and then click Properties. 5. In the Keyboard Layout box, click the required keyboard layout, click OK, and then click OK. 6. Click the General tab. Click to select the check box next to the language group you wish to install, and then click Apply. 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.
5.1.2
Windows XP
To add an additional language in Windows XP, follow these steps: 1. Open the Control Panel. 2. Double-click Regional and Language Options. 3. On the Regional options tab, under Standards and formats, select the required language from the list. 4. Click the Languages tab, and then click Details under "Text services and input languages". 5. Under Default input language, select the required language. If the required language appears in the list, click OK. If it does not appear in the list, then click Add under "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 Text Services and Input Languages dialog. 6. Click the Advanced tab. Under Languages for non-Unicode programs, select the required language. Click Apply. It may be necessary to install new code page conversion tables. Only member of 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.
5.2
5:2
12.0
Languages covered Albanian, Czech, English, German, Hungarian, Polish, Rumanian, Serbo-Croat, Slovak, Slovene Bulgarian, Byelorussian, English, Macedonian, SerboCroatian, Ukrainian, Russian
The corresponding font family must be selected for DRAFT and ISODRAFT drawings. Use Project>Font Families and select the Font Type appropriate for you chosen language. For details, see the Adminstrator User Guide and Adminstrator Command Reference Manual.
5.3
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 /<font filename> PROJECT MBCHARSET CHI PROJECT MBCHARSET TCHIN FILE /<font filename> Simplified Chinese Traditional Chinese
For details, see the Adminstrator User Guide and Adminstrator Command Reference Manual.
5:3
12.0
5:4
12.0
6
6.1
6.2
Select the Overwrite radio button. For the filename enter %PDMSUSER%/fname.csv (the .csv extension is important). In the System command text box enter. 'cmd/c C:\<excel folder>\excel.exe %PDMSUSER%\fname.csv'. where C:\<excel folder> is the location of Excel on your system. Note that it is necessary to enclose Windows command arguments in double quotation marks if the argument contains embedded spaces. :\<excel folder>\.
6.3
Windows Parameters
The following setting can be used to improve performance when repositioning 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.
6:1
12.0
Windows XP Open the Control Panel. Select Display, then select the Appearance tab and click on the Effects button. On the form, uncheck Show Window Contents While Dragging and Show shadows under menus.
6:2
12.0
7
7.1
PDMS Projects
Sample Project
PDMS is supplied with a sample project, which can be used in several ways: It provides you with examples of the use of PDMS. It provides you with sample libraries, catalogues and specifications which enable you to use PDMS before you set up your own, and can be used as starting points when you do start to create your own. It provides you with starting points for the tutorials in the following manuals: Pipework Support Design User Guide Pipework Design User Guide Structural Design User Guide HVAC User Guide Reporting Reference Manual Drawing Production User Guide It provides an example of how to set up your own projects. MAS (Master) provides data in read-only databases. This data should not be deleted or changed in any way, or the rest of the sample project will become unusable. SAM (Sample) contains several MDBs which can be modified, and so they can be used for training,
7.1.1
7.1.2
7:1
12.0
CATS DEMO EQUI HANGER HVAC PIPE SAMPLE STRUC TEAMA TEAMB TEAMC TEAMD TEAME TEAMF TEAMG
CATS/CATS DEMO/DEMO EQUI/EQUI HANGER/HANGER HVAC/HVAC PIPE/PIPE SAMPLE/SAMPLE STRUC/STRUC USERA/A USERB/B USERCC USERD/D USERE/E USERF/F USERG/G
General User with Administration 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: CATADMIN DRAFTADMIN HSADMIN ISOADMIN
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.1.3
7:2
12.0
An MDB for the HVAC Design tutorial. This MDB contains suitable steelwork and civils as a starting point. An MDB containing the master Catalogues and Specifications, LEXICON, Dictionaries etc. An MDB used for practising the use of Catalogues and Specifications. An MDB for the Pipework Design and Pipework Spooling tutorials. 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. An MDB for the Structural Design tutorial. Additional MDBs available for training purposes.
7.1.4
7:3
12.0
7:4
12.0
Troubleshooting
Here are some suggestions about solving some problems you may encounter when using PDMS under Windows.
8.1
General
Error: Explanation: Error: Explanation: The dynamic link library DFORMD.dll could not be found in the specified path. This is supplied with PDMS. Perhaps you have not set your PATH variable. The PATH setting must include C:\AVEVA\plant\PDMS12.0 STOP. The application failed to initialise properly (0xc0000135). Click on OK to terminate the application. This occurs after a number of other errors. The most likely reason is a problem with the PATH variable.
8.2
8:1
12.0
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 obtain by typing 'env|findstr COMPUTERNAME' in a Command Prompt window. Compare this with the license file contents, and resubmit if necessary. FLEXlm: checkout failed: Cannot connect to license server (-15, 10:10061) WinSock error code. lmgrd has not been started up - see above for details. FlexLM: checkout failed: Cannot find license file (-1,73:2) No such file or folder. lmgrd has not been started up - see above for details. FlexLM: checkout failed: Licensed number of users already reached (4,132). You have exceeded the permitted number of users specified in your license file.
8.3
Entering PDMS
Error: Explanation: Error: (43,9) Environment Variable not defined for project name. You have not set the environment variable for the project, e.g. XYZ000. (43,1) Project <xxx> not available! Error 7 allocating system database. Explanation: Error: The environment variable for the project does not point to the correct location. Either the disk and/or folder do not exist or are not readable. <username> not found. Invalid username or password. or Bad Password Explanation: Error: Solution: Error: You are trying to enter PDMS without a valid PDMS username and/or password. PDMSWK environment variable not set. Set PDMSWK to c:\temp or some other folder where PDMS can create temporary files. Error 34 opening variables file.
8:2
12.0
You cannot create a file in the location pointed to by environment variable PDMSWK. Project <xxx> is pre version 8. This can happen if you have transferred the project from UNIX using FTP in ASCII rather than Binary format.
8.4
8:3
12.0
8:4
12.0
9.1
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%.
9.2
PDMSEXE
The environment variable %PDMSEXE% is used to locate the executable on module switch. It is also used to locate attlib.dat (attribute and noun definitions), message.dat (message definitions), desvir.dat (schema definition) etc. Normally PDMS is started from pdms.bat which is located in your %PATH%. Both %PDMSEXE% and %PATH% should include the install directory.
9.3
9:1
12.0
where des.exe and des.dll live in the directory %PDMSEXE% and Wrappers.dll 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 Wrappers.dll and Win32 DLL loading rules are used to load des.dll (and other Win32 DLLs on which des.dll depends).
9.3.1
Wrappers
For each GUI module (DESIGN, DRAFT, ADMIN, ISODRAFT and MONITOR) there is a Wrappers.dll in a subdirectory with the same name as the module. Each Wrapper.dll has a dynamic link to the appropriate Win32 DLL for that module. .NET loading rules are used to load the appropriate Wrappers.dll for a given module. So, when running des.exe, the version of Wrappers.dll linked with des.dll will be loaded. DESIGN and DRAFT subdirectories also contain a drawlistWrapper dll which is used by the Drawlist add-in.
9.3.2
9.3.3
Win32 DLLs
Each Wrappers.dll depends on the given modules Win32 DLL, e.g. DESIGNs Wrappers.dll found in the DESIGN subdirectory depends on des.dll. Win32 DLL loading rules apply here. These are: The directory from which the importing component loaded. (e.g. the DESIGN subdirectory where Wrappers.dll is loaded) The (application's) current directory (where its run from) The Windows directory (default: C:\Windows) (we dont install anything here) The directories that are listed in the PATH environment variable
Since the module DLL does not live in the same directory as the Wrappers.dll then unless you are running from %PDMSEXE%, your %PATH% will be used to locate the module DLL.
9:2
12.0
(The Wrappers.dll subdirectory is the directory which is first searched for all the Win32 DLLs on which Wrappers depends i.e. <module>.dll, sglNet.dll, udDNet.dll, )
9.4
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 e.g. des.exe and des.dll, a config file, a manifest file and an Addins file. The config file is used to specify the location of the Wrappers dlls 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 (e.g. Explorer, Drawlist, ).
9.4.1
PDMSEXE Directory
DESIGN/SPOOLER des.exe, des.dll, des.exe.config, des.exe.manifest, DesignAddins.xml, SpoolerAddins.xml
Shared Depends.dll, DrawList.dll, DrawListAddin.dll, ExplorerAddin.dll, ExplorerControl.dll, ForeignLanguage.dll, HistoryAddIn.dll, MyDataAddIn.dll, ReferenceListAddin.dll, PDMSCommands.dll, PDMSFilters.dll, PDMSResources.dll, PDMSResources.resources, StartUp.dll, ApplicationFramework.dll, udNet.dll, DruidNet.dll
Infragistics
This is a third-party GUI tool-kit:
9:3
12.0
Infragistics.Win.UltraWinTabControl.v3.dll, Infragistics.Win.UltraWinToolbars.v3.dll, Infragistics.Win.UltraWinTree.v3.dll, Infragistics.Win.v3.dll, Infragistics.Win.Misc.v3.dll System msvcp71.dll, msvcr71.dll Other DLLs required by DRAFT
These DLLs are loaded as required by specific DRAFT commands:
9.4.2
PDMSEXE/DESIGN subdirectory
drawlistWrappers.dll, Wrappers.dll
9.4.3
PDMSEXE/DRAFT subdirectory
drawlistWrappers.dll, Wrappers.dll
9.4.4
PDMSEXE/MONITOR subdirectory
Wrappers.dll
9.4.5
PDMSEXE/ISODRAFT subdirectory
drawlistWrappers.dll, Wrappers.dll
9.4.6
PDMSEXE/ADMIN subdirectory
Wrappers.dll
9.4.7
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, e.g. for DESIGN this file is DesignAddins.xml. The toolbar entries to show and hide each add-in are defined in PML.
9.5
9:4
12.0
10
10.1
10.2
10:1
12.0
Since the module DLL does not live in the same directory as the Wrappers.dll then unless PDMS is running from %PDMSEXE% the %PATH% will be used to locate the module DLL. (The Wrappers.dll subdirectory is effectively is the directory which is first looked in for all the Win32 DLLs which Wrappers depends on i.e. <module>.dll, sglNet.dll, udDNet.dll, ) Make sure that both %PDMSEXE% and %PATH% point to the root directory in which PDMS is installed.
10.3
Interface Incompatibility
Error: An exception mon.exe, or System.MissingMethodException has occurred in
An exception System.IO.FileNotFoundException has occurred in mon.exe Additional information: A procedure imported by 'Wrappers' could not be loaded Solution: The interfaces between components are not compatible. Check that File>Properties>Version Assembly Version on all assemblies is 12, or whatever the current version is.
10.4
No Add-ins
Problem: Solution: Add-ins missing from module Add-ins loaded by each module are defined in the following xml files: DesignAddins.xml DraftAddins.xml IsodraftAddins.xml SpoolerAddins.xml
10:2
12.0
10.5
Window Layout
Problem: Solution: Window layout is not restored e.g. Add-ins position and/or docked state, The file <module><version>WindowLayout.xml 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.
10.6
Serialization
Serialization is the process used to store the data - e.g. history stacks, toolbar state - for the GUI in a .NET environment. Problem: Information is stored per project and per module in the following files in the %PDMSUSER% directory: <project><version>Settings.bin <module><version>Settings.bin. CAF (Common Application Framework) window layout information is stored in: c:\documents and settings\<username>\local settings\application data\AVEVA\PDMS Solution: These files may be deleted or transferred between users working on the same project. Users can delete or transfer the root directory.
10:3
12.0
10:4
12.0