Tsecurity Contents

Table of Contents 2

Document Revision History. 19

Introduction. 23

What the TSENTRY System Is 23

TSENTRY Documentation Overview. 23

TSENTRY WebHelp Sections 23

TS Control System WebHelp Sections 24

Major Components of the TSENTRY System.. 24

Example Host Hardware System Environment 25

Process Control Operating System Environment 26

Workstation Environment 26

Real-Time Extensions 26

Application Process Environment 26

User Interface. 27

Network Connectivity. 27

Additional Real-Time Computing Facilities 27

Remote Access to Control System.. 31

Technical Specifications 33

Overview. 33

Windows 2000 Process Scheduling. 33

Interrupts 33

Standard Windows 2000 Process Scheduling. 34

Real-Time Windows 2000 Process Scheduling. 35

Access to a Microsoft Windows 2000 System.. 37

FTP File Access 37

Sharing Drives and Directories 38

pcAnywhere. 38

Terminal Services 38

Data Dictionary. 38

Concepts 38

Building. 39

Management 39

C/C++ Libraries 39

Shared Memory Management 41

Real-time TCP/IP. 41

HMI Overview. 42

Real-time Trending. 42

Historical Trending. 43

Store and Forward Process Information. 43

VenturCom Published Real-Time Response Results 43

VenturCom Performance Evaluator 45

‘C’ Structure Template for ‘Standard Application’ 45

Major TelePro / SSE Control System Classes 46

TSENTRY Support and Problem Reporting Web Site. 54

TSENTRY Installation. 57

Hardware Installation Procedures 57

Windows 2000 Professional and Server Installation Procedure. 57

Installation of Internet Information Server 58

DCOM Configuration. 58

Windows 2000 Layered Software Installation Procedures 59

Miscellaneous Windows 2000 Setup. 59

Configuration for Win2K Terminal Services Operation. 60

Installation of Service Pack 4 for Windows 2000. 60

HAL Verification for Hard Realtime TSENTRY. 60

Installation of Microsoft Office 2000 Professional Edition. 62

Microsoft Visual Studio .NET 2003 Installation. 63

Installation of RTX 5.5 for Windows 2000. 65

Configure 3c905c card for use under the RT TCP/IP stack. 66

Installation of PC Anywhere 10.5. 67

Installation of Ghost 2001. 68

Installing the Platform SDK. 69

TSENTRY Installation. 69

Installing a New Tsentry Distribution. 69

Updating an existing Tsentry Distribution. 70

Create System Environment Variables 70

Installation of NtRtSvc service. 71

TSENTRY HMI Application Configuration. 72

GsmOpcSvr Installation. 76

Changing System Password. 79

Application Disk File and Directory Organization. 79

RTX File Manifest 84

RTX Runtime. 84

RTX SDK. 86

Standard Tasks 89

NtRtMgr 89

NtRtMgr Startup. 89

Stopping the NtRtMgr 93

NtRtSvc. 93

Installation of NtRtSvc Service. 93

Starting the NtRtSvc Service. 94

Stopping the NtRtSvc Service. 94

Displaying the current NtRtSvc command line. 94

Removing the NtRtSvc Service. 94

NtRtStop. 94

NtRtMtr 95

GsmOpcSvr 95

TrendMgr 95

TrendGsm.. 95

TrendSrv. 95

TrendTrig. 95

GsmExpSvr 95

GsmExpRcv. 95

GsmPifBld. 95

tpriNtRtAdmin. 96

Generating a New System.. 96

Generating a New Task. 97

Generating a New Screen. 98

tpriPublisher 98

Overview. 98

Operation. 99

Web Page Generation. 100

Command Line Interface. 100

Initialization File. 101

HMI Applications 105

Overview. 105

Configuration. 105

AppConfig. 105

Example Configuration Section. 108

Standard Screens 111

Login Screen. 111

NtRtMenu. 112

NtRtHmiSetup. 113

NtRtMgr 114

NtRtProcEd. 115

Probe Screens 117

Task Development Libraries 123

Functional Overview. 123

