Documente Academic
Documente Profesional
Documente Cultură
D/3® DCS
Upgrade Utilities Reference
Manual
RM1.0025.V12.3‐2A
Upgrade Utilities Reference Manual
Proprietary Notice
NovaTech Process Solutions, LLC (NovaTech) has exercised great care to ensure that the
information contained in this document is accurate and current, however, no guaranty or warranty
in this regard is given or implied.
The policy of NovaTech is to periodically improve and update its documentation. Therefore, the
information in this document is subject to change without notice.
The information disclosed herein is considered confidential and/or proprietary to NovaTech.
Neither this document nor any information disclosed herein shall be reproduced or transferred in
any manner, in whole or in part, or used or disclosed to others for any purpose whatsoever, except
as specifically authorized in writing by an authorized representative of NovaTech.
This proprietary notice shall not be construed as a warranty of the information herein contained,
nor as a limitation of the right of NovaTech to make revisions thereto.
TotalVision, D/3, D/3 DCS, FlexBatch, and SABL are registered trademark of NovaTech Process
Solutions, LLC. The NovaTech logo is a trademark of NovaTech. Microsoft, MS, Windows,
Windows XP, Windows 2003 Server and Excel are registered trademarks of Microsoft Corporation.
All other brand and product names are trademarks or registered trademarks of their respective
owners.
Copyright © 1982‐2009 NovaTech Process Solutions, LLC.
Upgrade Utilities Reference Manual
Contents
Preface ............................................................................................................................................1
Purpose of this Manual...........................................................................................................................................1
Intended Audience..................................................................................................................................................1
Structure of this Document.....................................................................................................................................1
Related Documentation ..........................................................................................................................................2
Safety Notice ..........................................................................................................................................................3
Safety Guidelines ............................................................................................................................................3
ICS 3-304.81 Safety Recommendations..........................................................................................................3
Notification de Sécurité..........................................................................................................................................3
Directives de Sécurité......................................................................................................................................3
Recommandations de Sécurité ICS 3-304.81 ..................................................................................................4
Upgrade Utilities..........................................................................................................................5
Upgrade Utilities by version...................................................................................................................................5
SABL Redundancy Conversion Utility — REMB..................................................................7
How to Run SABL Redundancy Conversion Program (REMB)............................................................................7
Example of Using REMB................................................................................................................................7
Conversions Done by REMB ..........................................................................................................................7
CVT63TO70...................................................................................................................................9
Using CVT63TO70 ................................................................................................................................................9
CNVT_Graphic...........................................................................................................................11
Using CNVT_Graphic..........................................................................................................................................11
CNVT_Sub ..................................................................................................................................13
Using CNVT_Graphic..........................................................................................................................................13
CVT81TO90.................................................................................................................................15
Using CVT81TO90 ..............................................................................................................................................15
PCM.DAT Conversion Tool — CvtPcmDat..........................................................................17
Introduction to PCM.DAT Conversion Tool — CvtPcmDat ...............................................................................17
A Description of the PCM_SETTINGS.dat Data File..........................................................................................17
A Description of the D3SYSTEM_SETTINGS.DAT Data File ..........................................................................18
How to Run PCM.DAT Conversion Tool - CvtPcmDat ......................................................................................19
RM1.0025.V12.3‐2A i
Upgrade Utilities Reference Manual
Samples of a PCM.dat File, PCM_SETTINGS.dat File, D3SYSTEM_SETTINGS.dat File, and Sample Run Screen
Shot.......................................................................................................................................................................20
Sitesetup.com Conversion Tool ‐ CvtSiteSetup...................................................................23
Introduction to sitesetup.com Conversion Tool — CvtSiteSetup.........................................................................23
A Brief Description of the sitesetup.com Data File..............................................................................................23
A Brief Description of the D3SYSTEM_SETTINGS.dat Data File ....................................................................24
How to Run sitesetup.com Conversion Tool - CvtSiteSetup................................................................................25
Sample D3SYSTEM_SETTINGS.dat File, CDCM_SETTINGS.dat File, and Sample Run Screen Shot ...........26
CVT101TO102.............................................................................................................................31
Using CVT101TO102 ..........................................................................................................................................31
CVT102TO11...............................................................................................................................33
Using CVT102TO11 ............................................................................................................................................33
VT10TO11CNVRT.....................................................................................................................35
Using VT10TO11CNVRT ...................................................................................................................................35
CVT121TO122.............................................................................................................................37
Using CVT121TO122 ..........................................................................................................................................37
CVTSABL1230TO1231 ..............................................................................................................39
Using CVTSABL1230TO1231 ............................................................................................................................39
CVTSABL1230TO1231 Execution .....................................................................................................................40
Index .............................................................................................................................................41
RM1.0025.V12.3‐2A ii
Upgrade Utilities Reference Manual
Preface
Purpose of this Manual
This manual contains information about the various applications and utilities that are used to
upgrade from a previous version of D/3 software.
The information in this manual is subject to change at the discretion of NovaTech Process Solutions,
LLC.
Intended Audience
This manual is for users with a background and a familiarity with older versions of NovaTech
Process Solutions, LLC D/3 Distributed Process Control Systems. Knowledge of systems dating
back to V6.2 may be needed to use these utilities.
Structure of this Document
This manual contains the following information:
Chapter One ‐ Upgrade Utilities by Version.
This chapter provides a list of each conversion utility and describes which release it references.
Chapter Two ‐ SABL Redundancy Conversion Utility — REMB.
This chapter describes how to use REMB to convert SABL programs created prior to D/3 software
version 6.2 for use with Transparent SABL Redundancy.
Chapter Three ‐ CVT63TO70 Utility.
This chapter describes how to use CVT63TO70 to convert a V6.3 Sequence Database text file to V7.0,
adding new prompts.
Chapter Four ‐ CNVT_Graphic Utility.
This chapter describes how to use CNVT_Graphic to convert Grinell graphics from 9 character
EPNs to 12 character EPNs.
Chapter Five ‐ CNVT_Sub Utility.
RM1.0025.V12.3‐2A 1
Upgrade Utilities Reference Manual
This chapter describes how to use CNVT_sub to convert Grinell subgraphics from 9 character EPNs
to 12 character EPNs.
Chapter Six ‐ CVT81TO90 Utility.
This chapter describes how to use CVT81TO90 to convert a V8.1 MDL text file to V9.0, adding new
prompts.
Chapter Seven ‐ PCM.DAT Conversion Utility — CvtPcmDat.
This chapter describes the conversion tool that generates a D/3 V10.0 system PCM_SETTINGS.dat
file from the old PCM.dat file. It also creates a partial D3SYSTEM_SETTINGS.dat file containing
UPF, RPF and RDF information.
Chapter Eight ‐ Sitesetup.com Conversion Tool — CvtSiteSetup.
This chapter describes the sitesetup.com Conversion Tool – CvtSiteSetup.
Chapter Nine ‐ CVT101TO102.
This chapter describes how to use CVT101to102 to convert a V10.1 MDL text file to V10.2, adding
the new prompts.
Chapter Ten ‐ CVT102TO11.
This chapter describes how to use CVT102TO11 to convert a V10.2 MDL text file to V11.0, adding
the new prompts.
Chapter Eleven ‐ VT10to11CNVRT.
This chapter describes how to use VT10TO11CNVRT to convert V9 and V10 VersaTrend group files
to V11.
Chapter Twelve ‐ CVT121TO122.
This chapter describes how to use CVT121TO122 to convert a V12.1 MDL text file to V12.2, adding
the new OUT prompts.
Chapter Thirteen ‐ cvtSABL1230TO1231.
This chapter describes how to use cvtSABL1230TO1231 to convert a V12.3‐0 SABL text file to V12.3‐
2, revising % signs in PRINT and QUERY statements.
Related Documentation
D/3 Archived Release Notes
All other D/3 Documentation.
RM1.0025.V12.3‐2A 2
Upgrade Utilities Reference Manual
Safety Notice
Safety Guidelines
Control devices can fail in an unsafe condition. This means that unless proper safeguards are
incorporated, certain malfunctions of these devices could lead to unexpected equipment operation.
Such unexpected equipment operation could result in property damage and/or severe physical
injury to the equipment operator. Safety devices and techniques must be used in all industrial
control systems to prevent injury to personnel or equipment. NEMA ICS 3‐304 provides general
recommendations, which apply for the design and installation of systems controlled by automated
electronic systems as follows:
ICS 3‐304.81 Safety Recommendations
This section is Consideration should be given to the use of an emergency
reproduced by stop function, which is independent of the programmable
permission of the controller. Where the operator is exposed to the
National Electrical machinery, such as in loading or unloading a machine tool,
Manufacturers or where the machine cycles automatically, consideration
Association from NEMA should be given to the use of an electromechanical
3‐304 Programmable override or other redundant means, independent of the
Controller Standard. programmable controller, for starting and interrupting the
cycle. If the provision is required for changing programs
while the equipment is in operation, consideration should
be given to the use of locks or other means of assuring that
such changes can be made only by authorized personnel.
These recommendations are intended as safeguards
against failure of critical components and the effects of
such failures or the inadvertent errors that might be
introduced if programs are changed while the equipment
is in operation.
Notification de Sécurité
Directives de Sécurité
Les dispositifs de commande peuvent faire défaut dans des conditions hasardeuses. Ceci signifie
quʹà moins que des sauvegardes appropriées soient incorporées, certains défauts de
fonctionnement de ces dispositifs pourraient entraîner un déclenchement inattendu du matériel. Un
tel déclenchement inattendu du matériel pourrait causer des dégâts au matériel et/ou des lésions
physiques graves à lʹopérateur du matériel. Des dispositifs et techniques de sécurité doivent être
employés dans tous les systèmes de commande industriels pour empêcher des dommages au
RM1.0025.V12.3‐2A 3
Upgrade Utilities Reference Manual
personnel ou au matériel. La NEMA ICS 3‐304 fournit les recommandations générales, qui sont
dʹapplication pour le développement et lʹinstallation des systèmes contrôlés par des systèmes
électroniques automatisés comme suit :
Recommandations de Sécurité ICS 3‐304.81
Cette section est Lʹutilisation dʹune fonction dʹarrêt dʹurgence, qui est indépendant du
reproduite par la contrôleur programmable, doit être considérée. Là où lʹopérateur est
permission de exposé à la machinerie, comme dans le chargement ou déchargement
lʹAssociation Nationale dʹune outillage de la machine, ou à lʹendroit où la machine fonctionne
de Fabricants de automatiquement, considération devrait être donnée à lʹutilisation
Matériel Electrique dʹun dépassement électromécanique ou autres moyens
NEMA 3‐304. Norme supplémentaires, indépendant du contrôleur programmable, pour
du Contrôleur commencer et interrompre le cycle. Si la disposition est exigée pour
Programmable. des programmes changeants pendant le fonctionnement du matériel,
considération devrait être donnée à lʹutilisation dʹun verrouillage ou
autres moyens qui assurent que de tels changements peuvent être
faits seulement par le personnel autorisé. Ces recommandations ont
pour but la sauvegarde contre toute panne de composants critiques et
les effets de telles pannes ou des erreurs introduites par inadvertance
lors dʹun changement de programme pendant le fonctionnement du
matériel.
RM1.0025.V12.3‐2A 4
Upgrade Utilities Reference Manual
Upgrade Utilities
As new features are added to the product, changes in the applications files (those files designed to
custom tailor the D/3 to your particular application) may be required. (e. g. Input files may require
additional prompts or binary files may require additional fields) This manual describes several
utilities included in the software distribution to assist with the upgrade process.
This manual is not intended to be a list of all of the steps required to upgrade your system. For
assistance in upgrading your D/3 applications please contact your Project Manager, local sales
representative or local field service representative.
In This Chapter
Upgrade Utilities by version
Upgrade Utilities by version
Each utility will have a brief description of its purpose. In this section you will find information
about what versions of D/3 software require that particular utility. This table lists each utility and
the version of D/3 software that it was designed for. You MAY require any or all of the utilities
whose version number is greater than or equal to the version of D/3 software from which you are
upgrading.
Utility Needed to upgrade from
versions
REMB 1.7 through 6.1
CVT63to70 1.7 through 6.3
CNVT_Graphic 1.7 through 7.0
CNVT_Sub 1.7 through 7.0
CVT81to90 1.7 through 8.1
CvtPcmDat 1.7 through 9.1
CvtSiteSetup 1.7 through 9.1
CVT101to102 1.7 through 10.1
CVT102to11 1.7 through 10.2
VT10to11CNVRT 1.7 through 10.2
CVT121to122 1.7 through 12.1
CVTSABL1230to1231 1.7 through 12.3‐1
RM1.0025.V12.3‐2A 5
Upgrade Utilities Reference Manual
SABL Redundancy Conversion Utility — REMB
The SABL conversion program, REMB (REMove B), allows existing redundant SABL programs to
be stripped of their B statements.
REMB will only change legal SABL B statements to their non‐B form. REMB does not convert
erroneous syntax, comments or program logic.
REMB acts on one SABL program at a time. The program will read the input file, perform the
conversions and write out an output file. By default the output file is the same name and new
version of the input file. An output switch is available to obtain customized output file names.
In This Chapter
How to Run SABL Redundancy Conversion Program (REMB)
How to Run SABL Redundancy Conversion Program (REMB)
The syntax for REMB is:
remb input_filename [-o output_filename]
Where:
‐remb is the name of the program
‐input_filename is the name of the SABL program to be converted
‐output_filename is the optional name of the output file (default is same name, new
version, as the input_filename)
The B statements that will be converted by REMB and their non‐redundant form are listed in the
table on the following page:
Example of Using REMB
REMB may be used on a command line or included in a command file. An example is:
REMB %D3APP%\SETUP\SPECIFIC\PCM0\SABL\PROGRAM.SEQ
When REMB encounters no errors during a conversion no messages are generated.
Conversions Done by REMB
B Statements Converted to
BASSGN ASSIGN
BCLOSCASC CLOSCASC
RM1.0025.V12.3‐2A 7
Upgrade Utilities Reference Manual
BCLOSE CLOSE
BDEVCMD DEVCMD
BHALF HALF
BIDLE IDLE
BLET LET
BMID MID
BOPEN OPEN
BOPENCASC OPENCASC
BPUTAUTO PUTAUTO
BPUTMANL PUTMANL
BPUTOUT PUTOUT
BSTART START
BSTEP STEP
BSTOP STOP
BTIMERCLR TIMERCLR
BTIMEROFF TIMEROFF
BTIMERON TIMERON
BTURNOFF TURNOFF
BTURNON TURNON
OFFBERR NOP
ONBERR NOP
SYNCH will not be changed to remove the unit. A warning will be generated when this statement
is used in a unit. SYNCH will now cause the entire PCM to do a sync — not just one unit.
RM1.0025.V12.3‐2A 8
Upgrade Utilities Reference Manual
CVT63TO70
New features were added to the Sequence database in D/3 version 7.0 that required new prompts to
be added to SDB, the utility that builds the Sequence Database for each PCM. SDB source files
created on a system older than version 7.0 need to be converted before they can be built on your
version 12.0 system.
In This Chapter
Using CVT63TO70
Using CVT63TO70
1. From a command prompt, set your working directory to the directory containing your SDB
text file for a particular PCM Typically:
C:\Program Files\GSE Systems\D3
DCS\D3App\Setup\Specific\<pcmname>\SDB
2. Enter the command:
CVT63TO70 <filename>
Where:
<filename> is the name of the PCM’s SDB text file typically:
<pcmname>SDB.CMD
3. Repeat this procedure for every PCM
RM1.0025.V12.3‐2A 9
Upgrade Utilities Reference Manual
CNVT_Graphic
Prior to D/3 version 8.0, EPNs were limited to 9 characters. D/3 version 8.0 and later support EPNs
up to 12 characters in length. Grinell graphics (.bin) and subpicture (.sub) files created on systems
older than D/3 version 8.0 must be converted to allow 12 character EPNs. CNVT_Graphic converts
graphic (.bin) files to allow for 12 character EPNs.
In This Chapter
Using CNVT_Graphic
Using CNVT_Graphic
Usage:
cnvt_graphics -i xxx
where: xxx is the graphic number to convert
This utility converts 9 character EPN graphics to 12 character EPN graphics. A GRAxxx.CVT file is
created if the conversion is successful. This file can then be renamed to GRAxxx.BIN and compiled
using D/3 manager or the GRC Utility.
RM1.0025.V12.3‐2A 11
Upgrade Utilities Reference Manual
CNVT_Sub
Prior to D/3 version 8.0, EPNs were limited to 9 characters. D/3 version 8.0 and later support EPNs
up to 12 characters in length. Grinell graphics (.bin) and subpicture (.sub) files created on systems
older than D/3 version 8.0 must be converted to allow 12 character EPNs. CNVT_Sub converts
subpicture (.sub) files to allow for 12 character EPNs.
In This Chapter
Using CNVT_Graphic
Using CNVT_Graphic
Usage:
cnvt_sub -i tttttttt
where: tttttttt is the subpicture to convert
This utility converts 9 character EPN subpictures to 12 character EPN subpictures. A tttttttt.CVT file
is created if the conversion is successful. This file can then be renamed to tttttttt.SUB
RM1.0025.V12.3‐2A 13
Upgrade Utilities Reference Manual
CVT81TO90
The CVT81TO90 utility adds prompts to the AI, DIN, DOT, DGR and DEV definitions in the
<pcm>MDL.CMD files for each PCM of a D/3 version 8.1 or earlier system to support featues added
in D/3 version 9.0.
In This Chapter
Using CVT81TO90
Using CVT81TO90
To use the conversion program, do the following:
1. From a Windows Command Prompt, change the directory to the CDB directory where the
text file is located. Typically:
%D3App%\Setup\Specific\PCMNAME\CDB
2. Issue the command:
CVT81TO90 <pcm>mdl.mdl
This will create a new <pcm>mdl.mdl.
3. Repeat this process to update all the PCM CDB Model command text files in the system
Note: The file must then be run through CVT101to102 and
CVT102to110 before the file can be run through MDL to
produce a valid <pcm>.UDB and <pcm>.REF file.
RM1.0025.V12.3‐2A 15
Upgrade Utilities Reference Manual
PCM.DAT Conversion Tool — CvtPcmDat
This chapter describes the PCM.DAT Conversion Tool – CvtPcmDat.
In This Chapter
Introduction to PCM.DAT Conversion Tool — CvtPcmDat
A Description of the PCM_SETTINGS.dat Data File
A Description of the D3SYSTEM_SETTINGS.DAT Data File
How to Run PCM.DAT Conversion Tool ‐ CvtPcmDat
Samples of a PCM.dat File, PCM_SETTINGS.dat File, D3SYSTEM_SETTINGS.dat File, and Sample
Run Screen Shot
Introduction to PCM.DAT Conversion Tool — CvtPcmDat
The PCM.DAT Conversion Tool — CvtPcmDat, generates D/3 V11.0 system PCM_SETTINGS.dat
file from the old PCM.dat file. It also creates a partial D3SYSTEM_SETTINGS.dat file containing
UPF, RPF and RDF information.
The CvtPcmDat can be run at any Windows workstation. The new PCM_SETTINGS.dat files
contain the format required for the D/3 V11.0 SABL routines and appends each UPF, UDF, and RPF
routine to D3SYSTEM_SETTINGS.dat. The CvtPcmDat program resides in the tools directory on a
D/3 V11.0 CDCM node. The program is run from a DOS window on the CDCM node.
A Description of the PCM_SETTINGS.dat Data File
This data file defines the application data that is converted from a previous D/3 system’s pcm.dat
file.
This data file specifies the new PCMs defined in the D/3 V11.0 System. The file defines the
Continuous, External, Sequence Database, and all SABL Programs to build and load for each PCM.
This file also defines PCM loading options for TrendR, Product Tracking, and the PLC database.
Each of PCM_SETTINGS.dat files is created with a block of PCM in the previous PCM.dat data file.
The file name of new PCM_SETTINGS.dat will be pcmnam_SETTINGS.dat in which pcmnam is the
name of the PCM as defined in the original PCM.dat file.
FORMAT:
LOAD_CDB
LOAD_SDB
RM1.0025.V12.3‐2A 17
Upgrade Utilities Reference Manual
LOAD_PLC
LOAD_XIO
LOAD_ABL
AUTO_RESYNC
SIM_FREEZE
COL_GROUPS n
EXC_GROUPS m
;BUILD_SEQ pgmnam pcmnam Y
. additional ;BUILD_SEQ
LOAD_SEQ pgmnam pcmnam
. additional LOAD_SEQ
RUN_SEQ pgmnam unit (each unit of the same pgmnam can only be RUN once)
. additional RUN_SEQ
Where:
pcmnam The name of the PCM as defined in the D/3 System Configuration
LOAD_CDB Indicates Build and Load CDB ‐ Continuous Database
LOAD_SDB Indicates Build and Load SDB ‐ Sequence Database
LOAD_PLC Indicates the PLC Database should loaded to the PCM
LOAD_XIO Indicates Build and Load XIO – External Database
LOAD_ABL Indicates the ABL Manager should be loaded to the PCM
AUTO_RESYNC Indicates Auto_Resync should be enabled in the PCM
SIM_FREEZE Indicates Load the PCM in Simulation Freeze Mode
COL_GROUPS n Indicates n TrendR Collection Groups for the PCM
EXC_GROUPS m Indicates m exception groups (m can never be greater than n)
A Description of the D3SYSTEM_SETTINGS.DAT Data File
The PCM.DAT Conversion Tool appends UPF, UDF, and RPF routines to
D3SYSTEM_SETTINGS.dat data files.
UPF, UDF, and RPF routines are defaulted to the following:
FORMAT:
;UPF= upfnam
RM1.0025.V12.3‐2A 18
Upgrade Utilities Reference Manual
;RPF= rpfnam
;RDF= rdfnam
Where:
;UPF Indicates Build and Load UPF – Unit Prototypes Files.
upfnam 1 to 8 character UPF Input File Name.
;RPF Indicates Build and Load RPF – Recipe Prototypes Files.
rpfnam 4 Character RPF Input File Name.
;RDF Indicates Build and Load RDF – Recipe Data Files.
rdfnam 5 to 8 Character RDF Input File Name – the first 4 characters being the
corresponding RPF Input File Name.
How to Run PCM.DAT Conversion Tool ‐ CvtPcmDat
Run the PCM.DAT conversion tool by executing CvtPcmDat on an MS‐Windows 2000 PC.
To run from an active MS‐Windows 2000 Explorer, change the directory to the following: …GSE
Systems\D3DCS\D3bin\Tools. Double‐click on CvtPcmDat.exe.
At the prompt enter the PCM.dat file name; enter the full path and filename of your D/3 version
9.0.X PCM.dat file.
RM1.0025.V12.3‐2A 19
Upgrade Utilities Reference Manual
The program will then parse the PCM.dat file and create a D3SYSTEM_SETTINGS.dat file and
several PCM_SETTINGS.dat files in the %D3App%\Data\cfg directory. The D/3 Architect and D/3
Manager programs use these files during normal D/3 operation.
Note: The D3SYSTEM_SETTINGS.dat file will be appended by
CvtPcmDat by default. If the file doesn’t exist, it will be
created and all the routines will be written to it.
Samples of a PCM.dat File, PCM_SETTINGS.dat File,
D3SYSTEM_SETTINGS.dat File, and Sample Run Screen Shot
This section shows a sample of an old PCM.dat file with its respective PCM_SETTINGS.dat file and
D3SYSTEM_SETTINGS.dat file.
The following illustrations are samples of a PCM.dat file and a PCM_SETTINGS.dat file along with
the corresponding D3SYSTEM_SETTINGS.dat file and a sample run screen shot.
RM1.0025.V12.3‐2A 20
Upgrade Utilities Reference Manual
RM1.0025.V12.3‐2A 21
Upgrade Utilities Reference Manual
Sitesetup.com Conversion Tool ‐ CvtSiteSetup
This chapter describes the sitesetup.com Conversion Tool ‐ CvtSiteSetup.
In This Chapter
Introduction to sitesetup.com Conversion Tool — CvtSiteSetup
A Brief Description of the sitesetup.com Data File
A Brief Description of the D3SYSTEM_SETTINGS.dat Data File
How to Run sitesetup.com Conversion Tool ‐ CvtSiteSetup
Sample D3SYSTEM_SETTINGS.dat File, CDCM_SETTINGS.dat File, and Sample Run Screen Shot
Introduction to sitesetup.com Conversion Tool — CvtSiteSetup
The sitesetup.com Conversion Tool — CvtSiteSetup, generates D/3 V11.0 system CDCM‐NODE
setting files from the old sitesetup.com file. It also creates a partial D3SYSTEM_SETTINGS.dat file
with system wide settings.
The CvtSiteSetup can be run at any MS‐Windows 2000 workstation. The new CDCM‐NODE setting
files converted from sitesetup.com data file contain the format required for D/3 V11.0 CDCM node
specific parameters. CvtSiteSetup also converts system wide parameters from sitesetup.com data
file to D3SYSTEM_SETTINGS.dat file. The CvtSiteSetup program resides in the tools directory on
D/3 V11.0. The program is run from a command prompt window on a Windows PC.
A Brief Description of the sitesetup.com Data File
This data file defines the D3 system wide parameters (DEFSYS) which are defined for any CDCM
node. Sitesetup.com file also defines the CDCM node specific parameters (DEFNOD).
RM1.0025.V12.3‐2A 23
Upgrade Utilities Reference Manual
The system wide parameters that are being converted only consists of these parameters:
JOB_NUMBER
SYSTEM_NAME
VERSION
SHOW_BLUE_ALARMS
NODAL_BEEPING
NONCRITICAL_ALARM_BEEPING
For each CDCM node, Alarm settings are ignored because D/3 V11.0 uses a different format for
alarms.
A Brief Description of the D3SYSTEM_SETTINGS.dat Data File
CvtSiteSetup writes system wide parameters to D3SYSTEM_SETTINGS.dat data file.
The following settings are written to the D3SYSTEM_SETTINGS.dat data file with their previous
values. Other D/3 V11.0 system settings are written with the default value. D/3 settings are followed
by UPF, UDF, and RPF routines.
RM1.0025.V12.3‐2A 24
Upgrade Utilities Reference Manual
JOB_NUMBER
SYSTEM_NAME
SHOW_BLUE_ALARMS
NODAL_BEEPING
NONCRITICAL_ALARM_BEEPING
How to Run sitesetup.com Conversion Tool ‐ CvtSiteSetup
Run CvtSiteSetup by executing CvtSiteSetup.exe on MS‐Windows Workstation.
To run from an active Windows Explorer, change the directory to the following: %D3Bin%\Tools.
Double‐click on CvtSiteSetup.exe.
At the prompt enter the sitesetup.com file name; enter the full path and filename of your D/3
version 9.0.X sitesetup.com file.
The program will then parse the sitesetup.com file and create a D3SYSTEM_SETTINGS.dat file and
several CDCM_SETTINGS.dat files in the %D3App%\Data\cfg directory. The D/3 Architect and
D/3 Manager programs use these files during normal D/3 operation.
RM1.0025.V12.3‐2A 25
Upgrade Utilities Reference Manual
Note: If a D3SYSTEM_SETTINGS.dat file exists, then CvtSiteSetup
will overwrite the existing D/3 system wide parameters with
the newly parsed settings. If it doesn’t exist, it will be created
and all the settings will be written to it. If any
NODE_SETTINGS.dat files exist, CvtSiteSetup will ask you if
you want the existing files to be overwritten or not.
Sample D3SYSTEM_SETTINGS.dat File, CDCM_SETTINGS.dat
File, and Sample Run Screen Shot
The following are samples of sitesetup.com, CDCM‐NODE_SETTINGS.dat,
D3SYSTEM_SETTINGS.dat, and a sample run.
RM1.0025.V12.3‐2A 26
Upgrade Utilities Reference Manual
RM1.0025.V12.3‐2A 27
Upgrade Utilities Reference Manual
RM1.0025.V12.3‐2A 28
Upgrade Utilities Reference Manual
RM1.0025.V12.3‐2A 29
Upgrade Utilities Reference Manual
CVT101TO102
Six new prompts were added to the Analog Input Scan Block in D/3 version 10.2. The HIHI and
LOLO alarm limits can now be optionally defined as critical or noncritical, HHCRIT, LLCRIT,
respectively. The IBAD, OCD, OVER and UNDER alarm fields, IBDADR, OCDADR, OVRDAR,
UNDADR have been added to support ControlNet™ and Profibus I/O.
The CVT101TO102 utility adds these prompts to the AI definitions in the <pcm>MDL.MDL files for
each PCM of a D/3 version 10.1 or earlier system to support features added in D/3 version 10.2.
In This Chapter
Using CVT101TO102
Using CVT101TO102
To use the conversion program, do the following:
1. From a Windows Command Prompt, change the directory to the CDB directory where the
text file is located. Typically:
%D3App%\Setup\Specific\PCMNAME\CDB
2. Issue the command:
Cvt101to102 <pcm>mdl.mdl
This will create a new <pcm>mdl.mdl and rename the old file <pcm>mdl.101. The new
<pcm>mdl.mdl can then be used as the text input file to rebuild the PCM’s continuous
database.
3. Repeat this process to update all the PCM CDB Model command text files in the system.
Note: The file must then be run through CVT102to110 before the file
can be run through MDL to produce a valid <pcm>.UDB and
<pcm>.REF file.
RM1.0025.V12.3‐2A 31
Upgrade Utilities Reference Manual
CVT102TO11
Three new prompts were added to the Analog Input, Digital Input, Digital Output, Digital Group
and Digital Device Blocks in D/3 version 11.0 to support the new Alarm Inhibit Timeout feature:
IHENAB Indicates whether Alarm Inhibit Timeout is enabled for t this
EPN
IHDTIME Indicates the ‘Default’ timeout value for this EPN
IHDUNITS Indicates the ‘Default’ units (Hours or Days) for this EPN
The CVT102TO11 utility adds these prompts to the EPN definitions in the <pcm>MDL.MDL files
for each PCM of a D/3 version 10.2 or earlier system to support features added in D/3 version 11.0.
In This Chapter
Using CVT102TO11
Using CVT102TO11
To use the conversion program, do the following:
1. From a Windows Command Prompt, change the directory to the CDB directory where the
text file is located. Typically:
%D3App%\Setup\Specific\<pcmname>\CDB
2. Issue the command:
Cvt102to11 <pcmname>mdl.mdl
This will create a new <pcmname>mdl.mdl and rename the old file <pcmname>mdl.102.
The new <pcmname>mdl.mdl can then be used as the text input file to rebuild the PCM’s
continuous database.
3. Repeat this process to update all the PCM CDB Model command text files in the system.
RM1.0025.V12.3‐2A 33
Upgrade Utilities Reference Manual
VT10TO11CNVRT
D/3 version 11.0 VersaTrend™ display groups have 2 new fields for each point in the group that
indicate the Line Thickness and Line Style of the point. VersaTrend™ display groups created on a
version 9.0, 9.1, 10.0, 10.1 or 10.2 D/3 system do not have these fields. ALL VersaTrend™ display
groups built on a system prior to D/3 version 11.0 MUST be converted using the VT10TO11CNVRT
utility.
In This Chapter
Using VT10TO11CNVRT
Using VT10TO11CNVRT
1. Execute the VT10TO11CNVRT utility from the %D3Bin%\Tools directory
VT10to11Cnvrt.exe in the %D3Bin%\Tools directory
2. VT10TO11CNVRT will respond with:
Working…
Successfully Converted Group File D3CON:GRP001.VT
Successfully Converted Group File D3CON:GRP002.VT
RM1.0025.V12.3‐2A 35
Upgrade Utilities Reference Manual
Etc…
3. VT10TO11CNVRT will add the appropriate fields to each point in each group listed in your
%D3App%\Data\Console\GRPLIST.VT file, which is the list of groups availible in the
Open dialog in VersaTrend™.
RM1.0025.V12.3‐2A 36
Upgrade Utilities Reference Manual
CVT121TO122
Three new prompts were added to the Analog Output Block in D/3 version 12.2 to support the new
output range feature for Profibus, ControlNet and Ethernet I/O:
OUTRNGTYP Indicates if the limits are SIGNED or
UNSIGNED
OUTPUTLO Output Low Scaling
OUTPUTHI Output High Scaling
The CVT121TO122 utility adds these prompts to the EPN definitions in the <pcm>MDL.MDL files
for each PCM of a D/3 version 12.1 or earlier system to support features added in D/3 version 12.2.
In This Chapter
Using CVT121TO122
Using CVT121TO122
To use the conversion program, do the following:
1. From a Windows Command Prompt, change the directory to the CDB directory where the
text file is located. Typically:
%D3App%\Setup\Specific\<pcmname>\CDB
2. Issue the command:
CVT121TO122 <pcmname>mdl.mdl
This will create a new <pcmname>mdl.mdl and rename the old file <pcmname>mdl.121. The
new <pcmname>mdl.mdl can then be used as the text input file to rebuild the PCM’s
continuous database.
3. Repeat this process to update all the PCM CDB Model command text files in the system
RM1.0025.V12.3‐2A 37
Upgrade Utilities Reference Manual
CVTSABL1230TO1231
The syntax of the SABL PRINT and QUERY statements was modified in V12.3‐1 to require the use
of two percent signs (%%) to print a percent sign in PRINT and QUERY statements.
”Program is 0%% done.” –use of two %% signs. This will print “ Program is 0% done.”
A single percent sign (%) is interpreted as a formatting character.
The cvtSABL1230TO1231 utility adds the additional % sign to individual % signs in SABL PRINT
and QUERY statements.
This program also converts %s, %P and %S to %p.
Text in comment lines is not changed.
Text not within a quotation string is not changed.
All other single % signs are changed to %% unless followed by an “i” , a “p” or a “[number 0‐
99][.][number 0 ‐99]f”. Ambiguous expressions such as “%%f” or “%%P” produce a warning
message.
In This Chapter
Using CVTSABL1230TO1231
CVTSABL1230TO1231 Execution
Using CVTSABL1230TO1231
To use the conversion program, do the following:
1. From a Windows Command Prompt, change the directory to the SABL directory where the
text file is located. Typically:
%D3App%\Setup\Specific\<pcmname>\SABL
2. Issue the command:
cvtSABL1230to1231 <SABLprogram>.seq -p
This will create a new <SABLprogram>.seq and rename the old file
<SABLprogram>.seq.seq1230. The new <SABLprogram>.seq file can then be used as the new
SABL program to compile using SIC.
3. Repeat this process to update all the SABL text files in the system.
All of the SABL programs in an entire directory can be converted as follows:
RM1.0025.V12.3‐2A 39
Upgrade Utilities Reference Manual
Issue the following command from %D3App%/Setup/Specific:
cvtSABL1230to1231 PCM0/SABL -d
This will create a new <SABLprogram>.seq for each SABL program in the directory and
rename the old file <SABLprogram>.seq.seq1230. The new <SABLprogram>.seq files can
then be used as the new SABL program to compile using SIC.
CVTSABL1230TO1231 Execution
cvtSABL1230to1231 command lines always include the command word ʺcvtSABL1230to1231ʺ and
the name of the SABL program or directory of SABL programs and a switch to say if this is a
program or a directory. Other arguments allow for prevention of a backup file, creation an error
file, and to turn on debugging.
format is:
cvtSABL1230to1231 <SABLprogram>.seq::<Directory> -d::-p [-b] [-e] [-g]
This will create a new <SABLprogram>.seq and rename the old file
<SABLprogram>.seq1230. The new <SABLprogram>.seq can then be used as the new SABL
program to compile using SIC.
Where:
cvtSABL1230to1231 is the program name
<SABLprogram>.seq is the name of the SABL program. This is used with the –p
switch.
<directory> is the path name of the entire directory containing SABL
programs to be converted. This is used with the –d switch.
‐p is a hyphen followed by ʺpʺ used for converting a single
SABL program
‐d is a hyphen followed by ʺdʺ used for converting all SABL
programs in an entire directory
‐b is a hyphen followed by ʺbʺ optionally used to prevent the
backup of the original file A backup is created by default.
‐e is a hyphen followed by ʺeʺ optionally used to save errors, if
they exist, to the file <SABLprogram>_1230seq.errors instead
of outputting them to the command window
‐g is a hyphen followed by ʺgʺ optionally used to turn on
debugging and record debugging files
RM1.0025.V12.3‐2A 40
Upgrade Utilities Reference Manual
H
How to Run PCM.DAT Conversion Tool ‐
Index CvtPcmDat 19
How to Run SABL Redundancy Conversion
Program (REMB) 7
A How to Run sitesetup.com Conversion Tool ‐
CvtSiteSetup 25
A Brief Description of the
D3SYSTEM_SETTINGS.dat Data File 24
I
A Brief Description of the sitesetup.com Data
File 23 ICS 3‐304.81 Safety Recommendations 3
A Description of the Intended Audience 1
D3SYSTEM_SETTINGS.DAT Data File 18 Introduction to PCM.DAT Conversion Tool ‐
A Description of the PCM_SETTINGS.dat CvtPcmDat 17
Data File 17 Introduction to sitesetup.com Conversion
Tool ‐ CvtSiteSetup 23
C
N
CNVT_Graphic 11
CNVT_Sub 13 Notification de Sécurité 3
Conversions Done by REMB 7
P
CVT101TO102 31
PCM.DAT Conversion Tool ‐ CvtPcmDat 17
CVT102TO11 33
Preface 1
CVT121TO122 37
Purpose of this Manual 1
CVT63TO70 9
CVT81TO90 15 R
CVTSABL1230TO1231 39
Recommandations de Sécurité ICS 3‐304.81 4
CVTSABL1230TO1231 Execution 40
Related Documentation 2
D
S
Directives de Sécurité 3
SABL Redundancy Conversion Utility ‐
REMB 7
E
Safety Guidelines 3
Example of Using REMB 7
Safety Notice 3
RM1.0025.V12.3‐2A 41
Upgrade Utilities Reference Manual
Sample D3SYSTEM_SETTINGS.dat File,
CDCM_SETTINGS.dat File, and Sample
Run Screen Shot 26
Samples of a PCM.dat File,
PCM_SETTINGS.dat File,
D3SYSTEM_SETTINGS.dat File, and
Sample Run Screen Shot 20
Sitesetup.com Conversion Tool ‐ CvtSiteSetup
23
Structure of this Document 1
Upgrade Utilities 5
Upgrade Utilities by version 5
Using CNVT_Graphic 11, 13
Using CVT101TO102 31
Using CVT102TO11 33
Using CVT121TO122 37
Using CVT63TO70 9
Using CVT81TO90 15
Using CVTSABL1230TO1231 39
Using VT10TO11CNVRT 35
VT10TO11CNVRT 35
RM1.0025.V12.3‐2A 42