Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust...

53
Profit Toolkit User’s Guide Rev 2.0 5/01 AP11-401

Transcript of Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust...

Page 1: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Profit ToolkitUser’s Guide

Rev 2.05/01

AP11-401

Page 2: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment
Page 3: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

AP11-401

Profit ToolkitUser's Guide

Rev 2.05/01

Page 4: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

ii Profit Toolkit User's Guide 5/01Honeywell Inc.

Copyright, Notices, and Trademarks

Copyright 2001 by Honeywell International Inc.

While this information is presented in good faith and believed to be accurate, Honeywelldisclaims the implied warranties of merchantability and fitness for a particular purpose andmakes no express warranties except as may be stated in its written agreement with and for

its customer.In no event is Honeywell liable to anyone for any indirect, special or consequential

damages. The information and specifications in this document are subject to change withoutnotice.

Profit, TDC 3000, and TotalPlant are registered trademarks of Honeywell International Inc.

Other product names are trademarks of their respective owners.

HoneywellIndustrial Automation and Control

16404 N. Black Canyon HwyPhoenix, AZ 85053

Page 5: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

5/01 Profit Toolkit User's Guide iiiHoneywell Inc.

Table of ContentsTABLE OF CONTENTS ...........................................................................................................III

ABOUT THIS PUBLICATION.................................................................................................. VIStatement of Work .................................................................................................... viRelease Information .................................................................................................. viAcronym List.............................................................................................................. viWriting Conventions Used in This Book ................................................................... vii

REFERENCES....................................................................................................................... VIIIDocumentation .........................................................................................................viiiOpen.........................................................................................................................viiiTPS System..............................................................................................................viiiEmbedded Uniformance...........................................................................................viii

FOR TECHNICAL ASSISTANCE............................................................................................ IXIf You Need Assistance ............................................................................................. ixInternational Customers ............................................................................................ ixCustomers Inside the United States.......................................................................... ixArizona Customers .................................................................................................... ixServices Provided...................................................................................................... ixTime Saving Tip......................................................................................................... ix

SECTION 1 — GETTING STARTED WITH PROFIT VIEWER.................................................1

1.1 Getting Started ............................................................................................................1Read This ...................................................................................................................1

1.2 Logon ..........................................................................................................................2Default Logon ID.........................................................................................................2First Time Set-up........................................................................................................2View Only Button (No Logon ID or Password Needed) ..............................................2

1.3 Overview......................................................................................................................3Buttons .......................................................................................................................3Controller Bar Described ............................................................................................3Application Detail Button.............................................................................................3Controller Modes Buttons ...........................................................................................3Applications Menu Button...........................................................................................3Display Options...........................................................................................................3Status Messages Button.............................................................................................4Display Buttons...........................................................................................................4

1.4 OPTIONS ....................................................................................................................5Overview.....................................................................................................................5

1.5 OPTIONS – RMPCT Parameter Security ...................................................................6RMPCT Parameter Security.......................................................................................6Parameter Security Display ........................................................................................6Changing Security Levels ...........................................................................................6

Page 6: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Table of Contents

iv Profit Toolkit User's Guide 5/01Honeywell Inc.

1.6 OPTIONS – Profit Viewer Logon ID Security.............................................................. 7Logon ID Security Display.......................................................................................... 7Adding New Users ..................................................................................................... 7Deleting Users............................................................................................................ 8Modifying Users ......................................................................................................... 8

1.7 OPTIONS – Profit Viewer Startup Options ................................................................. 9Profit Viewer Startup Options Display ........................................................................ 9Profit Viewer Security Database Location.................................................................. 9Administrator Inactivity Stepdown ............................................................................ 10Operations Options .................................................................................................. 10

1.8 Working with the Applications Menu......................................................................... 11In this Section........................................................................................................... 11

1.9 Applications Menu – Profit Viewer Applications........................................................ 12Description ............................................................................................................... 12Selecting an Application........................................................................................... 13Add Local Applications............................................................................................. 13Add Remote Application Display.............................................................................. 13Refresh .................................................................................................................... 14

1.10 Applications Menu – Application Operations .......................................................... 15Description ............................................................................................................... 15To View An Application ............................................................................................ 16To Switch Views To Another Application ................................................................. 16

1.11 Applications Menu – Plant Workspace ................................................................... 17Description ............................................................................................................... 17Adding An Application To Plant Workspace ............................................................ 17Deleting An Application From Plant Workspace ...................................................... 18Viewing An Application From Plant Workspace....................................................... 18

1.12 How to Read the Profit Viewer Displays ................................................................. 19Labels, Fields and Buttons....................................................................................... 19

SECTION 2 — USING PROFIT TOOLKIT ............................................................................. 21

2.1 Profit Toolkit Application Displays ......................................................................... 211. Function I/O Display............................................................................................. 222. Toolkit Detail Display............................................................................................ 233. Status Message Display....................................................................................... 24

SECTION 3 — DISPLAYING & RESPONDING TO MESSAGES.......................................... 27

3.1 Overview................................................................................................................ 27Generated Messages............................................................................................... 27Help and Error On-Input........................................................................................... 27Software Messages ................................................................................................. 27Sample Status Messages Display............................................................................ 27Using the Display ..................................................................................................... 27

SECTION 4 - PROFIT TOOLKIT FUNCTIONS .................................................................... 29

Page 7: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Table of Contents

5/01 Profit Toolkit User's Guide vHoneywell Inc.

4.1 Overview....................................................................................................................29Functions can be Run in Design and Run-Time Environments................................29Profit Toolkit Functions Interface with a Wide Variety of Environments...................29Configuring a Profit Toolkit for Run-Time.................................................................29Profit Toolkit Applications that Can be Purchased ...................................................29

4.2 What Really Happens when a Toolkit Starts Up ........................................................30How Configuration and CheckPoint File are Used When a Toolkit Starts Up..........30How DSS Servers Input and Output Data to/from Toolkits ......................................30

4.3 Toolkit Configuration (CFG) File ................................................................................31Making Changes to the Toolkit Configuration (CFG) File.........................................31

4.4 Toolkit Checkpoint (CPT) File ....................................................................................32Why to Delete a CheckPoint File..............................................................................32

4.5 Toolkit Function Execution .........................................................................................33Before/After/Both Execution .....................................................................................33Controlling Toolkit Execution using the Execute Parameter ....................................33Function Execution Order.........................................................................................33

4.6 Toolkit Function Looping ............................................................................................34Toolkit Function Looping ..........................................................................................34Simple Looping.........................................................................................................34Loop Start and End Indices ......................................................................................34Loop Current Index...................................................................................................34Nested Looping ........................................................................................................34

4.7 Toolkit Function Messages ........................................................................................35Messaging – Via RetMessage Parameter................................................................35Return to Normal Messages.....................................................................................35Number of Simultaneous Messages Raised ............................................................35