tpriProc – TSENTRY Process class 123

Overview. 123

Class Interface. 123

tpriGsm – Global shared memory (GSM) class 126

Overview. 126

Class Interface. 126

tpriGsmDDCom - GSM Data Dictionary Class 127

Overview. 127

Class Interface. 127

tpriLogMsg – Log Message Class 131

Overview. 131

Initialization Files 131

Log Message Calls 132

Global Structures 132

Global and Static Class Functions 132

Example Code. 135

tpriIniFile - Ini File Support Class 135

Overview. 135

Class Interface. 135

tpriTimer – Timer Support Functions 138

Overview. 138

Class Interface. 138

tpriUtil – Utility Support Functions 138

Overview. 138

Library Functions 138

tpriVop – Variable Operation Class 140

Overview. 140

Variable Operation Format 140

Public Constructors 141

Public Functions 141

tpriRps – Rules Processing Classes 144

Overview. 144

Classes 144

Task Development (VC.6) 147

TSENTRY Disk File and Directory Organization Standards 147

Starting a New Workspace. 147

Starting a New Visual C++ Task. 149

Cloning the Tsentry Standard Process Control Task. 150

HMI Screen Development 153

Overview. 153

Upgrade TPRI VB6 Screens to VB.NET. 153

Starting VB.NET Development Environment 153

Upgrade existing VB6 project using Microsoft Upgrade Tools 153

Clean up Directory and Correct Name of Files 153

References 154

Project Settings and Attributes 155

Remove/Change Code. 155

Replace TPRI Standard Controls 156

Name VB.NET User Screen (.NET assembly) 156

Control Array. 157

Remove Error-Causing Code. 158

UserControl_Initialize. 158

TPRI Base Screen. 159

Allow Partially-Trusted Caller (Internet Explorer) 160

Version. 160

Signing TPRI Screens 160

Miscellaneous Fixes 161

Control Properties Upgrade. 161

Other Common Upgrade Problems 162

Screen Development Libraries 163

Overview. 163

TPRI.BaseScreen. 163

Overview. 163

Operation. 163

Properties 163

Methods 163

Events 165

TPRI.BaseControl 166

Overview. 166

Operation. 166

Properties 166

Methods 166

Events 170

TPRI.TextBox. 171

Overview. 171

Operation. 171

Properties 171

Methods 172

Events 172

TPRI.Shape. 172

Overview. 172

Operation. 173

Properties 173

Methods 174

Events 174

TPRI.ActiveShape. 174

Overview. 174

Operation. 175

Properties 175

Methods 178

Events 178

TPRI.ActiveShapeArray. 178

Overview. 178

Properties 178

Methods 178

Events 179

TPRI.CmdButton. 179

Overview. 179

Operation. 179

Properties 180

Methods 180

Events 180

TPRI.CmdButtonArray. 180

Overview. 180

Properties 180

Methods 181

Events 181

TPRI.ToggleButton. 181

Overview. 181

Operation. 182

Properties 182

Methods 182

Events 183

TPRI.BarGraph. 183

Overview. 183

Operation. 184

Properties 185

Methods 186

Events 186

TPRI.CoverageBar 186

Overview. 186

Operation. 187

Properties 187

Methods 187

Events 188

TPRI.LogMsg. 188

Overview. 188

Operation. 189

Properties 189

Methods 189

Events 189

TPRI.ComboBox. 190

Overview. 190

Operation. 190

Properties 191

Methods 191

Events 192

TPRI.OpcMgr 193

Overview. 193

Operation. 193

Properties 193

Methods 194

Events 196

TPRI.OpcCom.. 198

Overview. 198

Operation. 198

Properties 198

Methods 198

Events 198

TPRI.DataSetInfo. 198

Overview. 198

Operation. 198

Properties 199

Methods 199

Events 201

TPRI.DDVarSelect 202

Overview. 202

Operation. 202

Properties 202

Methods 202

Events 202

TPRI.DataDict 203

Overview. 203

Operation. 203

Properties 205

Methods 205

Events 206

TPRI.HMI.Controls.TrendCtrl 206

