Sunteți pe pagina 1din 46

 

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   

S-ar putea să vă placă și