4.8 Terminating a Profit Toolkit Application......................................................................36Why a User Needs to Terminate a Profit Toolkit Application ...................................36How to Terminate a Profit Toolkit Application ..........................................................36Detailed Description – How to Terminate a Profit Toolkit Process...........................36If you are Unable to Terminate the Process.............................................................38

INDEX ......................................................................................................................................39

Page 8: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

vi Profit Toolkit User's Guide 5/01Honeywell Inc.

About This Publication

Statement of Work The following table describes the audience, purpose, and scope of this book:

Purpose This document is intended for users who want to become familiar to theProfit Viewer graphical interface with the Toolkit functions

Audience Process and control engineers

ReleaseInformation

This is document version 2.0 for use with Profit Controller software release 200.00.This book cannot be used for earlier releases. For Profit Controller releases after160.00 see the Release Notes.

Acronym List Acronym Term

AM Application Module

DCS Distributed Control System

LCN Local Control Network

US Universal Station

PV Process variable

MV Manipulated variable

RMPCT Robust Multivariable Predictive Control Technology

PL Parameter List

CDS Custom data segment

AO CL object code file extension

Page 9: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

About this Publication

5/01 Profit Toolkit User's Guide viiHoneywell Inc.

WritingConventions Usedin This Book

The following writing conventions have been used throughout this book and otherbooks in the Profit Suite library.

• Words in double quotation marks " " name sections or subsections in thispublication.

• Words in italics name book titles, add grammatical emphasis, introducewords that are being referenced or defined, or represent mathematicalvariables. The context makes the meaning and use clear.

• Words in bold type indicate paragraph topics or bring important phrases toyour attention.

• Shading brings paragraphs and table entries to your attention.

• Windows pull down menus and their options are separated by an anglebracket >. For example, Under Settings> Communications, set the baud rate.

• Messages and information that you type appear in Courier font.

• Acronyms, Scan parameters, point names, file names, and paths appear inUPPERCASE. The context makes the meaning and use clear.

• Command keys appear in UPPERCASE within angle brackets. For example,press <ENTER>.

• TPS user station touch-screen targets appear in rounded boxes. For example,touch MODIFY NODE .

• Graphic buttons appear in UPPERCASE within brackets [ ]. For example,touch [TAG].

• Point-dot-parameter means a point name and one of its parameters. Forexample, point-dot-SP means the SP parameter for the point.

• Zero as a value and when there is a chance for confusion with the letter O isgiven as Ø. In all other cases, zero as a numerical place holder is given as 0.For example, 1.0, 10, 101, CVØ1, parameter PØ.

• The terms screen and display are used inter changeably in discussing thegraphical interfaces. The verbs display a screen and call a screen are also usedinter changeably.

• These names, and may be used interchangeably.

Former Name Product Name

RMPCT Profit Controller

DQP Profit Optimizer

APC Development Environment or APCDE Profit Design Studio

RPID Profit PID

Page 10: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

viii Profit Toolkit User's Guide 5/01

Honeywell Inc.

References

The following comprise the Profit Suite library.Documentation Title Number

General

Profit Controller (RMPCT) Concepts Reference RM09-400Profit Controller (RMPCT) Designer’s Guide (Off-Line Design) RM11-410Profit Optimizer Designer’s Guide (Off-Line Design) PR11-400Profit Toolkit Designer’s Guide AP11-400APC Identifier User’s Guide AP09-200Profit-PID (RPID) RM11-100Profit Sensor User’s Guide PS09-100

Open

Profit Suite Installation Guide for Open SystemsViewer - Controller - Optimizer - Toolkit

RM20-501

Profit Controller (RMPCT) User’s Guide for Open Systems RM11-401Profit Optimizer User’s Guide for Open Systems PR11-421Profit Trender User’s Guide RM11 431Profit Toolkit User’s Guide for Open Systems AP11-401Profit Toolkit Function Reference AP11-410FCCU Toolkit User’s Guide for Open Systems AP13-201Fractionator Toolkit User’s Guide for Open Systems AP13-101Lab Update User’s Guide AP13-111Wrapper Builder User’s Guide AP11-411Profit Bridge User’s Guide AP20-401

TPS System

Profit Controller (RMPCT) Installation Reference for AM, AxM and Open LCN-Side RM20-400Profit Controller (RMPCT) Commissioning RM20-410Profit Controller (RMPCT) User’s Guide for AM, AxM and Open LCN-Side RM11-400Profit Optimizer Installation Reference for AM and Open LCN-Side PR20-400Profit Optimizer User’s Guide for AM and Open LCN-Side PR11-420Profit Suite ToolKit AP09-300TDC Data ConverterData CollectorStep Test Builder

Performance MonitorRMPCT CascadePV Validation

Simulation BackBuilderGain Scheduler

Fractionator Toolkit (LCN) AP13-100FCCU Toolkit (LCN) AP13-200Furnace Pass Balance Temperature Control User’s Guide AP13-600Non-Linear Level Control User’s Guide AP09-700

Embedded Uniformance

Excel Companion User’s Guide (Profit Embedded PHD) AP20-510Power Point Companion User’s Guide (Profit Embedded PHD) AP20-520Process Trend User’s Guide (Profit Embedded PHD) AP20-530

Page 11: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

5/01 Profit Toolkit User's Guide ix

Honeywell Inc.

For Technical Assistance

If You NeedAssistance

If you need technical assistance, contact your local Honeywell ServiceOrganization, as explained in the following paragraphs.

InternationalCustomers

Outside of the United States, contact your local Honeywell Service Organization.If you are not sure of the location or telephone number, call your Honeywellrepresentative for information.

Customers Insidethe United States

Within the United States, call the Technical Assistance Center (TAC) at the tollfree number 1-800-822-7673.

ArizonaCustomers

Within Arizona, the local number for TAC is 602-313-5558.

Services Provided Calls to TAC are answered by a dispatcher from 7:00 A.M. to 5:00 P.M.,Mountain Standard Time (6:00 A.M. to 4:00 P.M. when daylight savings time is ineffect).

Outside of these hours, emergency calls—those that affect your ability to controlor view a process—will be received by an answering service, and returned withinone hour. TAC maintains its own TPS network, and frequently can duplicateproblems on this equipment.

Time Saving Tip It is a good idea to make specific notes about the problem before making the call.This helps to reduce delays and expedite answers.

Page 12: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment
Page 13: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

5/01 Profit Toolkit User's Guide 1

Honeywell Inc.

Section 1 — Getting Started with Profit Viewer

1.1 Getting StartedRead This This section describes Profit® Viewer’s Administrative functions. Profit Viewer is

used to view Profit Optimizer, Profit Controller and Profit Toolkit.

Installation information for all of these Profit products can be found in the ProfitSuite Installation Guide for Open Systems.

Read this section to find out how to:

• Start Profit Viewer and logon,

• Establish / change new User Names, Logon Ids and Passwords,

• Establish / change the security levels of Users,

• Change the Startup Options,

• Establish / change the location of the security Database,