Overview. 206

Operation. 207

Properties 210

Methods 211

Events 211

TPRI.TrendCtrl Variable Insert/Delete Form.. 212

Deleting Variables 213

Inserting Variables 214

TPRI.TrendPlayback. 217

Overview. 217

Operation. 217

Properties 219

Methods 219

Events 219

TPRI.HMI.Controls.TrendSetLoader 220

Overview. 220

Operation. 220

Properties 221

Methods 221

Events 222

TPRI.TrendSrcSelect 223

Overview. 223

Operation. 223

Properties 224

Methods 224

Events 224

TPRI.TrendCom.. 225

Overview. 225

Operation. 225

Properties 225

Methods 226

Events 226

TPRI.TriggerEd. 226

Overview. 226

Operation. 227

Properties 228

Methods 228

Events 228

TPRI.TriggerStat 228

Overview. 228

Operation. 229

Properties 229

Methods 229

Events 229

TPRI.RpsEditor 229

Overview. 229

Operation. 230

Properties 234

Methods 234

Events 235

VB Screen Building (VB.6) 237

Overview. 237

Naming Conventions 237

Building a Basic Screen. 238

Starting a New Screen. 238

Adding Labels to the Form.. 239

Saving the Project 239

Testing the Page. 239

Publishing Pages 239

Helpful Hints 240

Adding TelePro’s Standard Controls to a Visual Basic Web Screen. 241

Adding a Text Box. 241

Adding an Active Shape. 241

Adding a Link Button. 246

Adding a Toggle Button. 246

Adding a Bar Graph. 247

Adding a Coverage Bar Graph. 250

Adding a Trend Graph. 251

Adding a Log Message Display. 253

Error Handling. 254

VB Runtime Errors 255

Adding Property Pages to the ActiveX Control 261

Appendix. 261

Variable Scope Prefixes 261

Variable Data Types 262

Prefixes for Controls 262

Prefixes for Data Access Objects (DAO) 264

Suggested Prefixes for Menus 265

Tsecurity. 266

Overview. 266

Tsecurity Fundamentals 266

Overview. 266

User Authentication. 266

User Authentication Flow Chart 267

Tsecurity Applications 269

Securing Software. 270

Managing Tsecurity Applications 270

Security Access Keys 271

Evaluating User SAKs 271

Evaluating User SAKs Flow Chart 273

Installation. 275

Overview. 275

Special Considerations 275

Installed Files and Folders 276

Tsecurity Service. 276

Registry Changes 276

Application Security Configuration Files 276

Overview. 276

File Format 276

Example ASCF. 277

Tsecurity Service. 278

Overview. 278

Configuration. 279

Sample Tsecurity.exe.config File. 279

TsecurityCfg. 281

Overview. 281

User Interface. 281

System Parameters 281

Timing Parameters 282

Domains 283

Browse Users 285

Tsecurity Administrators 286

ASCFEditor 287

Overview. 287

Login Screen. 287

ASCF Editor Screen. 288

Creating an Example Tsecurity Application. 297

Tsecurity Clients 301

Overview. 301

Client Architecture. 301

Example Clients 302

Procedures 303

System Startup. 303

Microsoft 2000 Startup (Boot) 303

Application Startup. 303

System Shutdown. 304

Application Shutdown. 304

Microsoft 2000 Shutdown. 304

System Backup and Failure Recovery. 305

Overview. 305

Procedures 307

Cloning the Hard Disk to a Second Hard Drive. 307

Backup Disk to an Image on the File Server 308

Restoring a Disk from a File Server Image. 309

Make a CD of the Application Code and Files 310

Backup or Restore Using DVD Burner 310

Restart User Interface Server 314

Using Ghost to Copy Hard Drives 314

Creating a Ghost image and Saving it over a Network. 315

Create a Custom Virtual Web Application for TSentry HMI Web Pages 315

Trend System.. 317

Overview. 317

Real-time vs. Historical Trending. 317

Processes 317

Screens 318

Historical Trend Triggers 318

Trigger File Format 319