• Establish / change the Administrator security stepdown time,

• Allow / disallow multiple instances of Profit Viewer,

• Toggle viewing of OPC database error messages (default - OFF).

Page 14: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.2 Logon

2 Profit Toolkit User's Guide 5/01Honeywell Inc.

1.2 LogonDefault Logon ID When Profit Viewer is started, the following display will appear:

First Time Set-up The first time Profit Viewer is run, the logon ID and password are both set asADMIN . Type this into both boxes when prompted. Once the administrator hasentered and set new passwords, it is advised to change the password for this“ADMIN” logon ID. See Section 1.6, Logon ID Security.

View Only Button(No Logon ID orPasswordNeeded)

Select this button to view applications in Profit Viewer. The Viewer is notpermitted to make any changes to the application.

Page 15: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.3 Overview

5/01 Profit Toolkit User's Guide 3Honeywell Inc.

1.3 OverviewButtons Buttons on a Profit Optimizer Operator display are shown below. The function of

each button is defined in more detail later.

Controller BarDescribed

Of the three rows of buttons, the top row is referred to as the Controller Bar, andcontains the Controller (or Optimizer) Detail button, the controller mode buttons toplace the controller or optimizer in an ON, OFF or WARM state, the ApplicationsMenu, the Options button, and a button for Status Messages.

ApplicationDetail Button

The Controller (or Optimizer) Detail button will display the Detail for the currentlyselected process application.

To display information about a different controller, return to the Profit ViewerApplications window by clicking [APP MENU]. Select another controller byclicking on the controller. This controller selection then becomes your currentcontroller. Any viewable Profit Controller display then shows information aboutthis controller.

ControllerModes Buttons

The controller mode establishes the control action of the controller, and are used toplace the controller or optimizer in an ON, OFF or WARM state, set through therelated buttons. The button with cyan color indicates the current controller mode.When a button is yellow it is pending a change.

ApplicationsMenu Button

The APP MENU button displays a list of the controllers/optimizers that arerunning, allows you to add/remove controllers/optimizers, and allows you toconnect to/disconnect from controllers/optimizers.

Display Options There are various options that govern the administration and operational behaviorof the overall Profit Viewer application.

When logged in as a Profit Viewer administrator, these options can be accessed byclicking [OPTIONS].

The options are divided into three categories: RMPCT Parameter Security, ProfitViewer Logon ID Security and Profit Viewer Startup Options.

Page 16: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.3 Overview

4 Profit Toolkit User's Guide 5/01Honeywell Inc.

RMPCT Parameter Security is distinct to Profit Controller applications and governsthe security access granted to six specific RMPCT parameters.

The Profit Viewer Logon ID Security displays provide the methods for adding,modifying and removing access to Profit Viewer applications (e.g., ProfitController, Profit Optimizer and Profit Toolkit).

The Profit Viewer Startup Options give the administrator the ability to set and/orselect various Profit Viewer operational options.

StatusMessagesButton

The STATUS MSGS button provides a list of the application’s past and presentstatus or condition, and will indicate the cause of a software or optimizerapplication error.

Display Buttons Below the top row of buttons on the Profit Optimizer Operator display are twomore rows of buttons, referred to as the display buttons. These buttons allow you tooptimize the controller’s CVs and MVs, and provides access to

• summaries regarding the controller’s CVs, MVs, and RMPCT,

• details regarding the controller’s CVs, MVs, BOs, CCs, and DVs

• Bridge Output summary and detailed displays, and

• Combined Constraint Details.

More detailed information can be found on each of these buttons throughout thisdocument. Refer to the index for the location of information on any particularDisplay button.

Page 17: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.4 OPTIONS

5/01 Profit Toolkit User's Guide 5Honeywell Inc.

1.4 OPTIONSOverview There are various options that govern the administration and operational behavior

of the overall Profit Viewer application. These options can be accessed by clicking[OPTIONS] only when a Profit Viewer administrator is logged in.

The options are divided into three categories: RMPCT Parameter Security, ProfitViewer Logon ID Security and Profit Viewer Startup Options.

RMPCT Parameter Security is distinct to Profit Controller applications and governsthe security access granted to six specific RMPCT parameters.

The Profit Viewer Logon ID Security displays provide the methods for adding,modifying and removing access to Profit Viewer applications (e.g., ProfitController, Profit Optimizer and Profit Toolkit).

The Profit Viewer Startup Options allow the administrator the ability to set and/orselect various Profit Viewer operational options.

Page 18: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.5 OPTIONS – RMPCT Parameter Security

6 Profit Toolkit User's Guide 5/01Honeywell Inc.

1.5 OPTIONS – RMPCT Parameter SecurityRMPCT ParameterSecurity

The RMPCT Parameter Security display is found by clicking [OPTIONS] andthen clicking on the RMPCT Parameter Security tab.

RMPCT Parameter Security displays the Parameter Description and itsestablished Security Level. This display allows the administrator to specify acustom security access level for the six specific RMPCT parameters shown belowalong with their default Security Levels. Since this an example, your display mayshow different information about the current security levels.

ParameterSecurity Display

Changing SecurityLevels

Click on the Security Level associated with a specific parameter to view a popupwindow of allowable Security Levels. When a new Security Level is selected itimmediately becomes operative and is automatically saved as the new SecurityLevel for its associated parameter.

Page 19: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.6 OPTIONS – Profit Viewer Logon ID Security

5/01 Profit Toolkit User's Guide 7Honeywell Inc.

1.6 OPTIONS – Profit Viewer Logon ID SecurityLogon ID SecurityDisplay

The main Profit Viewer Logon ID Security display is found by clicking[OPTIONS] and then clicking on the Profit Viewer Logon ID Security tab.

Adding New Users To add a new user, click [Add], which will bring up the following display. Youmust fill in all the available fields. All typed characters will automatically beconverted to upper case text. The User Name field is the information that will bepresented in the Current Users window. The Logon ID is what will be used whenlogging into Profit Viewer. The Security Level field will present for selection theallowable user Security Levels. Type the same password into both the Passwordand Password (Match) fields. When all of the fields are complete, click [Execute]to save your information and return to the main Profit Viewer Logon display.

Page 20: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.6 OPTIONS – Profit Viewer Logon ID Security

8 Profit Toolkit User's Guide 5/01Honeywell Inc.

Deleting Users Select the User Name from the Current Users windows for which you want todelete Profit Viewer access, then click [Delete]. A message box will appearpresenting the user name about to be deleted. Click [Yes] to confirm.

Modifying Users Once a user has been added, it is possible to directly modify every field exceptUser Name. So, to modify a user name, select the User Name you want to modifyfrom the Current User window.

A window will appear allowing you to change the Logon ID and/or the SecurityLevel for this user. Note: Each time a user name is modified, the administrator isrequired to re-enter the Password and Password [Match] fields. The passwordmay be the current password or a new one. The current password will not bedisplayed.

Page 21: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.7 OPTIONS – Profit Viewer Startup Options

5/01 Profit Toolkit User's Guide 9Honeywell Inc.

1.7 OPTIONS – Profit Viewer Startup OptionsProfit ViewerStartup OptionsDisplay

The Profit Viewer Startup Options display is found by clicking [OPTIONS] andthen clicking on the Profit Viewer Startup Options tab.

Profit ViewerSecurity DatabaseLocation

RMPCT.MDB is an access database that holds Profit Viewer Logon ID SecurityInformation. Each installation of Profit Viewer will place a copy of theRMPCT.MDB in the \Program Files\Honeywell\HiSpec Solutions\Profit Viewerdirectory on the local drive where Profit Viewer was installed.

There are two ways this file can be used. One where each installation of ProfitViewer maintains its own security information and one where all or a group ofinstallations of Profit Viewer use the same security information.

In the case where each installation maintains its own security information, theadministrator creates users with access security levels specific to that installationof Profit Viewer. This is the program default.

In the case where all or a group of installations use the same security information,the administrator sets up the security information that desired for a group of ProfitViewer installations. The administrator copies that RMPCT.MDB to a networkdrive which all installations of Profit Viewer in the group have access to view.

Then the administrator uses the [CHANGE] command at each installation ofProfit Viewer to point the Profit Viewer Security Database Location to thenetwork location. This way all Profit Viewer installations in the group share thesame security information.

Page 22: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.7 OPTIONS – Profit Viewer Startup Options

10 Profit Toolkit User's Guide 5/01Honeywell Inc.

AdministratorInactivityStepdown

Should the administrator be at an easily accessible workstation, it may be desiredto use this option which “stepsdown” the security level from Administrator toView Only if the workstation has been idle for longer than the chosen number ofminutes. Should the administrator step away from the workstation, the timeframeis limited whereby any non-administrator would have the ability to change ProfitViewer options or engineer defined operating parameters.

Setting this option to 0 minutes disables Administrator Inactivity Stepdown sothey will not occur.

OperationsOptions Checkbox Function Default

Allow More Than OneProfit Viewer To BeRunning At One Time

If checked, this option allows more than one Profit Viewer tobe running at one time. The default value is “checked”.

Checked

Display OPC DataAccess Error Message

If checked, this option allows Profit Viewer to displayadditional OPC Error Messages. This option should only bechecked at the request of Honeywell TAC employees andshould not be checked during normal Profit Vieweroperations. The default value is “not checked”.

Notchecked

Display Interval Count If checked, this option will cause the Interval Count (thenumber of executions for this application since its activation)to appear in the Honeywell Profit Viewer title bar. Thedefault value is “not checked”.

Notchecked

Page 23: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.8 Working with the Applications Menu

5/01 Profit Toolkit User's Guide 11Honeywell Inc.

1.8 Working with the Applications MenuIn this Section The Profit Viewer Applications Menu is the top-level display. To view the

Applications Menu display, click [APP MENU].

Use the Applications Menu to:

Add or Remove Local and Remote Registered Applications

Connect to Applications

Create a Plant Workspace

Profit Viewer can display information for only one application at a time. TheProfit Viewer menu buttons only display information for the application whosename appears in the Honeywell Profit Viewer title bar.

To display information about an application, you must first select it from theApplications Menu display. To display information about a different application,you must return to the Applications Menu and select a different application fromthe list.

After logging into Profit Viewer, the Applications Menu will appear.

Page 24: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.9 Applications Menu – Profit Viewer Applications

12 Profit Toolkit User's Guide 5/01Honeywell Inc.

1.9 Applications Menu – Profit Viewer ApplicationsDescription The Profit Viewer Applications window on the left side of the display allows an

operator to navigate in a tree structure, similar to Windows Explorer throughcategorized applications organized by computer name.

Every action taken in the Profit Viewer Applications Menu is done with asingle click of the mouse.

The Profit Viewer Applications window:

Automatically displays all applications that have been registered using ServerRegistrar at the same computer where Profit Viewer is installed.

Allows the engineer to add to this window those applications that wereregistered using Server Registrar at another computer.

The Profit Viewer Applications window does not automatically display allapplications that have been registered throughout your network using ServerRegistrar.

In the Profit Viewer Applications window, to view the applications located on acomputer, click on the computer name’s [+] (in our example above, the computername is LOCAL). Three folders will appear: Profit Controllers, Profit Optimizersand Profit Toolkits.

Page 25: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.9 Applications Menu – Profit Viewer Applications

5/01 Profit Toolkit User's Guide 13Honeywell Inc.

Selecting anApplication

If an application exists in one of the folders you will see a [+] next to that folder.Expand the folder that contains that application you want to view. Click once on thename of the application you want to view. This will place an icon in the ApplicationOperations window. (See Applications Menu – Application Operations for what todo next).

This completes the steps to select an application from the Profit ViewerApplications window.

Add LocalApplications

Click on the Program Operations’ down arrow, choose “Add Profit Viewer LocalApplication (Server Registrar),” and click [GO]. This will launch the ServerRegistrar, a utility program explained in Appendix D of the Profit Suite InstallationGuide.

Add RemoteApplicationDisplay

From the Program Operations dropdown list, choose “Add Profit Viewer RemoteApplication” to add a remote application. Click [GO]. The following dialog boxwill appear.

The “Select/Type The Name Of The Computer Where The Application Runs” fieldbox will automatically be populated with a list of all computers which reside on thesame network domain where Profit Viewer is running.

Page 26: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.9 Applications Menu – Profit Viewer Applications

14 Profit Toolkit User's Guide 5/01Honeywell Inc.

Select a computer name from this list or you may type in the name of the computer(no matter which domain it resides) into the field.

Click [Get Apps] to populate the “Select An Application” field with the names ofthe applications that have been registered on that computer. This may take a littletime and is completed when the “Select An Application” field automatically popsup a list of applications.

If no applications are registered on the computer you selected, the followingmessage will be displayed (where WI-AZ15-D7YSPF would be the name of thecomputer):

Select the application you want to add to the Profit Viewer Applications windowand click [Add]. You may repeat this step for as many applications that appear inthe “Select An Application” field.

Click [Close] to cancel an operation at any time or to close the window after one ormore successfully completed additions.

Refresh Choose ‘Refresh Profit Viewer Applications Menu’ from the popup menu to causethe Profit Viewer Application window to rebuild and collapse.

If, for instance, you have more than one instance of Profit Viewer running on asingle computer, you may have modified the Profit Viewer Applications window inone of the Profit Viewer programs. To get the other Profit Viewer program toreflect the Profit Viewer Application window modifications, you would choose‘Refresh Profit Viewer Applications Menu’ from the popup menu.

Page 27: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.10 Applications Menu – Application Operations

5/01 Profit Toolkit User's Guide 15Honeywell Inc.

1.10 Applications Menu – Application OperationsDescription The Application Operations portion of the Applications Menu displays the