Tasks 319

TrendMgr - Trend Manager Process 319

TrendGsm - Trend Global Shared Memory Process 321

TrendSrv - Trend Server Process 322

TrendTrig - Trend Trigger Process 323

Screens 323

TrendX. 323

TriggerMgr 327

TrendFileMgr 330

Client Operation. 331

Trend Communications Control Operation. 331

Notes 332

Trend Data Client - Server Protocol 332

Overview. 332

Trend Data Request Format 332

Data Response Format 334

Trend Class Definitions 335

TSENTRY Rules Processing System.. 337

Rule Specifications 337

Default Rule Parameters 337

Criteria. 338

Actions 339

File Format 340

Class Libraries - Rules Processing System API 340

Rules Manager Process 340

Overview. 340

Configuration. 341

Rules Processing System User Interface. 341

Overview. 341

I/O Drivers 343

Allen-Bradley Process I/O Driver 343

Capabilities 343

Allen-Bradley PLC2/3/5 Configuration. 343

Software Driver 344

tpriABPlc Class Descriptions 344

Process Driver Mainline. 346

National Instruments Process I/O Driver 346

Capabilities 346

RTP (CPI) Process I/O Driver 346

Capabilities 346

Software Driver 347

RTP 6700 Configuration. 348

RTP Initialization file. 350

Process Driver Mainline. 356

GE 9030/9070 PLC Driver 357

Capabilities 357

GE Configuration. 357

Software Driver 357

GEPLC Class Descriptions 358

Process Driver Mainline. 359

TCP/IP Driver - tpriRdcTcp. 360

Overview. 360

Socket Initialization. 360

Static Class Functions 360

Lantronix Terminal Server Driver - tpriRdcLts 362

Overview. 362

Static Class Functions 362

Example Lantronix Terminal Server Driver 362

Lantronix Cobox Terminal Server Driver - tpriRdcCbx. 366

Generalized Remote Device Connection Driver 367

Interface-Specific Classes 367

State Machine Flow. 368

Class Data Members 369

Class Virtual Functions 370

Class Helper Functions 372

Example Lantronix Terminal Server RDC Driver 373

Allen Bradley Control Logix PLC Driver 373

Capabilities 373

A-B Configuration. 373

Software Driver 374

CLeip Class Description. 374

Process Driver Mainline. 379

Modicon PLC Driver 379

Capabilities 379

Modicon PLC Configuration. 380

Software Driver 380

tpriModPlc Class Descriptions 381

Process Driver Mainline. 382

VMIC Reflective Memory Driver 383

Capabilities 383

VMIC Card Configuration. 383

Configuration File. 383

Class Interface. 385

Process Driver Mainline. 385

Data Dictionary. 387

Data Dictionary Form.. 387

Overview. 387

Operation. 388

Data Dictionary Files 390

Building the Dictionary. 391

Application Program Interface. 391

Create. 391

mapGsm.. 391

Destroy. 392

saveAllPersist 392

Maintenance. 392

File Format 392

sys.ini 392

sysGsm.h. 392

sysVars.ini 393

sysStruct.ini 395

GsmPifBld Exceptions 395

Data Transfer 397

Overview. 397

GsmExpSvr– Global Shared Memory Export Server 397

GsmExpRcv– Global Shared Memory Export Receiver 398

Communications Protocol 398

Workstation Configuration. 401

Overview. 401

Windows Configuration. 401

Installation of Service Pack 2 for Windows 2000. 401

Installation of Microsoft .NET Framework v1.1. 401

DCOM Configuration on Windows 2000. 401

DCOM Configuration on Windows XP/2003. 402

Internet Explorer Configuration. 402

Options 405

Resources 407

Thin Client 409

Overview. 409

Windows 2000 Server Configuration. 409

Installation Instructions for Terminal Services Licensing. 409

To Re-build the Reference Server 409

License Server Activation. 409

TSENTRY Messages 411

Process Abort Traceback Message. 412

© 2022 TelePro, Inc.
3811 Illinois Avenue, Suite 100, St. Charles, IL 60174