programs that are available to be executed for the currently selected application.

Profit Viewer currently supports viewing a Profit Controller, Profit Optimizer orProfit Toolkit application. The Process Display Icon is not currently operational,however, is present to support future versions of the Profit Viewer product.

The Application Operations window is where you request to view an application.

Page 28: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.10 Applications Menu – Application Operations

16 Profit Toolkit User's Guide 5/01Honeywell Inc.

To View AnApplication

From the Application Operations window, click once on the name of theapplication you want to view.

If you are already connected to the application, it will take you directly to thatapplication.

If you are not already connected to the requested application, the followingmessage will appear (where CRUD_OPT is the name of the chosen application):

Click [Yes] to view the application.

To Switch ViewsTo AnotherApplication

From the Application Operations window, click once on the name of theapplication you want to start viewing. The view of the previous application willautomatically close.

If you are already connected to the application, it will take you directly to therequested application.

If you are not already connected to the requested application, the followingmessage will appear (where CDU1_CTL is the name of the newly requestedapplication):

Click [Yes] to start viewing the requested application.

Page 29: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.11 Applications Menu – Plant Workspace

5/01 Profit Toolkit User's Guide 17Honeywell Inc.

1.11 Applications Menu – Plant WorkspaceDescription The Plant Workspace window of the Applications Menu was designed for

operators to have at their fingertips a listing of applications grouped in any wayfeasible (e.g., applications commonly viewed, plant layout, etc.).

Plant Workspace window will display up to 50 applications.

Once displayed in the Plant Workspace window, applications can be viewedwithout first having to locate the application in the Profit Viewer Applicationswindow, selecting it and then selecting it again from the Application Operationswindow.

Adding AnApplication ToPlant Workspace

From the Application Operations window, drag the application icon into thedesired cell in the Plant Workspace window.

If the application did not end up in the desired empty cell it must be deleted andadded again, it cannot be moved. See Deleting An Application From PlantWorkspace.

If the operator attempts to place the application in an occupied cell, the followingmessage will appear:

Page 30: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.11 Applications Menu – Plant Workspace

18 Profit Toolkit User's Guide 5/01Honeywell Inc.

Deleting AnApplication FromPlant Workspace

Click once on the application you want to delete from the Plant Workspacewindow. The following message will appear (where CRUD_OPT is the name ofthe application you want to delete).

Note: This procedure only works if you are NOT connected to the controller! Ifconnected, disconnect first.

Click [No]. This will select the cell where CRUD_OPT resides. Press the Deletekey on the keyboard and the following message will appear:

Click [Yes].

Viewing AnApplication FromPlant Workspace

Click once on the application you want to view from the Plant Workspacewindow. The following message will appear (where CRUD_OPT is the name ofthe application you want to view):

Click [Yes].

If you click on an application that is already being viewed, Profit Viewer willmove to the default display for that application. For instance, if you click on aProfit Controller application from the Plant Workspace window and thatapplication is already being viewed, you will automatically be moved to the CVSummary Display for that application.

Page 31: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.12 How to Read the Profit Viewer Displays

5/01 Profit Toolkit User's Guide 19Honeywell Inc.

1.12 How to Read the Profit Viewer DisplaysLabels, Fieldsand Buttons

Labels, fields, and buttons are reserved areas on a display, dedicated to a particularpurpose or kind of information. The labels, fields, and buttons in Profit Controllerhave special meaning, described in the following table.

Term Meaning

Label Labels are read-only display areas. Labels display information that you cannot change.The description of a value or most column headers are labels.

Example:

Field Fields are display areas that accept tuning, configuration, and optimization input from the keyboard.Fields are surrounded by borders. Clicking anywhere within the rectangular border either opens the input prompt window, orexecutes the command.• Open Fields Open fields accept keyboard or mouse input. Open fields are designated with either a downward pointing or

rightward pointing solid black triangle as shown here:

or

• Closed Fields Closed Fields do not accept keyboard or mouse input when clicked. A field can be closed for two reasons:1. A higher access level is required, or2. The CV or MV is critical, and certain changes to critical variables (such as a mode change to an MV) cannot be made.Closed Fields are designated with either a downward pointing or rightward pointing gray triangle shown here:

or

Button Buttons are display areas that execute commands. They typically look like a pushbutton.

Example:

Some are tabs at the top of a display.

Example:

Sometimes a button will not function. Typically, the text on the button will be half intensity and an explanation is given if the buttonis clicked. Reasons for the button not working:

1. A higher access level is required, or2. The operation is not currently available because of other settings.

Example:

Page 32: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 1 — Getting Started with Profit Viewer1.12 How to Read the Profit Viewer Displays

20 Profit Toolkit User's Guide 5/01Honeywell Inc.

Button Example

Field/CellBackgroundColor

Font ColorIndicates This Condition

Lt Gray Black Active button. Reacts to clicking.

Lt Gray Dark Gray Inactive/Inaccessible button. Does not react to clicking.

Cyan Black Currently selected object or state

Yellow Black Action Pending

Green Black Action triggered has not completed yet

Arrows Example Arrow Indicates This Condition

or No arrow Field cannot be modified

or Black Arrow Field can be modified

or Grey Arrow Field can be modified, but current user does not have the securitylevel required.

Page 33: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

5/01 Profit Toolkit User's Guide 21

Honeywell Inc.

Section 2 — Using Profit Toolkit

2.1 Profit Toolkit Application DisplaysProfit Toolkit application displays are accessible through Profit Viewer byselecting a Profit Toolkit icon from the Application Menu as described in theprevious section.

The following displays are currently available for Profit Toolkit application:

1. Function I/O display – displays Toolkit loops, functions and the functionparameter values.

2. Toolkit Detail display – displays selected application parameters.

3. Status Message display – displays messages for the application.

The default display when user selects a Toolkit application is the Function I/Odisplay. Below is an example of the display.

Page 34: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 2 — Using Profit Toolkit2.1 Profit Toolkit Application Displays

22 Profit Toolkit User's Guide 5/01Honeywell Inc.

1. Function I/ODisplay

The TOOLKIT FUNCTION column lists the Toolkit loops and function aliasnames. The library name and the actual Toolkit function names are listed next totheir alias names under the PARAMETER column.

With a single click the Toolkit loops and functions may be collapsed or expandedas shown below.

When the loop is expanded, the display lists the loop start, end and current indices,as well as the functions in the loop. In the example above, the display shows a loopcalled Loop1, which loops function Pressure_Proc1 5 times (from Start Index toEnd Index). Note that although it is not shown in the example above, multiplefunctions can be contained in a loop. Loops can also be nested.

When the function is expanded, the display lists the Toolkit functions’ input andoutput parameter indexes, parameter names, current parameter values, and theparameter source if the parameter is linked to an external parameter (e.g. LCNpoint.parameter, PHD tag name, or HS_Open application’s parameter.)

To change a value, click on it. An input box like the one below will appear. If theinput box does not appear, the value is not changeable.

Type in the value and click [ENTER].

Note: parameter that is linked to an external parameter is not changeable from thisdisplay. User should change the parameter value directly from its source.

Page 35: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 2 — Using Profit Toolkit2.1 Profit Toolkit Application Displays

5/01 Profit Toolkit User's Guide 23Honeywell Inc.

2. Toolkit DetailDisplay

The Toolkit Detail Display shows current values of some application parameters.To view this display, click [TOOLKIT DETAIL].

Some of these parameters, indicated by a small arrow next to the parameter name,are changeable during runtime. Click on the value to change it.

See Table 2-1 at the end of this section for detail description of each field entrieson the Toolkit Detail page.

Page 36: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 2 — Using Profit Toolkit2.1 Profit Toolkit Application Displays

24 Profit Toolkit User's Guide 5/01Honeywell Inc.

3. StatusMessage Display

The Status Message Display shows the application’s past and present status orcondition. The purpose is also to present the cause of a software application error.To view this display, click [STATUS MSGS]. See Displaying & Responding toMessages section in this document for a complete description of this display.

Table 2-1 Toolkit Detail –Understanding And Using The Fields

Toolkit Detail - Field Descriptions and User Notes

Field Description

Field Type Default Access User Notes

Toolkit (Application)Name

Read-Only No Access

Toolkit NameWhen Toolkit functions are used within a ProfitController application, the name indicates theController name.

Toolkit (Application)Description

Editable Field All User

Description of the toolkit application.To change the description, click on the field, typethe new description, click or press <ENTER>.When Toolkit functions are used within a ProfitController application, the description indicates theController description.

Configuration File Read-Only No Access

The .CFG toolkit definition file created by theToolkit design configuration of the APCDevelopment Environment.

These files supply the Profit Toolkit applicationconfiguration.

Configuration VersionNumber

Read-Only No Access

Current version number of the configurationfile.

The number is incremented only if a major upgradeof the configuration file is needed to support futureenhancements. This allows backward compatibilitywith older versions of the configuration file.

Last ExecutionDate/Time

Duration:

Read-Only No Access

Starting time of the last toolkit execution(updated at the beginning of each execution).Time it took to complete the toolkit execution(updated at the end of each execution).Always less than the execution frequencyunless the cycle overruns. On an overrun, acounter is incremented, and the next executionis delayed. When the overrun limit is violated,the controller shuts down.

The time of a toolkit calculation includes controllerexecution time when toolkit functions are mergedwithin a controller application.

Last Checkpoint WriteTime

Read-Only No Access

Date and time the checkpoint file was lastwritten.

Page 37: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 2 — Using Profit Toolkit2.1 Profit Toolkit Application Displays

5/01 Profit Toolkit User's Guide 25Honeywell Inc.

Toolkit Detail - Field Descriptions and User Notes

Field Description

Field Type Default Access User Notes

DesignExecution Period(Minutes)

Read-Only No Access

The design execution period for the applicationthat was specified when building the toolkit (orcontroller when toolkit functions are calledwithin a controller) in the off-line design.

ActualExecution Period

Read-Only No Access

The execution period (in minutes) of the toolkitapplication.

Demand CheckpointEditable Field All User

Checkpoint of toolkit is saved at nextexecution.

CheckpointFrequency

Editable Field All User

Time in minutes between writing outcheckpoint.

The checkpoint files contains a snapshot of varioustoolkit parameters and variables. The checkpointfile is read in when the toolkit is restarted. Thisallows the application to return to its checkpointstate.

If the user decides to restart toolkit without usingthe last check-pointed values (i.e. restart using theoriginal configuration file values), then the usershould delete the checkpoint files (ToolkitName.cptand ToolkitName.cpt.bu) located inusers\HiSpec\config directory.

Note: If the checkpoint file is deleted then allchanges made to configuration parameters will belost.

The function writer specifies the checkpointflag for each of the toolkit function parameters.

Number of ToolkitFunctions

Read-Only No Access

The number of toolkit functions in theapplication.

Number of ToolkitFunctions Bad

Read-Only No Access

The number of toolkit functions returning non-zero return status (either warning or error) onthe last execution.

Maximum Number ofOverlaps

Editable Field All User

The number of allowable consecutive missedcontroller executions due to over-runs.

An overlap occurs when calculations from onecontroller execution period over-run into the nextscheduled period.

Number of Overlaps Read-Only No Access

Number of consecutive times the calculationshave over-run into the next scheduled period.

When Number of Overlaps = Maximum NumberOverlaps, the controller shuts down.

Page 38: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 2 — Using Profit Toolkit2.1 Profit Toolkit Application Displays

26 Profit Toolkit User's Guide 5/01Honeywell Inc.

Toolkit Detail - Field Descriptions and User Notes

Field Description

Field Type Default Access User Notes

Application Status Dialog Box All User

•If ACTIVE a yes/no dialog box willappear saying “About To Set ToolkitINACTIVE. Continue?” If answered yes theApplication Status will be set to INACTIVE.

•If INACTIVE a yes/no dialog box willappear saying “About To Set ToolkitACTIVE. Continue?” If answered yes theApplication Status will be set to ACTIVE.

Toolkit calculations are executed ONLY when thetoolkit application state is ACTIVE.

Page 39: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

5/01 Profit Toolkit User's Guide 27

Honeywell Inc.

Section 3 — DISPLAYING & RESPONDING TO MESSAGES

3.1 OverviewGeneratedMessages

Profit Toolkit generates three kinds of messages: (1) Help messages and error-on-input messages, (2) Tool Tip descriptions, and (3) Software (Toolkit) messages.

Help and ErrorOn-Input

Messages are shown on the bar above the toolkit function window

SoftwareMessages

If the Toolkit Function is red, click [STATUS MSGS].

Software messages are found in the currently active Profit Toolkit log file. Click[STATUS MSGS] to view these.

Sample StatusMessagesDisplay

The STATUS MSGS display shows the application’s past and present status orcondition. The purpose is also to present the cause of a software application error.

The image below shows the STATUS MSGS display.

Using theDisplay

•To View This Display from anywhere within Profit Toolkit, click on the[STATUS MSGS] on the lower Menu Bar.

The log file will display with the most recent information at the top of thedisplay. If you manually open the log file from where it resides in itsdirectory using a program like Windows Notepad, the log file will displaywith the most recent information at the bottom of the file.

•What You Can Do On This Display

Click [Refresh Status Messages] to update the Status Messages window.

Standard windows copy and paste features (e.g., Ctl+C and Ctl+V) can be used tocopy all or a portions of the displayed messages into an email or any other kind ofword processing document.

Page 40: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Section 3 — Displaying & Responding to Messages3.1 Overview

28 Profit Toolkit User's Guide 5/01Honeywell Inc.

Page 41: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

5/01 Profit Toolkit User's Guide 29

Honeywell Inc.

SECTION 4 - Profit Toolkit Functions

4.1 OverviewFunctions can beRun in Design andRun-TimeEnvironments

One of the most powerful features of Profit Toolkit functions is that they can beexecuted in both the design and run-time environments. In the design environmentinputs can be streamed through toolkit functions to generate data for newvariables. The output data can be then be modeled in the Design Studio.

Profit ToolkitFunctionsInterface with aWide Variety ofEnvironments

Profit Toolkit functions can interface with a wide variety of environments. Profittoolkit input and output parameters can be configured to input from or output tothe following environments:

• TPS• OPC compliant applications• PHD• Other toolkit applications/functions.

Configuring aProfit Toolkit forRun-Time

Configuring a Profit Toolkit application requires the following steps:

1. In Profit Design Studio, decide which functions to configure as part of theapplication.

2. In Profit Design Studio – Run-Time configuration, configure the parameterinput and output connections, then build the configuration file (.CFG)

3. Note that the configuration file contains the following run-time information:

• The toolkit DLL(s) to load.• The functions to use in the DLL.• The alias names of the functions.• The function execution order.• Function parameter input and output connections.

4. Register the application via Server Registrar.

5. Launch the application via Profit Viewer.

6. View and interact with the application via Profit Viewer

Profit ToolkitApplications thatCan be Purchased

Honeywell Hi-Spec Solutions sells a wide variety of Profit Toolkit applications,including:

• Fractionator Toolkit• FCCU Toolkit• Lab Update Toolkit• Profit Bridge Toolkit

Page 42: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.2 What Really Happens when a Toolkit Starts Up

30 Profit Toolkit User's Guide 5/01Honeywell Inc.

4.2 What Really Happens when a Toolkit Starts UpHowConfiguration andCheckPoint Fileare Used When aToolkit Starts Up

The following steps take place when a toolkit starts up. Note that a toolkit is defineto “start up” when a toolkit is connected to for the first time (i.e. the Profit Toolkitprocess is not yet started), or whenever the toolkit application state is set fromInactive to Active.

1. The configuration file (CFG) is read in and toolkit parameters are initializedbased on the information in the CFG file.

2. The checkpoint file (CPT) is read in if it exists.

If the CPT file exists, the values in the CPT file will supercede the CFG filevalues but only for the toolkit parameters that are configured as “Read fromCheckpoint”.

How DSS ServersInput and OutputData to/fromToolkits

3. I/O DSS Servers (for example DSSGant, DSSPHD, etc) are run and I/O datais fetched from the relevant DSS and stored in the toolkit input parameters.This is based on the input parameter connections that were made in ProfitDesign Studio.

4. The toolkit functions then run. The toolkit functions update the toolkitfunction output parameters.

5. The I/O DSS Servers are run again, and the relevant toolkit output parametersare stored to the DSS. This is based on the output parameter connections thatwere made in Profit Design Studio.

Page 43: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.3 Toolkit Configuration (CFG) File

5/01 Profit Toolkit User's Guide 31Honeywell Inc.

4.3 Toolkit Configuration (CFG) FileMaking Changesto the ToolkitConfiguration(CFG) File

Any changes a user makes within a CFG file will not take affect until the userperforms one of the following steps:

1. Once the modified CFG file is created the user should restart the applicationby calling up the Toolkit Detail display on Profit Viewer, and thenINACTIVATING then ACTIVATING then Application Status.

2. Or by killing the running application. Refer to the “Terminating a ProfitToolkit Application” section below on how to kill the toolkit application.

Page 44: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.4 Toolkit Checkpoint (CPT) File

32 Profit Toolkit User's Guide 5/01Honeywell Inc.

4.4 Toolkit Checkpoint (CPT) FileWhy to Delete aCheckPoint File

Profit Toolkit maintains a checkpoint file for each Toolkit application. Run-timechanges on Toolkit function parameters (for example those made via ProfitViewer) are saved in the checkpoint file. A restart or reactivation of theapplication (INACTIVE to ACTIVE of Application Status parameter on ToolkitDetail display) will cause the checkpoint file to be read and the values of thecheckpointed parameters to be re-stored. If user wants to use the initial values (asconfigured in the configuration file) instead of the checkpointed values, delete thecheckpoint files associated to the application ([ApplicationName].cpt and[ApplicationName].cpt.bu) located in c:\users\HiSpec\config\ directory. Of coursethis means that any run-time changes will be lost unless they too are put into theconfiguration file.

Page 45: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.5 Toolkit Function Execution

5/01 Profit Toolkit User's Guide 33Honeywell Inc.

4.5 Toolkit Function ExecutionBefore/After/BothExecution

When a Profit Toolkit function runs as part of a Profit Controller or ProfitOptimizer application, the user can specify whether to run before, after or bothbefore and after the Controller/Optimizer engine runs.

ControllingToolkit Executionusing the ExecuteParameter

A typical toolkit executes every time the application executes. Toolkit executioncan be controlled so that it only executes when the Execute parameter is set.

If a toolkit is built with the Execute parameter then the function will only executewhen the Execute parameter is not equal to zero. After the function completesexecution the Execute parameter is automatically set back to zero. And on thefollowing application execution the toolkit function won’t execute unless theExecute parameter is non-zero.

FunctionExecution Order

The function execution order (i.e. the order in which functions execute relative toother functions) can be extremely important for certain toolkit applications – inparticular when one functions output is used as the input for another function. Inthis case typically, the function that is providing the output is should be executedbefore the function receiving the output as its input.

The actual toolkit function execution order is based on the function order in theCFG file. Functions at the top of the file are executed before any function below itin the CFG file. The order is specified when configuring the toolkit functions inProfit Design Studio – Profit Toolkit Design Configuration

Page 46: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.6 Toolkit Function Looping

34 Profit Toolkit User's Guide 5/01Honeywell Inc.

4.6 Toolkit Function LoopingToolkit FunctionLooping

Toolkit looping provides the ability to execute a set of toolkit functions within aloop during a single application execution interval.

For example, suppose a user has configured functions F1 and F2. Using looping itis possible to execute F1 and F2 a configurable number of times in a singleapplication execution. For example if a loop is configured to loop 3 times, thefollowing execution would take place: F1 -> F2 -> F1 -> F2 -> F1 -> F2.

Simple Looping The following pseudocode provides an overview of simple looping described inthe above example.

BEGINLOOP1: FOR STARTINDEX to ENDINDEX, CURRENTINDEX

F1

F2

ENDLOOP1

Loop Start andEnd Indices

The loop start and end indices control the number of times the functions within theloop will execute. For example if STARTINDEX and ENDINDEX are set to 1and 3 respectively, the functions in the loop will execute 3 times each interval.Similarly if they are set to 0 and 2 respectively, the functions in the loop will alsoexecute 3 times each interval.

Since STARTINDEX and ENDINDEX are variables, this allows the user tochanging of the loop indices from one interval to the next interval – for example inone interval the loops may be from 1 to 3, and in the next interval loop from 1 to4, etc.

Loop CurrentIndex

The current loop CURRENTINDEX is also a parameter. As the loop executes thethis index is incremented. By connecting this parameter to a function input itenables the function to determine what index is currently running. For example ifSTARTINDEX = 1 and ENDINDEX=3, the index is set to 1 then 2 then 3. Inmany cases this information may be needed by the function.

Nested Looping Nested looping is also available in Toolkit Function Looping. The followingpseudocode provides an example of nested looping:F1BEGINLOOP1: FOR 1 to 2

F2BEGINLOOP2 FOR 1 to 3

F3ENDLOOP2F4

ENDLOOP1

In this scenario the following function execution will take place.F1 -> F2 -> F3-> F3 -> F3 -> F4 -> F2 -> F3 -> F3 -> F3 -> F4

Note that F1 executes outside the loop. Also note that inner loop LOOP2 functionexecution is bolded for clarity.

Page 47: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.7 Toolkit Function Messages

5/01 Profit Toolkit User's Guide 35Honeywell Inc.

4.7 Toolkit Function MessagesMessaging – ViaRetMessageParameter

Most Profit Toolkit function have an array parameter call RetMessage. Thisparameter shows the current messages for the function. The parameter can beviewed on the Profit Viewer. Most of the time it is easier to view messages viaRetMessage as

Return to NormalMessages

Error messages that are generated by the Profit Toolkit function are placed in theapplication log file. When the error message clears, the error message prefixedwith “Return to Normal” is placed in the log file.

A sample error message might look something like:

“Error – Temperature too high”

Its corresponding return to normal would be:

“Return to Normal – Temperature too high”

Number ofSimultaneousMessages Raised

The maximum number of simultaneous messages is defined by parameter RetNum.For example if RetNum is set to 5, 5 simultaneous error messages can be raised. IfRetNum is set to 5, and 6 messages need to be raised then only the 5 highestpriority messages will be displayed.

Page 48: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.8 Terminating a Profit Toolkit Application

36 Profit Toolkit User's Guide 5/01Honeywell Inc.

4.8 Terminating a Profit Toolkit ApplicationWhy a UserNeeds toTerminate aProfit ToolkitApplication

On some occasions it may be necessary to terminate a Profit Toolkit program.Usually the only reasons for terminating a toolkit’s program are:

• To install a new version Profit Toolkit application. All toolkit programs mustbe terminated before doing a new installation.

• To re-register a toolkit. The toolkit program must be terminated beforeattempting to re-register it.

• To clear a toolkit program that has stopped operating correctly. This shouldrarely, if ever, be required.

How toTerminate aProfit ToolkitApplication

To terminate a toolkit program you need to use a special version of the NT TaskManager that is provided as part of the Profit Toolkit package. This programallows you to kill an NT process even if you are not the user that started theprocess. NOTE: Because the usual security measures are bypassed, use of thistool is dangerous. If you make a mistake you might inadvertently stop a criticalprogram, which could cause the entire node to malfunction. Be very careful tofollow these instructions:

DetailedDescription –How toTerminate aProfit ToolkitProcess

1. Determine the Process ID (PID) of the toolkit’s program that you want toterminate. The PID can be found in the start-up messages in the log file for thetoolkit (located in \users\HiSpec\Apps). Or you can use Notepad or some othereditor to look in the file \users\HiSpec\Apps\rstrtreg.txt – the PID is listed alongwith the name of the toolkit.

2. Terminate the Task Manager program if it is running.

3. Using File Explorer, select the following file in the following directory:

..\Program Files\Honeywell\HiSpec Solutions\taskmgr_ed.exe

4. This starts the special version of Task Manager.

5. Select the Processes tab. Find the toolkit’s PID in the PID column. Thecorresponding name in the Image Name column should be Profit Toolkit. (Therewill be one Profit Toolkit listed for each toolkit that is running.)

Page 49: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.8 Terminating a Profit Toolkit Application

5/01 Profit Toolkit User's Guide 37Honeywell Inc.

6. Click on the Image Name (as shown in the following figure) to select it.Make sure that the selected Image Name has the correct PID that youdetermined above.

7. Click End Process, and click Yes in the warning box.

Page 50: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

SECTION 4 - Profit Toolkit Functions4.8 Terminating a Profit Toolkit Application

38 Profit Toolkit User's Guide 5/01Honeywell Inc.

If you are Unableto Terminate theProcess

If you are unable to kill the process, it may be because you do not have “debugprograms” rights. To check this, select Start – Programs – Administrative Tools –User Manager. Select Policies – User Rights. Select the Show Advanced UsersRights check-box. Drop down the Right list and select “Debug programs”. TheGrant To box will then list all the groups that have this right. If you are not in oneof these groups (double-click on a group listed under Groups to see what groupsyou are in) then you or your system administrator can give your group this right.

Page 51: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

5/01 Profit Toolkit User's Guide 39

Honeywell Inc.

Index

A

Adding Local Applications, 13

Adding New Users, 7

Adding Remote Applications, 13

Application Operations Window, 16

ApplicationsAdding Local, 13Adding Remote Apps, 13Selecting One, 13Switching Views, 16Termination, 36Viewing an Application, 16Viewing Information About, 11What Applications Are Registered, 12

Applications MenuTo Switch Views, 16To View an Application, 16

C

Checkpoint, 32

CheckPoint File, 30

Colors Indicating Controller Mode, 3

Configuration, 31D

Detail Button, 3

Display Buttons, 4

DisplaysHow To Read, 19

F

Function I/O Display, 22

Functions, 29Execute, 33

G

Getting Started, 1I

Inactivity Stepdown, 10

L

Logging OnDefault, 2First Time Setup, 2

Logon ID Security, 7

Logon to Profit Viewer, 2

Looping, 34M

Messages, 4, 27, 35O

Operator DisplayApplications Menu Button, 3Overview, 3Program Operations Fields, 4

Options, 5P

Plant WorkspaceAdding an Application, 17Deleting an Application, 18Description, 17Viewing an Application, 18

Profit ControllerHow To Read Displays, 19

Profit ViewerAdding New Users, 7Behaviors, 5Buttons, 3Deleting Users, 8Modifying User Names, 8Options, 3, 5Security, 5Security Database Location, 9Startup Options, 9View Only Button, 2

R

Refresh, 14

Run-Time, 29

Page 52: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Index4.8 Terminating a Profit Toolkit Application

40 Profit Toolkit User's Guide 5/01Honeywell Inc.

S

SecurityCreating Custom Levels, 6

Status Message Display, 24

Status Messages, 4, 27, 35T

Toolkit Detail Display, 23

Page 53: Industrial Automation and Control Solutions from Honeywell - … · 2011. 11. 14. · RMPCT Robust Multivariable Predictive Control Technology PL Parameter List CDS Custom data segment

Index4.8 Terminating a Profit Toolkit Application

5/01 Profit Toolkit User's Guide 41Honeywell Inc.