Professional Documents
Culture Documents
Production Management
Batch
USERS GUIDE
PUBLICATION BATCH-UM011A-EN-E 20
Supersedes Publication BATCH-UM0010A-EN-P
Customer Support Telephone 1.440.646.3434 Online Support http://www.rockwellautomation.com/support/ 2010 Rockwell Automation, Inc. All rights reserved. Printed in USA. This document and any accompanying Rockwell Software products are copyrighted by Rockwell Automation, Inc. Any reproduction and/or distribution without prior written consent from Rockwell Automation, Inc. is strictly prohibited. Please refer to the license agreement for details. Allen-Bradley, ControlLogix, eProcedure, FactoryTalk, Rockwell Automation, Rockwell Software, RSBizWare, RSBizWare BatchHistorian, RSBizWare Historian, RSBizWare MaterialTrack, and RSLinx are trademarks of Rockwell Automation, Inc. Any Rockwell Automation software or hardware not mentioned here is also a trademark, registered or otherwise, of Rockwell Automation, Inc.
Trademark Notices
Other Trademarks
ActiveX, Microsoft, Microsoft Access, SQL Server, Visual Basic, Visual C++, Visual SourceSafe, Windows, Windows Server-, Windows XP, and Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Adobe, Acrobat, and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. All other trademarks are the property of their respective holders and are hereby acknowledged. This product is warranted in accordance with the product license. The products performance may be affected by system configuration, the application being performed, operator control, maintenance, and other related factors. Rockwell Automation is not responsible for these intervening factors. The instructions in this document do not cover all the details or variations in the equipment, procedure, or process described, nor do they provide directions for meeting every possible contingency during installation, operation, or maintenance. This products implementation may vary among users. This document is current as of the time of release of the product; however, the accompanying software may have changed since the release. Rockwell Automation, Inc. reserves the right to change any information contained in this document or the software at anytime without prior notice. It is your responsibility to obtain the most current information available from Rockwell when installing or using this product.
Warranty
Contents
FactoryTalk Batch Administrators Guide Chapter 1 Using FactoryTalk Batch Components . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Document Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Configuring FactoryTalk Batch Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 2 FactoryTalk Batch Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Creating a Shared Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Using OLE for Process Control (OPC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Defining OPC Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Chapter 3 FactoryTalk Batch Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 FactoryTalk Batch Server User Account . . . . . . . . . . . . . . . . . . . . . . . . . . 7 FactoryTalk Batch System Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . 8 System-wide COM Security Limit Settings. . . . . . . . . . . . . . . . . . . . . . . 8 FactoryTalk Batch Server Install Configuration . . . . . . . . . . . . . . . . . . . 8 FactoryTalk Batch Client Install Configuration . . . . . . . . . . . . . . . . . . . 9 FactoryTalk Batch Windows Firewall Exceptions . . . . . . . . . . . . . . . . . . 9 Adding the Batch COM Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Setting Security on Folders or Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Adding Users and User Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 FactoryTalk Security for the Batch Clients . . . . . . . . . . . . . . . . . . . . . . . 11 Tighten security for FactoryTalk Batch clients . . . . . . . . . . . . . . . . . . 12 Configure FactoryTalk Batch View Security . . . . . . . . . . . . . . . . . . . . . . 13 Configuring Security for the FactoryTalk Batch View Windows . . . . . . . . 14 Security for FactoryTalk Batch Commands . . . . . . . . . . . . . . . . . . . . . 15 Setting the Automatic Logoff Time Period . . . . . . . . . . . . . . . . . . . . . 18 Changing the Logged-On User with Your HMI . . . . . . . . . . . . . . . . . . . 19 Using an External Security Device . . . . . . . . . . . . . . . . . . . . . . . . . . 20
iii
Configure Equipment Editor and Recipe Editor Security . . . . . . . . . . . . . . . 21 Configure Access Mode Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Modifying the Equipment Editor Configuration Options . . . . . . . . . . . . . 23 FactoryTalk Batch Default Policy Settings . . . . . . . . . . . . . . . . . . . . . . . . 23 Product Policies Only in the Local FactoryTalk Directory . . . . . . . . . . . . 24 Product Policies in the Local and Network Directory . . . . . . . . . . . . . . . 28 Chapter 4 FactoryTalk Batch Auditing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Enabling Auditing for the Equipment or Recipe Editor . . . . . . . . . . . . . . . . 33 Audited FactoryTalk Batch Equipment Editor Events . . . . . . . . . . . . . . . . . 34 Audited FactoryTalk Batch Recipe Editor Events . . . . . . . . . . . . . . . . . . . . 37 Viewing Audit Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 FactoryTalk Diagnostic Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Standard Viewer Message Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Extended Viewer Message Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 FactoryTalk AssetCentre Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Viewer Message Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Chapter 5 FactoryTalk Batch Electronic Signatures . . . . . . . . . . . . . . . . . . . . . . . . 45 Command Verification Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Command Signature Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Set Parameter Signature Request . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 FactoryTalk Batch Parameter Prompt Acknowledge Signature Request . . . 49 Unit Bind Prompt Acknowledge Signature Request . . . . . . . . . . . . . . . . 50 Phase Bind Prompt Acknowledge Signature Request . . . . . . . . . . . . . . . 50 Unit Bind Signature Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Remove Batch Signature Request . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Add Event Signature Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Active Step Change Signature Request . . . . . . . . . . . . . . . . . . . . . . . . 54 Parameter Deviation Verification Policies . . . . . . . . . . . . . . . . . . . . . . . . 55 Parameter Deviation Signature Requests . . . . . . . . . . . . . . . . . . . . . . 56 Report Parameter Deviation Signature Requests . . . . . . . . . . . . . . . . . 57 General Usage Phase Logic Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 General Usage Signature Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . 58
iv
Contents
Electronic Signatures Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Configure the ESignature Network Directory Policy Setting . . . . . . . . . . 59 Chapter 6 The FactoryTalk Batch Service Manager . . . . . . . . . . . . . . . . . . . . . . . . 61 Windows Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 FactoryTalk Batch Service Manager Interface . . . . . . . . . . . . . . . . . . . . . 61 Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Service State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Batch Server Statistics Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Messages Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 PCD Communications Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 View Communications Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Starting the Batch Server Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Enabling a Grace Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Adding a Custom Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Chapter 7 Working with the FactoryTalk Batch Server . . . . . . . . . . . . . . . . . . . . . 69 Configuring the FactoryTalk Batch Server Service. . . . . . . . . . . . . . . . . . . 69 Specify the Startup Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Editing the FactoryTalk Batch Server Options . . . . . . . . . . . . . . . . . . . . . 70 Project Settings Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Restart Control Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Batch Reporting Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Archiver Event Filters Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Batch Server Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Hyperlink Descriptors and Defaults Tab . . . . . . . . . . . . . . . . . . . . . . . 79 Material Policies Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Modifying the .NET Registry Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Using Automatic Restart Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Restart the Batch Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Performing a Manual Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Configuring the FactoryTalk Batch Server for Manual Failover . . . . . . . . 83 Configuring the Material-Enabled Batch Server for Manual Failover . . . . . 83 Command Handshake Timeout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Chapter 8 Working with Cross Invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Configuring Cross Invocation Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Context Data Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Cross Invocation String Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Chapter 9 Working with Windows Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Viewing Event Log Entry Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Modifying Event Log Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Chapter 10 The FactoryTalk Batch Phase Simulator . . . . . . . . . . . . . . . . . . . . . . . 101 Starting the FactoryTalk Batch Phase Simulator . . . . . . . . . . . . . . . . . . . 101 FactoryTalk Batch Phase Simulator Interface. . . . . . . . . . . . . . . . . . . 101 Modifying a Phases Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Changing the Dwell Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Changing the Sequence of Requests. . . . . . . . . . . . . . . . . . . . . . . . . 103 Indicating a Continuous Phase . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Changing Phase Status During Run Time . . . . . . . . . . . . . . . . . . . . . . . . 104 Viewing/Updating Report Parameter Tag Values . . . . . . . . . . . . . . . . 107 Changing the Value of a Unit Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Chapter 11 Using the Network Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Opening the Network Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Looking at the Network Editor Interface . . . . . . . . . . . . . . . . . . . . . . . . 111 Hierarchy Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Detail Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Results Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Network Editor Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Status Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
vi
Contents
Configuring Your Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Selecting a Network Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Adding a Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Removing a Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Synchronizing Network Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Setting User Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Setting General Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Editing Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Editing Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Editing Information Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Changing View Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Setting Report Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Printing Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Previewing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Printing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 Chapter 12 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Handling abnormal FactoryTalk Batch termination . . . . . . . . . . . . . . . . . 127 Determining Abnormal Termination . . . . . . . . . . . . . . . . . . . . . . . . 127 Naming the Log File Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 End of Batch Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Logging Tag Verification Information . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Tag Verification Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Windows Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Using the Performance Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Opening the Performance Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Troubleshooting Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Appendix A Customizing Batch IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Enable Editing of Batch IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Disable Editing of Batch IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Defining a Custom Default Batch ID . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Creating a Custom BatchIDCreation.DLL . . . . . . . . . . . . . . . . . . . . . . . . 136
vii
Appendix B Changing the FactoryTalk Batch Server User Account . . . . . . . . . . . . . . 139 Creating a New User Account for the FactoryTalk Batch Server . . . . . . . . . 139 Configuring Your FactoryTalk Batch System . . . . . . . . . . . . . . . . . . . . . . 139 Changing the Server Account Password. . . . . . . . . . . . . . . . . . . . . . . 140 Appendix C Running Multiple Instances of FactoryTalk Batch View . . . . . . . . . . . . . 143 Enabling Multiple View Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Creating Custom Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . 145 Viewing Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Starting the Batch View from the Command Line . . . . . . . . . . . . . . . . . . 148 Equipment Editor Users Guide Chapter 1 Introducing the Equipment Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Document Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Equipment Editor Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Opening the FactoryTalk Batch Equipment Editor . . . . . . . . . . . . . . . . . . 154 Logging on to the Equipment Editor. . . . . . . . . . . . . . . . . . . . . . . . . 154 Equipment Editor Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Chapter 2 Working with Area Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Examining Area Model Components . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Data Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Process Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 Equipment Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Creating a New Area Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Opening an Existing Area Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Migrating Area Models from FactoryTalk Batch Version 10.x . . . . . . . . . 164 Area Models and Material Manager . . . . . . . . . . . . . . . . . . . . . . . . . 164
viii
Contents
Chapter 3 Importing and Exporting Area Models. . . . . . . . . . . . . . . . . . . . . . . . . 167 Importing and Exporting XML Area Models. . . . . . . . . . . . . . . . . . . . . . . 167 Importing an XML Area Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Exporting an Area Model to XML . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Converting XML to Binary from the Command Line . . . . . . . . . . . . . . 170 Converting XML to Binary from COM . . . . . . . . . . . . . . . . . . . . . . . . 171 Chapter 4 Using Enumerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 System Enumeration Sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 Creating Enumeration Sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Adding Enumeration Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Editing Enumerations and Enumeration Sets . . . . . . . . . . . . . . . . . . . . . 176 Deleting Enumerations and Enumeration Sets . . . . . . . . . . . . . . . . . . 177 Chapter 5 Using Parameters and Reports with FactoryTalk Batch . . . . . . . . . . . . . 179 Parameters and Reports in Recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 Parameters Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 How Parameters and Reports Work with Equipment Module Tags . . . . . . . 180 Configuring Additional Request, Parameter, and Report Tags for Equipment Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 Matching Equipment Module Tags to PCD Tags . . . . . . . . . . . . . . . . . 181 Batch Parameters and Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Phase Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Phase Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Using Material Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 Types of Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 Default Material Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 Scaling Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 Selecting a Verification Method for Parameter Deviations . . . . . . . . . . . . 184 Understanding Control Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Example Control Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Implementing Control Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Using Upload/Download Parameter and Report Subsets . . . . . . . . . . . . . . 187 Download Parameter Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 Upload Report Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
ix
Using Automatic Upload/Download. . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Using Control Strategies with Upload/Download Parameter Subsets . . . . . . 190 Chapter 6 Using Electronic Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 Types of Electronic Signatures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 How Electronic Signatures Work. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 Creating a Signature Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Field Descriptions for Edit Signature Templates . . . . . . . . . . . . . . . . 196 Adding a Signature Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 Configuring Signature Template Signoffs . . . . . . . . . . . . . . . . . . . . . 198 Deleting a Signature Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 Modifying a Signature Template . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 Configuring Command Verification Policies . . . . . . . . . . . . . . . . . . . . . . 204 Field Descriptions for Edit Command Verification Policies . . . . . . . . . . 205 Changing the Verification Policy for a Command . . . . . . . . . . . . . . . . 206 Removing the Signature Requirement for a Command . . . . . . . . . . . . . 207 Chapter 7 Using Data Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 Data Server Definition Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 Working with Data Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 OPC Data Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 Adding an OPC Data Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 Adding an RSLinx Enterprise FactoryTalk Live Data Server . . . . . . . . . . 213 Editing a Data Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Deleting a Data Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 Assigning Data Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 Chapter 8 Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 Arbitration of Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 Defining Shared Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 Configuring General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 Configuring Arbitration Information . . . . . . . . . . . . . . . . . . . . . . . . . 222 Configuring Cross Invocation Information . . . . . . . . . . . . . . . . . . . . . 223 Configuring Hyperlink Information. . . . . . . . . . . . . . . . . . . . . . . . . . 223
Contents
Chapter 9 Configuring Global Binding Requirements . . . . . . . . . . . . . . . . . . . . . . 225 Using the Unit Binding Expression Builder . . . . . . . . . . . . . . . . . . . . . . . 225 Expression operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 Data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Expression Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Creating Global Binding Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 228 Editing Binding Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Deleting Binding Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Chapter 10 Configuring Process Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Creating a Process Cell Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Editing a Process Cell Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Creating and Configuring Process Cell Instances. . . . . . . . . . . . . . . . . . . 232 Configuring a Process Cell Instance. . . . . . . . . . . . . . . . . . . . . . . . . 232 Configuring Hyperlink Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Removing a Process Cell Instance . . . . . . . . . . . . . . . . . . . . . . . . . . 236 Verifying Icon Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 Creating Unique Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 Chapter 11 Configuring Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Creating a Unit Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Editing a Unit Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Creating a Unit Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Configuring a Unit Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Removing a Unit Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Linking Unit Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 Sharing Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 Chapter 12 Configuring Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 Working with Unit Attribute Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 Adding a Unit Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 Editing a Unit Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 Deleting a Unit Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 Creating a Unit Attribute Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
xi
Working with Equipment Module Tags . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Editing Tags from the Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Setting All Tag Items to Default Name and Access Path . . . . . . . . . . . . 255 Creating a Global Unit Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 Editing a Unit Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Deleting a Unit Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Removing a Global Unit Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . 259 Chapter 13 Configuring Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Creating a Phase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Configuring General Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Configuring Phase Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 Configuring Phase Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 Selecting Context IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 Configuring Phase Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Configuring Control Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Configuring Verification Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 How Verification Policies Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Field Descriptions for Verification Policies Dialog Box . . . . . . . . . . . . . 279 How Verification Policies Work with Control Strategies . . . . . . . . . . . . 284 How Editing Target Parameters Affects Report Verification Policies . . . 284 Configuring a Phase to be Material-Enabled . . . . . . . . . . . . . . . . . . . . . 284 Standard Phase with Matching Parameter and Report Names . . . . . . . . 285 Standard Phase with Control Strategies Configured . . . . . . . . . . . . . . 285 Disabling Material on a Material-Enabled Phase . . . . . . . . . . . . . . . . . . . 285 Duplicating a Phase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Copying a Phase. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 Cutting and Pasting a Phase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 Chapter 14 Configuring Equipment Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 Creating an Equipment Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 Configuring the General Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 Configuring the Tag Data for Equipment Modules . . . . . . . . . . . . . . . . 291 Configuring the Arbitration Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
xii
Contents
Configuring Cross Invocation Data . . . . . . . . . . . . . . . . . . . . . . . . . 298 Configuring Hyperlink Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Configuring Container Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Creating Parameter Limit Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 Creating Report Limit Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 Configuring Parameter and Report Limit Tags . . . . . . . . . . . . . . . . . . . . 307 How Editing Parameters, Reports, and Phases Affects Limit Tags . . . . . 307 Sharing Equipment Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Appendix A Supported Area Model Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 Warm Restart Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 Area Model Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 Resource Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 Unit Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 Unit Attribute Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 Equipment Phase Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 Enumeration Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 Data Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 Process Cell Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 Process Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 Unit Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 Units. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316 Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 Configured Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 Recipe Phases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 Equipment Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 Appendix B Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 Import/Export Area Model Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 Unable to Access Instruction File . . . . . . . . . . . . . . . . . . . . . . . . . . 321 Illegal Characters Encountered in Writing Instruction File . . . . . . . . . . 321
xiii
Unable to Access Material Server for Material Support Per Container . . . 321 COM-Related Exception Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 Recipe Editor Users Guide Chapter 1 Introducing the Recipe Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 Log on to the Recipe Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 Setting the Recipe Editor options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 Recipe Editor interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 Recipe Editor menu bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 Recipe Editor toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 Recipe construction toolbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 Procedure View pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 Recipe Construction pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 Building a recipe: An overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 Chapter 2 Overview of Sequential Function Charts . . . . . . . . . . . . . . . . . . . . . . . 337 SFC components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 Transition expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 Transition operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 Element linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 SFC limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Transition expressions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Material-enabled parallel steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 SFC execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 Null procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 Timing and synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 Arbitration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 Subarbitration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 Adding null procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
xiv
Contents
Timer steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 Timer step hold behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 Recipe comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 Chapter 3 Overview of Table-Based Recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Viewing table-based recipes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Step sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Recipe structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 Step name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 Step parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 Table view transition expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 Creating parallel structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 Example of simple parallelism . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 Example of complex parallelism. . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Chapter 4 Creating a Recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Procedure levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Unit requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Unit-based recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Unit class-based recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Material-based recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 Material class-based recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 Dynamic unit allocation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 How dynamic unit allocation affects unit binding . . . . . . . . . . . . . . . 360 Binding methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 Unit requirement name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 Downstream unit requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 Enabling dynamic unit allocation . . . . . . . . . . . . . . . . . . . . . . . . . . 362 Opening a recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 Creating operations and unit procedures . . . . . . . . . . . . . . . . . . . . . . . 363 Change operation/unit procedure unit requirements . . . . . . . . . . . . . 364 Creating a procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 Changing procedure unit requirements . . . . . . . . . . . . . . . . . . . . . . 367
xv
Smart binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 Creating binding requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 Creating binding preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 Creating binding expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 Recipe header data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 Adding recipe header data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 Saving recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 Copying recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 Creating a copy of a recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 Using the Save As function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 Chapter 5 Building a Sequential Function Chart . . . . . . . . . . . . . . . . . . . . . . . . . 377 Inserting steps into an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 Inserting timer steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 Manually adding steps to an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 Adding a parallel step to an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 When parallel steps require the same dedicated resource . . . . . . . . . . 380 Adding a branch structure to an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 Adding transitions to an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 Defining a step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 Defining a phase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 Defining an operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 Defining a unit procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 Linking SFC components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 Removing a link from an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 Assigning a transition expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 Removing a step from an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 Creating material loops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 Recipe comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 Adding comments to an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 Associating/disassociating recipe comments . . . . . . . . . . . . . . . . . . . 386 Deleting recipe comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
xvi
Contents
Chapter 6 Building a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 Inserting steps into a table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 Adding a parallel step to a table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 Adding a step before and after parallel steps . . . . . . . . . . . . . . . . . . . . 390 Defining a step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 Defining a phase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 Defining an operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 Defining a unit procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 Removing a step from a table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 Chapter 7 Using Bind Expressions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393 Expression operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 Data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 Expression Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 Chapter 8 Configuring Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Phase parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Recipe parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Step formula values and phase report limits . . . . . . . . . . . . . . . . . . . . . 399 Material recipe parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 Material report parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 Field definitions for parameter value entry/report limit entry. . . . . . . 401 Assigning parameter values and phase report limits . . . . . . . . . . . . . . . . 404 Assigning formula values to Timer steps . . . . . . . . . . . . . . . . . . . . . 405 Recipe properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 Aggregating report values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 Chapter 9 Using Expressions in Parameters and Reports . . . . . . . . . . . . . . . . . . . 411 Evaluation of recipe parameter expressions . . . . . . . . . . . . . . . . . . . . . 411 Validation of parameters with expressions . . . . . . . . . . . . . . . . . . . . 412 Overriding a calculated recipe parameter expression value. . . . . . . . . 412
xvii
Evaluation of report parameter expressions . . . . . . . . . . . . . . . . . . . . . . 412 Overriding a calculated report expression. . . . . . . . . . . . . . . . . . . . . 412 Configuring expression values in recipe and report parameters . . . . . . . . . 413 Expression operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 Parameter expression functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Chapter 10 Implementing Phase Link Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 Example application of message partners . . . . . . . . . . . . . . . . . . . . . . . 418 Creating a phase link group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 Deleting a phase link group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 Chapter 11 Completing and Maintaining Recipes . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Verifying a recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 What gets verified?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Validating an SFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 Running SFC validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 Setting allowable SFC permutations. . . . . . . . . . . . . . . . . . . . . . . . . 423 SFC validation error types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 Releasing a recipe to production . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 Rebuilding the recipe directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 Recipe maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Page setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Generate reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Removing a recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 Translating recipes created in previous versions . . . . . . . . . . . . . . . . . . . 433 Chapter 12 Recipe Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 RDB format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 Creating the Masterrecipes database . . . . . . . . . . . . . . . . . . . . . . . . 436 XML format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 About the XML recipe schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 Setting the recipe file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
xviii
Contents
Chapter 13 Importing and Exporting Recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 Importing recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 Selecting a directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 Selecting a SQL Server database . . . . . . . . . . . . . . . . . . . . . . . . . . 441 Exporting recipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 Importing or exporting recipes with the same name . . . . . . . . . . . . . . . . 443 Batch View Users Guide Chapter 1 Introducing the FactoryTalk Batch View . . . . . . . . . . . . . . . . . . . . . . . 447 Document Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 Using the FactoryTalk Batch Views Security . . . . . . . . . . . . . . . . . . . . . 447 Opening FactoryTalk Batch View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 Logging on to FactoryTalk Batch View . . . . . . . . . . . . . . . . . . . . . . . 449 FactoryTalk Batch View Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 FactoryTalk Batch View Toolbar. . . . . . . . . . . . . . . . . . . . . . . . . . . 450 FactoryTalk Batch View Command Buttons. . . . . . . . . . . . . . . . . . . . 451 Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 Communication Status for the FactoryTalk Batch Server and Data Servers . 452 Viewing the Conversation Status of all Data Servers. . . . . . . . . . . . . . 453 Communication Status for the FactoryTalk Batch Server and Material Server 454 Processing Batches Without the Material Server . . . . . . . . . . . . . . . . 455 Phase Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 Reestablishing Communications with the Material Server . . . . . . . . . . 458 Setting the System Configuration and Defaults . . . . . . . . . . . . . . . . . . . 459 Modifying the Configuration of the FactoryTalk Batch View. . . . . . . . . 459 Using the Batch List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 Adding a Batch to the Batch List . . . . . . . . . . . . . . . . . . . . . . . . . . 469 Removing a Batch from the Batch List . . . . . . . . . . . . . . . . . . . . . . . 471 Adding a Comment to an Electronic Batch Record . . . . . . . . . . . . . . . 471
xix
Chapter 2 Using the FactoryTalk Batch View Windows . . . . . . . . . . . . . . . . . . . . . 473 Using the Procedure as SFC Window . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 Procedural Hierarchy View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 SFC Area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 Auxiliary Index View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 Using the SFC Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480 Using the Procedure as Table Window. . . . . . . . . . . . . . . . . . . . . . . . . . 480 Recipe Table Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 Using the Event Journal Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 Opening an Event Journal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 Filtering Event Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 Using the Unacknowledged Prompts Window . . . . . . . . . . . . . . . . . . . . . 483 Acknowledging a Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 Acknowledging A Material Phase Step Prompt . . . . . . . . . . . . . . . . . . 484 Using the Signature List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485 Acknowledging a Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 Acknowledging a Set Parameter Signature . . . . . . . . . . . . . . . . . . . . 487 Acknowledging a Command Signature . . . . . . . . . . . . . . . . . . . . . . . 488 Additional Signature Request Types . . . . . . . . . . . . . . . . . . . . . . . . . 489 Cancelling a Signature Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 Signoff Failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 Using the Phase Control Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 Process Cell or Unit Display Area. . . . . . . . . . . . . . . . . . . . . . . . . . . 491 Phase List Display Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492 Phase Specific Information Display Area . . . . . . . . . . . . . . . . . . . . . . 492 Commanding Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493 Run an Individual Phase in AUTO Mode . . . . . . . . . . . . . . . . . . . . . . . 495 Performing Semi-Auto Phase Processing . . . . . . . . . . . . . . . . . . . . . . 496 Using the Arbitration Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497 Acquiring and Releasing Resources . . . . . . . . . . . . . . . . . . . . . . . . . 498 Using the Alarm Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 Viewing Alarm Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 Clearing Failure Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 Using the Phase Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
xx
Contents
Chapter 3 Commanding a Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 Starting a Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 Starting a Batch in the Batch List View . . . . . . . . . . . . . . . . . . . . . . 501 Starting a Batch in the SFC View or Table View. . . . . . . . . . . . . . . . . 501 Holding a Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 Holding a Batch in the Batch List View . . . . . . . . . . . . . . . . . . . . . . 502 Holding a Batch in the SFC View or Table View . . . . . . . . . . . . . . . . . 502 Restarting a Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 Restarting a Batch in the Batch List View. . . . . . . . . . . . . . . . . . . . . 502 Restarting a Batch in the SFC View or Table View . . . . . . . . . . . . . . . 502 Aborting a Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 Aborting a Batch in the SFC View or Table View . . . . . . . . . . . . . . . . 503 Stopping a Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 Stopping a Batch in the Batch List Window. . . . . . . . . . . . . . . . . . . . 503 Stopping a Batch in the SFC View or Table View . . . . . . . . . . . . . . . . 503 Overriding an Expression Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 Forcing a Transition to Fire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505 Recipe Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 AUTO Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 SEMI-AUTO Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 MANUAL Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 Timer Procedure Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 Placing a Batch in AUTO Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508 Performing Semi-Auto Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508 Placing a Batch in MANUAL Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 Commanding Timer Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510 Changing the Setpoint of a Timer Step . . . . . . . . . . . . . . . . . . . . . . 510 Performing an Active Step Change. . . . . . . . . . . . . . . . . . . . . . . . . . . . 511 Performing Manual Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 Performing Material Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 Performing Prompted Binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
xxi
Disconnecting an Equipment Module . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 Performing Cross Invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 Chapter 4 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 Batch Archiver Users Guide Chapter 1 Introducing the FactoryTalk Batch Archiver. . . . . . . . . . . . . . . . . . . . . 523 Document Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 System Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 Implementation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 Chapter 2 Working with Electronic Batch Records . . . . . . . . . . . . . . . . . . . . . . . . 527 Electronic Batch Record Interpretation Examples . . . . . . . . . . . . . . . . . . 527 Chapter 3 Creating a Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531 Creating an SQL Server Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . 532 Creating the SQL Server Batch History Database . . . . . . . . . . . . . . . . 532 Creating the Batch Archiver ODBC Connection to SQL Server . . . . . . . . 532 Chapter 4 Implementing the FactoryTalk Batch Archiver . . . . . . . . . . . . . . . . . . . 537 Configuring the Reporting Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 Configuring the Batch Archiver Service for Incremental Archiving . . . . . . . 539 Assigning a User Account to the Batch Archiver Service . . . . . . . . . . . . 540 Enabling the Batch Archiver Service. . . . . . . . . . . . . . . . . . . . . . . . . 541 Configuring the FactoryTalk Batch Archiver for End-of-Batch Archiving . . . . 541 Configuring the FactoryTalk Batch Archiver for Optimal Performance . . . . . 542 Configuring the FactoryTalk Batch Archiver for Optimal Record Transfer 542 Configuring the FactoryTalk Batch Archiver for Optimal Data Access . . . 543 Running the FactoryTalk Batch Archiver . . . . . . . . . . . . . . . . . . . . . . . . 543 Stopping or Pausing the Batch Archiver . . . . . . . . . . . . . . . . . . . . . . 544 Chapter 5 Using a Custom Archiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545 Creating a Custom Archiver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545 Arguments From the Batch Server . . . . . . . . . . . . . . . . . . . . . . . . . . 545 ArchQue.txt File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
xxii
Contents
Developing the Output Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546 BATCHHIS Database Table Schema . . . . . . . . . . . . . . . . . . . . . . . . . 547 Configuring the Custom Archiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551 Chapter 6 Configuring the FactoryTalk Batch Archiver for FactoryTalk Historian Classic for Batch . . . . . . . . . . . . . . . . . . . . . . . 553 What is FactoryTalk Historian Classic for Batch?. . . . . . . . . . . . . . . . . . . 553 Creating a Data Source for FactoryTalk Historian Classic for Batch . . . . . . 553 Updating the Database Connection String . . . . . . . . . . . . . . . . . . . . 554 Verifying the Database Connection String . . . . . . . . . . . . . . . . . . . . 554 Batch Archiver Event Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554 FactoryTalk Batch Event Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . 555 FactoryTalk Batch Material Manager Event Filters . . . . . . . . . . . . . . . 555 Batch Reporting Values for Optimum Performance (SQL Server Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555 Recommendations for Optimum Data Access . . . . . . . . . . . . . . . . . . 556 Appendix A Windows Event Log Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557 ActiveX Controls Users Guide Chapter 1 Introducing the ActiveX Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . 561 Document Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561 Introducing the ActiveX Controls Library . . . . . . . . . . . . . . . . . . . . . . . 561 Installing the ActiveX Controls Library . . . . . . . . . . . . . . . . . . . . . . . . . 562 Using DCOM for Security and Distributed Communications. . . . . . . . . . 562 Redistributing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 Using the ActiveX Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563 Version Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564 Using the ActiveX Controls in FactoryTalk View SE . . . . . . . . . . . . . . . . . 564 VBA Code Example for RefreshSecurityToken . . . . . . . . . . . . . . . . . . 565 Chapter 2 Using the ControlRecipeList Control . . . . . . . . . . . . . . . . . . . . . . . . . 567 ControlRecipeList Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 Using the ControlRecipeList Shortcut Menu . . . . . . . . . . . . . . . . . . . . . . 568 Shortcut Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
xxiii
Logging on to the ControlRecipeList Control. . . . . . . . . . . . . . . . . . . . . . 569 Commanding a Control Recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 Adding a Control Recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 Starting a Control Recipe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 Changing the State of a Control Recipe . . . . . . . . . . . . . . . . . . . . . . 574 Changing the Mode of a Control Recipe . . . . . . . . . . . . . . . . . . . . . . 574 Removing a Control Recipe from the ControlRecipeList . . . . . . . . . . . . 574 Performing Cross Invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 Processing Batches Without the Material Server . . . . . . . . . . . . . . . . . . . 575 Create Control Recipe Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576 Chapter 3 Using the PromptsList Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577 PromptsList Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577 Using the PromptsList Shortcut Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 578 Logging in to the PromptsList Control . . . . . . . . . . . . . . . . . . . . . . . . . . 579 Acknowledging a Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579 Acknowledging a Material Phase Step Prompt . . . . . . . . . . . . . . . . . . 580 Performing Cross Invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581 Chapter 4 Using the SignatureList Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583 SignatureList Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583 Using the SignatureList Control Shortcut Menu . . . . . . . . . . . . . . . . . . . . 585 Logging in to the SignatureList Control . . . . . . . . . . . . . . . . . . . . . . . . . 585 Acknowledging a Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585 Cancelling a Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587 Using the SignatureList Control in an External Application . . . . . . . . . . . . 587 Chapter 5 Using the ProcedureView Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . 591 Table View Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592 SFC View Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593 Using the ProcedureView Shortcut Menu . . . . . . . . . . . . . . . . . . . . . . . . 593 Logging on to the ProcedureView Control . . . . . . . . . . . . . . . . . . . . . . . 595 Navigating the ProcedureView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595 Using the SFC View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595 Using the Table View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
xxiv
Contents
Commanding a Control Recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596 Starting a Control Recipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596 Changing the State of a Control Recipe . . . . . . . . . . . . . . . . . . . . . . 596 Changing the Mode of a Control Recipe . . . . . . . . . . . . . . . . . . . . . . 597 Commanding Timer Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 Viewing Control Recipe Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . 598 Viewing the Parameter Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598 Viewing the Report Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 Viewing the Recipe Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 Viewing the Binding Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 Performing an Active Step Change. . . . . . . . . . . . . . . . . . . . . . . . . . . . 601 To Perform an Active Step Change . . . . . . . . . . . . . . . . . . . . . . . . . 601 Performing Manual Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602 Bind a Unit Procedure to a Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . 603 Performing Material Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603 Performing Cross Invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605 Chapter 6 Using the TimerView Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607 Timer View Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607 Navigating the TimerView. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607 Using the TimerView shortcut menu . . . . . . . . . . . . . . . . . . . . . . . . 608 Logging on to the TimerView control . . . . . . . . . . . . . . . . . . . . . . . 609 Using the Timer Step dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . 610 Changing a Setpoint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 Using Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611 Timer step filter patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
xxv
xxvi
Batch
ADMINISTRATORS GUIDE
xxvii
CHAPTER 1
Document Organization
This guide presents information required for the configuration and administration of a FactoryTalk Batch system. The following subjects are included:
Configuring International Settings, Communications, Security, and Batch Auditing Using the FactoryTalk Batch Service Manager, Server, Phase Simulator, and Windows Event Log Troubleshooting
CHAPTER 2
3. Select Share this folder to enable entry of the share information. The directory name is copied into the Share name box. You can change the share name or accept the default. The default User limit is Maximum allowed. There is no need to change this value.
4. Click the Permissions button. The Permissions for <Folder Name> dialog box opens, allowing you to assign the type of access for each user or user group that requires access to this directory.
The default permission assignment is Everyone with Full Control. You may want to remove this assignment and add specific users and/or user groups with limited access.
5. Click the Add button. The Select Users, Computers, or Groups dialog box opens.
6. Type the user or user group name that requires access to the shared directory. 7. Click the OK button. 8. Repeat steps 6 and 7 for each user or user group. Ensure that the user account(s) used by the FactoryTalk Batch Server and the Archiver are added. 9. Click OK to close the Select Users, Computers, or Groups dialog box. 10. In the Group or user names section, select a User or Group. 11. In the Permissions section, select the permissions for the user or group, click Apply. Repeat steps 10 and 11 for each user or user group.
12. Click OK to return to the <Folder Name> Properties dialog box. 13. Click OK to close the <Folder Name> Properties dialog box.
CHAPTER 3
FactoryTalk Batch Server User Account FactoryTalk Batch System Configuration Setting Security on Folders or Files FactoryTalk Security for the Batch Clients Configure FactoryTalk Batch View Security Configure Equipment Editor and Recipe Editor Security FactoryTalk Batch Default Policy Settings
If the password ever expires, the Batch Server service eventually fails to log on.
If this account is ever disabled/deleted, the Batch Server service eventually fails to log on.
If the Server user account is a domain account, remove any local user accounts with the same name.
The Server user account/user group must exist on all workgroup computers
If you are using a local account and expect that account to have access to resources on other computers in a workgroup environment, you must create accounts with the same name and password on each computer in the workgroup.
7
Administrators group batchsvr_group Batch COM+ Application FactoryTalk Batch Server service FactoryTalk Batch Archiver service eProcedure Server service (eProcedure Server installation)
The services for the FactoryTalk Batch Server, FactoryTalk Batch Archiver, eProcedure Server, and the Batch COM+ Application require identical user accounts to support the FactoryTalk Batch Server functionality. If an invalid FactoryTalk Batch Server user account is entered during installation the Batch COM+ Application fails to install. (See Adding the Batch COM Service for more information.) If you change the FactoryTalk Batch Server user account once the installation is complete, you must configure your FactoryTalk Batch system to use the new Server user name and/ or password. (See Changing the FactoryTalk Batch Server User Account for more information.)
8
batchsvr.exe (Batch Server installs) batchvew.exe (Batch Client installs) DaClient.exe EventClientMultiplexer.exe EventServer.exe iexplore.exe OPCEnum.exe
Port 135 TCP Port 80 TCP (eProcedure Client installs) RnaDiagnosticsSrv.exe RnaDiagReceiver.exe RnaDirServer.exe RsvcHost.exe VStudio.exe
If you enable the Windows Firewall after you install the applications, run the FactoryTalk Windows Firewall Configuration Utility on each computer in your FactoryTalk Batch system to add the exceptions. To run the FactoryTalk Windows Firewall Configuration Utility complete the following steps.
Click Start, point to All Programs > Rockwell Software > FactoryTalk Tools, and then click Windows Firewall Configuration Utility. (See the FactoryTalk Batch Installation Guide or the FactoryTalk eProcedure Installation Guide for more information.)
Add the Server user account to the FactoryTalk Batch Archiver service if you are using the Archiver in incremental mode. Add the Server user account to the eProcedure Server service if eProcedure is part of your FactoryTalk Batch system.
10
7. Click OK to return to the Properties dialog box. 8. From the Group or user name: list, select a User or Group, and then select the permissions in the Permissions area. Repeat for each User or Group. 9. Click OK.
11
their features. For a complete list of FactoryTalk Batch secured resources and their default product policy settings, see FactoryTalk Batch Default Policy Settings. The following information is specific to configuring FactoryTalk Security for the FactoryTalk Batch clients. For information on securing your FactoryTalk system as a whole, see FactoryTalk Help. To open FactoryTalk Help complete the following steps: click Start, point to All Programs > Rockwell Software > FactoryTalk Tools, and then click FactoryTalk Help. The FactoryTalk Services Platform installation process:
Creates a FactoryTalk Local Directory and a FactoryTalk Network Directory on the computer. When the install process finishes, both directories are fully configured
Allows any Windows Administrator user account to log on to either directory. The
installation process automatically adds the local Windows Administrators group to the FactoryTalk Administrators group in each FactoryTalk Directory.
Allows any authenticated Windows user to log on to the FactoryTalk Local Directory. The installation process automatically adds all members of the local
Allows all new user accounts full access permissions. The installation process
automatically sets system policies to allow all new user accounts added to either directory full access to that directory by default.
12
Delete the Windows Authenticated Users group from the Local Directory. Secure the FactoryTalk Batch Configuration Options product policies in the Local Directory to avoid tampering or unauthorized changes. (See Product Policies Only in the Local FactoryTalk Directory for more information.) Create new FactoryTalk user accounts and groups in the FactoryTalk Directory.
Create user accounts and/or groups to secure the FactoryTalk Batch clients. (For more information see FactoryTalk Help.)
Add user accounts and groups created in Windows to the FactoryTalk Directory. Windows accounts added to the FactoryTalk Directory are Windows-Linked user
Remove the All Users group from the FactoryTalk Batch product policies. The FactoryTalk Services Platform installation process adds the All Users group to all FactoryTalk product policies. To secure FactoryTalk Batch, remove or restrict the All Users group for FactoryTalk Batch product policies. For example, to restrict access to the FactoryTalk Batch View windows, remove the All Users group from the associated product policies and then add the necessary user accounts. (See Configuring Security for the FactoryTalk Batch View Windows for more information.) Add user accounts and groups to the FactoryTalk Batch product policies. To
secure FactoryTalk Batch resources, add only the necessary user accounts and groups to the corresponding product policies. For a complete list of FactoryTalk Batch product policies see FactoryTalk Batch Default Policy Settings.
13
1. Open the FactoryTalk Administration Console and log on to the appropriate FactoryTalk Directory. 2. Expand System > Policies > Product Policies > Batch > BatchView & ActiveX.
14
4. elect the policy setting you want to configure and then click the corresponding browse button.
select a user or group and then click Remove. allow/deny a user or group access to the feature by selecting or clearing the corresponding check box and then clicking OK.
Product policies do not inherit security settings. When specifying permissions for product policies, clearing both the Allow and Deny check boxes denies access to the product feature.
add a user account or user group by clicking Add. This option displays the Select User and Computer dialog box. select a user, user group or computer and then click OK. click Create New to create and then add a new user, user group or computer group.
15
These policy settings are defined in FactoryTalk Directory for each command button within FactoryTalk Batch View and every phase command issued from the Phase Control window.
When the Confirm feature is enabled for a command, only active user accounts assigned to the Command are allowed to execute the command. Users validated in the Log on to Confirm User dialog box are not logged on to FactoryTalk Batch View.
The <Command> Confirm policy settings are found in the following locations:
FactoryTalk Directory\Local | Network\ System\Policies\Product Policies\Batch\BatchView and ActiveX\Commands FactoryTalk Directory\Local | Network\ System\Policies\Product Policies\Batch\BatchView and ActiveX\Phase Commands
Configuring Security for FactoryTalk Batch Commands To allow only specified users to issue commands against a batch or a phase, add the appropriate users and/or user groups to the Command or Phase Command policy setting you want to secure and then remove or restrict the All Users group. To add a user and/or user group to a Command policy setting, complete the following steps. 1. Open the FactoryTalk Administration Console and log on to the appropriate FactoryTalk Directory. 2. Expand System > Policies > Product Policies > Batch > BatchView & ActiveX. 3. Right-click Commands and then select Properties.
4. Select the policy setting you want to configure and then click the corresponding browse button.
16
select a user or group and then click Remove. allow/deny a user or group access to the feature by selecting or clearing the corresponding check box and then clicking OK. add a user account or user group by clicking Add. This option displays the Select User and Computer dialog box. select a user, user group, computer or computer group and then click OK. click Create New to create and then add a new user, user group, computer or computer group.
Enabling FactoryTalk Batch View Confirm Settings If you assign specific users and/or groups to a batch command or phase command and enable the corresponding Confirm policy setting, then only the specified users are allowed to issue the command. To configure Phase Command or Command policy settings, complete the following steps. 1. Open the FactoryTalk Administration Console and log on to the appropriate FactoryTalk Directory. 2. Expand System > Policies > Product Policies > Batch > BatchView & ActiveX.
17
4. Scroll to the BatchView and ActiveX - Phase Commands (or Commands) Confirmations policy settings. Select the policy setting and then click the corresponding drop-down list box.
5. Select True to require a user log on each time the command button is clicked. Select False if no log on is required. 6. Click OK.
Restart all FactoryTalk Batch components to update changes made in the FactoryTalk Directory.
18
3. Select a screen saver from the list, and then enter the automatic log off time period in the Wait box.
19
2. Create a Visual Basic form that allows a user to enter a user name and a password. Add two Command buttons, one for user log-ons and another to log off. The following is an example of a Visual Basic form:
3. Create a new COM object and add code to support the log on functionality. The following code sample demonstrates how to create a COM object in Visual Basic that is used for logging on and off of FactoryTalk Batch View.
4. Save the project and make an executable file. Run the executable to log users on and off of the FactoryTalk Batch View.
DDE is not a supported communication protocol with the FactoryTalk Batch suite of products.
20
Any value other than 0 is an error and an entry is recorded in the Batchvew.log file. If the .dll fails to load, the function is not found in the .dll, or the function causes an exception, the log on mechanism is disabled. The standard logon dialog box must then be used. Use the FactoryTalk Administration Console to modify the required security policy settings for enabling an external security device. These policy settings are located in the FactoryTalk Local Directory. (See Product Policies Only in the Local FactoryTalk Directory for more information.) 1. Run the FactoryTalk Administration Console and log on to the Local Directory. 2. Expand System > Policies > Product Policies > Batch > BatchView & ActiveX > Configuration. 3. Right-click Options and then select Properties. 4. Edit the following policy settings: Enabled = True Name of DLL=<YourDLLNameWithPath> Name of Function=<FunctionNameInDLL>
Restart all FactoryTalk Batch components to update changes made in the FactoryTalk Directory.
The FactoryTalk Batch Equipment Editor and Recipe Editor also support an external security device. The product policies used to configure an external security device for the Equipment Editor and Recipe Editor are created in the following FactoryTalk Local Directory locations. (See Modifying the Equipment Editor Configuration Options for more information.)
System > Policies > Product Policies > Batch > Equipment Editor > Configuration > Options - External Login System > Policies > Product Policies > Batch > Recipe Editor > Configuration > Options - External Login
21
To tighten security remove the All Users group from the Equipment Editor and the Recipe Editor product policies in the FactoryTalk Directory. (See FactoryTalk Batch Default Policy Settings for more information.) The FactoryTalk Batch Equipment Editor and Recipe Editor support the use of an external security device, such as a retinal scanner. (See Using an External Security Device for more information.) In addition to FactoryTalk Security, you can configure Windows security on the FactoryTalk Batch Equipment Editor and Recipe Editor files and folders in Windows Explorer. (See Setting Security on Folders or Files for more information.) If you are using RDB recipes that are stored in SQL Server, RDB security can also be configured.
4. Select the policy setting you want to configure and then click the browse button. 5. In the Configure Securable Action dialog box you can:
select a user or group and then click Remove. allow/deny a user or group access to the feature by selecting or clearing the corresponding check box and then clicking OK. add a user account or user group by clicking Add. This option displays the Select User and Computer dialog box.
22
select a user, user group, computer or computer group and then click OK. click Create New to create and then add a new user, user group or computer group.
4. From the Options Properties dialog box, configure the policy settings and then click OK.
Restart all FactoryTalk Batch components to update changes made in the FactoryTalk Directory.
23
Network Directories, except for the Configuration Options which are only created in the Local Directory.
Enabled
Enables/disables using an external security device to provide a user name and password for logging on to the FactoryTalk Batch View. If the Enabled value is False, the external security device feature is disabled. If the Enabled value is True, the external security device feature is enabled. Default = False. The dynamic-link library file (*.dll) name that contains a function used to collect a user name and password from a custom log-on dialog box. This value is required if the Enabled policy setting for the external security device is True. The default value is blank. The function name that collects a user name and password from an external security device. This function must be located in the dynamic link library file (*.dll) defined by the Name of DLL policy setting. The default value is blank.
Name of DLL
Name of Function
NetworkSecurity
When the Network Security value is True, FactoryTalk Batch View and ActiveX controls use the security policy settings defined in the specified Network Directory. When the Network Security policy setting is False, the View and ActiveX controls use the security policy settings defined in the Local Directory. Default = True.
24
Product Policy Descriptions When the policy setting is True users are allowed to log on once per FactoryTalk directory on a given computer. Once a user is logged on to FactoryTalk, all FactoryTalk-enabled products and components subsequently launched in that directory and on that computer automatically use the logged on users credentials. Default = True.
Single-SignOn
Enabled
Enables/disables using an external security device to provide a user name and password for logging on to the FactoryTalk Batch Equipment Editor. If the Enabled value is False, the external security device feature is disabled. If the Enabled value is True, the external security device feature is enabled. Default = False. The dynamic-link library file (*.dll) name that contains a function used to collect a user name and password from a custom logon dialog. This value is required if the Enabled policy setting for the external security device is True. The default value is blank. The function name that collects a user name and password from an external security device. This function must be located in the dynamic link library file (*.dll) defined by the Name of DLL policy setting. The default value is blank.
Name of DLL
Name of Function
Determines which FactoryTalk Directory is used to configure security for Signature Templates and validate permissions for Signature Signoffs. When the policy setting value is True the specified FactoryTalk Network Directory is used to support Electronic Signature security. Default = True.
25
Product Policy Descriptions When the Network Security value is True, FactoryTalk Batch Equipment Editor uses the security policy settings defined in the specified Network Directory. If the Network Security policy setting is False, FactoryTalk Batch Equipment Editor uses the security policy settings defined in the Local Directory. Default = True.
Network Security
Single-SignOn
When the policy setting is True users are allowed to log on once per FactoryTalk directory on a given computer. Once a user is logged onto FactoryTalk, all FactoryTalk-enabled products and components subsequently launched in that directory and on that computer automatically use the logged on users credentials. Default = True.
Enabled
Enables/disables using an external security device to provide a user name and password for logging on to the FactoryTalk Batch Recipe Editor. If the Enabled value is False, the external security device feature is disabled. If the Enabled value is True, the external security device feature is enabled. Default = False. The dynamic-link library file (*.dll) name that contains a function used to collect a user name and password from a custom logon dialog. This value is required if the Enabled policy setting for the external security device is True. The default value is blank. The function name that collects a user name and password from an external security device. This function must be located in the dynamic link library file (*.dll) defined by the Name of DLL policy setting. The default value is blank.
Name of DLL
Name of Function
26
Network Security
When the Network Security value is True, the FactoryTalk Batch Recipe Editor uses the security policy settings defined in the specified Network Directory. If the Network Security policy setting is False, the FactoryTalk Batch Recipe Editor uses the security policy settings defined in the Local Directory. Default = True.
Single-SignOn
When the policy setting is True users are allowed to log on once per FactoryTalk directory on a given computer. Once a user is logged onto FactoryTalk, all FactoryTalk-enabled products and components subsequently launched in that directory on that computer automatically use the logged on users credentials. Default = True.
27
Product Policy Descriptions These policy settings are used to secure the ten FactoryTalk Batch View windows and the Exit, Configuration, and Help buttons. Users must have Allow permissions to access the View windows and buttons. Default = All Users have access. To tighten security, remove or restrict the All Users group and then add the necessary user accounts to the policy settings.
Alarm Summary - Access Alarm Summary Window Arbitration - Access the Arbitration window Batch List - Access the Batch List window Configuration - Configure the Batch View Event Journals - Access the Event Journal window Exit - Exit the FactoryTalk Batch View Help - Activate help file Phase Control - Access the Phase Control window Phase Summary - Access Phase Summary window Procedure as SFC - Access SFC View window Procedure as Table - Access Table View window Prompts - Access Unacknowledged Prompts window Signatures - Access Signature List window Configuration - Confirm
View - Confirmations
This policy setting is used to secure access to the System Configuration and Defaults dialog box in the FactoryTalk Batch View. If the Configuration-Confirm policy is True, then only the users defined in the Configuration policy setting are allowed access to System Configuration and Defaults dialog box. Users are validated using the Log On to FactoryTalk dialog box. Default = False.
28
Product Policy Descriptions Phase commands are secured objects which can be configured to require user validation prior to execution. To require user validation for a phase command, set the associated Confirm policy setting to True. To tighten security remove or restrict the All Users group and then add the necessary user accounts to the policy setting. Default = All Users have access.
Abort - Abort a phase Ack - Acknowledge a phase prompt Acquire - Acquire a phase ClearFail - Clear all failures Disconnect - Disconnect an equipment module Hold - Hold a phase Pause - Pause a phase Phase Auto Mode - Place phase in auto mode Phase Semi-Auto Mode - Place phase in semi-auto Release - Release phase Reset - Reset phase Restart - Restart phase Resume - Resume phase Start - Start phase Stop - Stop phase Abort - Confirm Ack - Confirm Acquire - Confirm ClearFail - Confirm Disconnect - Confirm Hold - Confirm Pause - Confirm PhaseAuto Mode - Confirm PhaseSemi-AutoMode - Confirm Release - Confirm Reset - Confirm Restart - Confirm Resume - Confirm Start - Confirm Stop - Confirm
If a Phase Command - Confirm policy is True, then only the users defined in the associated Phase Command policy setting are allowed to execute the phase command. Users are validated using the Log On to Confirm User dialog box. Phase commands are issued from the Manual Phase Control window in FactoryTalk Batch View. Confirm settings are configured separately for each phase command. Users validated in the Log on to Confirm User dialog box are not logged on to the FactoryTalk Batch View. Default = False.
29
Product Policy Descriptions Batch commands are secured objects which can be configured to require user validation prior to execution. To require user validation for a batch command, set the associated Confirm policy setting to True. To tighten security remove or restrict the All Users group and then add the necessary user accounts to the policy setting. Default = All Users have access.
Abort - Abort batch Ack - Acknowledge a prompt Acquire - Acquire a resource Add Batch - Add a Batch Auto - Place batch in auto mode Bind - Bind step to unit BindAck - Acknowledge a bind prompt ClearFail - Clear all failures Comment - Operator comment to Event Journal Disconnect - Disconnect an equipment module Hold - Place batch on hold Manual - Place batch in manual mode MatSvrControl - Control the Material Server ParamChange - Change parameter value ReactivateStep - Change the active eProcedure step Release - Release a resource Remove - Remove a batch Reorder - Reprioritize needed resources list Restart - Restart batch Resume - Resume batch Semi-Auto - Place batch in semi-auto mode Start - Start batch Step - Change the active step Stop - Stop the batch
30
Product Policy Descriptions If a Command - Confirm policy is True, then only the users defined in the associated Command policy setting are allowed to execute the batch command. Users are validated using the Log On to Confirm User dialog box. Users validated in the Log on to Confirm User dialog box are not logged on to the FactoryTalk Batch View. Default = False.
Abort - Confirm Ack - Confirm Acquire - Confirm Add Batch - Confirm Auto - Confirm Bind - Confirm BindAck - Confirm ClearFail - Confirm Comment - Confirm Disconnect - Confirm Hold - Confirm Manual - Confirm MatSvrControl - Confirm ParamChange - Confirm ReactivateStep - Confirm Release - Confirm Remove - Confirm Reorder - Confirm Restart - Confirm Resume - Confirm Semi-Auto - Confirm Start - Confirm Step - Confirm Stop - Confirm
\\System\Policies\Product Policies\Batch
Security Objects Equipment Editor - Access Modes
Full Edit
Once logged on the user can edit and save changes to the Area Model. To tighten security remove or restrict the All Users group and then add the necessary user accounts. Default = All Users have access.
31
\\System\Policies\Product Policies\Batch
Security Objects
Product Policy Descriptions Once logged on the user can view and edit the Area Model but cannot save changes. Default = All Users have access.
ViewOnly
Full Edit
Once logged on the user can edit and save changes to recipes. To tighten security remove or restrict the All Users group and then add the necessary user accounts. Default = All Users have access.
ViewOnly
Once logged on the user can view and edit recipes but cannot save changes. Default = All Users have access.
32
CHAPTER 4
33
The configuration information found in the FactoryTalk Administration Console specifies the source for the Audit Policy, which is the configuration information that specifies if auditing is enabled or disabled. This configuration information exists for the FactoryTalk Batch Equipment Editor and the Recipe Editor.
1. Open the FactoryTalk Administration Console and log on to the Network Directory or Local Directory. 2. Point to System > Policies > System Policies. 3. Right-click Audit Policy, and then click Properties. The Audit Policy Properties dialog box opens. 4. Select Audit changes to configuration and control system and set it to Enabled. Auditing is enabled the next time you run the FactoryTalk Batch Recipe or Equipment Editor.
Restart all FactoryTalk Batch components to update changes made in the FactoryTalk Directory.
34
menu changes and Options menu changes do not generate audit messages. The following events are audited and occur when the Area Model is saved:
Message Type Area Model Event Invoke the Equipment Editor Open an existing area model Create a new area model Save an area model Edit/update an area model property Delete an area model Add a signature template Delete a signature template Update a signature template Update a command verification policy Data Server Add an OPC server Delete an OPC server Edit/update an OPC server property Add a Logix5000 CIP server Delete a Logix5000 CIP server Edit a Logix5000 CIP server Add an FTD server Delete an FTD server Edit/update an FTD server property Enumeration Set Create an enumeration set Delete an enumeration set Edit/update an enumeration set property Enumeration Add an enumeration Delete an enumeration Edit/update an enumeration property Resource Class Add a resource class Delete a resource class Edit/update a resource class property Resource Add a resource Delete a resource Edit/update a resource property Process Cell Class Add a process cell class Copy a process cell class Delete a process cell class Edit/update a process cell class property
35
Event Add a process cell Copy a process cell Delete a process cell Edit/update a process cell property
Unit Attribute
Add a unit attribute Delete a unit attribute Edit/update a unit attribute property
Unit
Add a unit Copy a unit Edit a unit Delete a unit Edit/update a unit property
Global Unit Binding Requirements Unit Flow Path Equipment Phase Class (Recipe Phase)
Add global unit attribute Edit global unit attribute Delete global unit attribute Link units with a flow path Unlink units with a flow path Add an equipment phase class Copy an equipment phase class Delete an equipment phase class Edit/update an equipment phase class property Edit/update an equipment phase class control strategy set of parameters Edit/update an equipment phase class optional material parameters property Edit/update an equipment phase class control strategy set of reports Edit/update an equipment phase class control strategy
Add an equipment phase Copy an equipment phase Delete an equipment phase Edit/update an equipment phase property Edit/update an equipment phases equipment module server property Reset an equipment phases tags to default values Share an equipment phase between units
Recipe Parameter
Add a recipe parameter Delete a recipe parameter Edit/update a recipe parameter property
ReportParameter
Add a report parameter Delete a report parameter Edit/update a report parameter property
36
Event Add a phase message Delete a phase message Edit/update a phase message property
Synchronize a phase Add a tag class Delete a tag class Edit/update a tag class property
Unit Attribute Tag Add a unit attribute tag Delete a unit attribute tag Edit/update a unit attribute tag property Container Association Add a container association Delete a container association Edit/update a container association property Instruction Configuration Edit/update an instruction configuration property
37
Event Add a text box Edit a text box (only if comment actually changes) Delete a text box Associate a text box Disassociate a text box
Add a recipe formula parameter to a step Delete a recipe formula parameter from a step Edit/update a recipe formula parameter of a step Edit/update a formula values non-origin properties Edit/update a formula values origin property Edit/update a formula values value property for deferred parameters
Formula Value
Report Limit
Bind Requirement Add/update a bind requirement Delete a bind requirement* Bind Preference Recipe Transition Add/update bind preference Delete bind preference Add a transition to a recipe Delete a transition to a recipe Edit/update a recipe transition Link Group Add a recipe link group Delete a recipe link group Edit/update a recipe link group Equipment Requirement Add an equipment requirement to a recipe Delete an equipment requirement of a recipe Edit/update procedure-only equipment requirement properties (except downstream units) Edit/update procedure-only equipment requirements downstream units property Edit/update operation and unit procedure equipment requirements Recipe Verification Verify a single recipe Verify all recipes Material Loop Recipe Link Add a material loop to a recipe Undo a material loop Add a recipe link Delete a recipe link * Require Phase Bind Requirements removed by the Recipe Editor are not audited.
38
Application and event-specific If provided by the user, applies to message associated with the all FactoryTalk Batch Recipe event being reported. Editor and Equipment Editor audit messages.
39
Field Severity
Used In
This field specifies the severity This is RNADiagSeverity_Info. This is not configurable. of the audit message. This value, along with the Audience parameter, defines where this message is routed. This field specifies the audience for the audit message. This value, in conjunction with the Severity parameter, defines where this message is routed. Date and time, specified as (GMT/UTC) Name of the host computer. This is RNADiagAudience_Op. This is not configurable.
Audience
Enum
Represented in the TimeStamp field of the audit message. Represented in the MachineName field in the audit message.
Name of the client application Not used. or component. Name of the person logged into the Editor. Fully resolved user name. Represented in the UserName field of the audit message. Represented in the UserDescription field of the audit message. Not used.
Args
Variant
Not used. This value field is arbitrary; values from 1 through 100 are valid. Use to further define or filter messages. The updating/editing action made by the user. For Equipment objects, the area name the object belongs to. This field is used when needed. All audit messages. Some Equipment audit messages.
Action Area
BSTR BSTR
40
Field
Used In
ContainingObje BSTR ct
The object type that contains Some Equipment audit messages. the EditedObject. This is used to help define exactly what object is being edited/updated. Some Equipment and Recipe The sub-property or object property field of the equipment audit messages. or recipe object affected by the action. The Equipment or Recipe object affected by the action. The most common way to identify the EditedObject. The property affected by the action. All audit messages. All audit messages. Some Recipe, Equipment and Area audit messages.
EditedObject
BSTR
EditedProperty1 BSTR EditedProperty2 BSTR EquipmentPhase BSTR Preference priority Some Equipment audit messages. For Equipment objects, the equipment phase name the object belongs to. This field is used when needed. The value of a property after it Updating audit events only. was changed. The value of a property after it was changed:
NewValue NewValue1
BSTR BSTR
Priority number The value of a property before Updating audit events only. it was changed. The value of a property before Updating audit events only. it was changed:
Phase Name Attribute Name Expression text Updating audit events only.
OldValue2
BSTR
Priority number
41
Field Operation
Data Type Description BSTR For Recipe objects, the operation name the object belongs to. This field is used when needed. For Recipe objects, the procedure name the object belongs to. This field is used when needed. For Equipment objects, the process cell name the object belongs to. This field is used when needed.
Procedure
BSTR
ProcessCell
BSTR
SubAction
BSTR
An updating/editing action to a Updating audit events for properties that are lists only. list that is a property of the EditedObject. This can be Add or Delete. The object type referenced by Updating audit events for the EditedObject. properties that are lists only. The value of a property after it Updating audit events for was changed. properties that are lists only. For Equipment objects, the unit name the object belongs to. This field is used when needed. For Recipe objects, the unit procedure name the object belongs to. This field is used when needed. For Recipe objects, the computer name and database where the recipes are stored. Some Equipment audit messages.
UnitProcedure
BSTR
Working Set
BSTR
42
For information about using or customizing the FactoryTalk AssetCentre client, refer to the utility's online help or the FactoryTalk AssetCentre Server and Client Installation Guide.
The following illustrates an Audit log as viewed with the FactoryTalk AssetCentre client. The FactoryTalk Batch audit message (the nineteen fields written to FactoryTalk Diagnostics and forwarded to FactoryTalk AssetCentre) are written to the Message Summary field. Only the first 100 characters of the Message Summary field are displayed on a line. The entire message is displayed in the Details window. The EditedObject audit message field is used to populate the Resource field in the Viewer.
In order to utilize FactoryTalk AssetCentre for auditing, Change Management (FactoryTalk AssetCentre add-on solution) must be installed.
43
Label EditedObject EditedObjectID EditedProperty EquipmentPhase NewValue OldValue Operation Procedure ProcessCell SubAction SubObject SubObjectID Unit UnitProcedure WorkingSet
Format <edited object> <edited objectID> <edited property> <equipment phase> <new value> <old value> <operation> <procedure> <process cell> <subaction> <subobject> <subobjectID> <unit> <unit procedure> <working set>
Each entry consists of a Label and its associated data. Each entry also contains tab characters to line up the data for readability, and is followed by a new line character.
44
CHAPTER 5
The requested user information in a Signature dialog box is defined by the Signature Template configured in the area model. Signature Templates determine the number of Signoffs required to complete a Signature Request. Each Signoff has associated security permissions, meaning, and may require a comment. Signature Templates are used with Command Verification Policies, Parameter Deviation Verification Policies, General Usage Phase Logic Requests or eProcedure Step Verifications to generate Signature Requests displayed in the FactoryTalk Batch View, ActiveX Controls and eProcedure. (See the
45
FactoryTalk Batch Equipment Editor Users Guide for information on configuring Signature Templates.)
The FactoryTalk Batch Server responds differently when Electronic Signatures are configured in the area model. You should be aware of the behavior changes before a decision is made to implement Electronic Signatures.
There are several steps involved in configuring and executing FactoryTalk Batch Electronic Signatures. (See the FactoryTalk Batch Equipment Editor Users Guide, How Electronic Signatures Work for more information.)
46
Command Execute Overlap If a Command Execute is received by a procedure that has incomplete Signature Requests for a prior Command Execute Action, then the new Command Execute fails. A failed Executes response item contains an appropriate error message. Exception: ABORT Command creating a Command overlap terminates the original Command Action causing a System Cancel instead of a failure. If ABORT overlaps with an ABORT Command, then any Incomplete Signatures for the first command are System Cancelled and a new Signature Request is generated for the second command. Automatic Cancellation Cmd When a procedure transitions to a state in which a queued Command Action is not legal, the Command Execute Action is terminated, and its associated incomplete Signature Requests are System Cancelled. Commands used with Command Verification Policies are: START STOP PAUSE HOLD MAN-MODE RESUME RESET CLEAR_FAILURES SEMIAUTO-MODE AUTO-MODE RESTART ABORT DISCONNECT
When a Command Verification Policy is configured for a command, and the same Command is issued in Manual Phase Control against a Phase, a Command Signature Request is generated. The following is an explanation of the modifications made to support FactoryTalk Batch Electronic Signatures:
Phase, Phase2, Phase3 Executes Batch Server When a legal Command Execute is received, the FactoryTalk Batch Server checks the area model to determine if a signature request is required. If yes, then the Command is queued and a Signature Request is generated. Exceptions:
Phase Reset and Phase Disconnect. Batch is created regardless of whether a Signature is required, or if the Signature is cancelled. ABORT Command is not queued.
Response Completion
An ActionID is returned by the Execute used to locate the generated signature. When all Signature Signoffs generated by the queued command are complete, then the Command is issued to the target procedure. Exception: ABORT Command issued regardless of Signature state. When any Signature is user cancelled, then the queued Command is terminated and all other Signature Requests associated with the same command action are System Cancelled. Exception: ABORT Command cannot be cancelled by the user.
Cancellation
47
Phase, Phase2, Phase3 Executes Overlap If a Phase Execute is received by a procedure that has incomplete Signature Requests for a prior Phase Execute Action, then the new Phase Execute fails. If a Command Execute is received by a phase that has incomplete Signature Requests for a prior Phase Reset or Phase Disconnect, then the new Command Execute fails. The failed Executes response item contains an appropriate error message. Exception: ABORT Command creating a Command overlap terminates the original Command Action causing a System Cancel instead of a failure. If ABORT overlaps with an ABORT Command, then any incomplete Signatures for the first command are System Cancelled and a new Signature Request is generated for the second command. Automatic Cancellation Warm Reboot When a procedure transitions to a state in which a queued Action would not be legal, the Execute is terminated, and its associated incomplete Signature Requests are System Cancelled. Signature Requests generated in response to a Phase Execute Action are System Cancelled in the event of a FactoryTalk Batch Server warm boot.
Response Completion
48
SetParm Execute Cancellation When any incomplete Signature associated with the SetParm Execute is cancelled, then the entire SetParm Execute Action is terminated and all Signature Requests associated with the same SetParm Execute Action are System Cancelled. If a SetParm Execute is received targeting a parameter that has incomplete Signature Requests for a prior SetParm Execute Action, then the new SetParm Execute fails. The failed Executes response item contains an appropriate error message. The specified value is not stored in the specified parameter. If any incomplete Signature Requests associated with a SetParm Execute is user cancelled, then the Execute Action is terminated and its remaining incomplete Signature Requests are System Cancelled. Signature Requests generated in response to a SetParm Execute Action are restored in the event of a FactoryTalk Batch Server warm boot.
Overlap
Parameter Value Ack Execute Batch Server If an Ack execute is received in response to an UnacknowledgedEvent generated to retrieve a Recipe Parameter Phase value, then the FactoryTalk Batch Server generates a confirmation Signature prompt if so configured in the area model. The Server also performs configured deviation checks on the value that is to be stored in the Recipe Parameter. If deviations are detected then a signature request(s) is generated. If one or more signatures is generated, then storing the specified value is delayed until the signature requests are complete. An ActionID is returned by the Execute used to locate the generated signature(s). When all Signature Signoffs generated by the Execute are completed, then the parameter value is stored. When any signature generated by a Parameter Value Ack execute is cancelled, then the Parameter Value Ack Action is terminated and its associated incomplete Signature Requests are System Cancelled. If an Ack execute response to a parameter value prompt is received while there are existing incomplete Signature Requests generated by a prior Ack to the same prompt, or the Batch has a Remove Action pending, then the new execute fails. The failed execute is populated with an appropriate error message.
Overlap
49
Parameter Value Ack Execute Automatic Cancellation A Signature generated for confirmation of a Parameter Ack Value Action may be System Cancelled if any other signature associated with the same Action is user cancelled, or if the Batch System UnacknowledgedEvent targeted is terminated by the Ack. Signature Requests generated in response to a Parameter Ack Execute Action are System Cancelled in the event of a FactoryTalk Batch Server warm boot.
Warm Reboot
Response Completion
Cancellation
Overlap
50
when binding a phase to a material after a prompt is generated or prompting binds a phase to a material. The following is an explanation of the modifications made to support FactoryTalk Batch Electronic Signatures:
Recipe Phase Bind Ack Execute Batch Server When the FactoryTalk Batch Server receives a legal Ack execute in response to a Recipe Phase Bind UnacknowledgedEvent, it may queue the bind selection delivery pending a Signature Request if such behavior is configured in the area model. An ActionID is returned by the Execute used to locate the generated signature. When all Signature Signoffs generated by an Ack received in response to a Recipe Phase Bind UnacknowledgedEvent are completed, then the Recipe Phase is bound using the Ack execute response data specified if the bind action is still legal. When any Signature generated by a Recipe Phase Bind Ack Execute is cancelled, then the Recipe Phase Bind Ack Action is terminated and its associated incomplete Signature Requests are System Cancelled. If an Ack execute response to a recipe Phase Bind Prompt is received while there are existing incomplete Signature Requests generated by a prior Ack to the same prompt, or the Batch has a Remove Action pending, then the new execute fails. The failed executes response item is populated with an appropriate error message string. If the batch system cancels an UnacknowledgedEvent targeted by a Recipe Phase Bind Ack Action, then the queued Execute Action is terminated and all incomplete Signature Requests associated with the Action are System Cancelled. Signature Requests generated in response to a Recipe Phase Bind Ack Execute Action are System Cancelled in the event of a FactoryTalk Batch Server warm boot.
Response Completion
Cancellation
Overlap
Automatic Cancellation
Warm Reboot
51
The following is an explanation of the modifications made to support FactoryTalk Batch Electronic Signature:
Bind Execute Batch Server When the FactoryTalk Batch Server receives a legal Bind execute, the Area Model configuration is checked to determine if a confirmation signature is required for the Bind request. If one is required, then a Signature Request is generated using the specified Signature Template and the Bind action is queued pending Signature completion. An ActionID is returned by the Execute used to locate the generated signature. When all Signature Signoffs associated with a Bind Execute Action are completed, then the Unit Requirement targeted by the Bind Execute Action is bound to the specified Unit if the bind action is still legal. When any Signature generated by a Bind Execute Action is cancelled, then the Bind Action is terminated and its associated incomplete Signature Requests are System Cancelled. If a Bind Execute is received while a previous Bind Execute Action is pending for the same target Unit Requirement, then the new Bind Execute fails. The failed executes response item is populated with an appropriate response string. For purposes of determining the legality of overlapping executes, Command, Step, Remove, and BindPhase Executes are treated as being Bind Executes. This means, for example, that if a Step Execute Action is pending Signature completion on a procedure, then a Bind Execute to the same procedure fails because of the overlap with the Step execute. If any step associated with the Unit Requirement being targeted by a queued Bind Execute Action becomes an active recipe element, then the Bind Execute Action is terminated and its associated incomplete Signature Requests are System Cancelled. This happens because the Bind action is not legal for a Unit Requirement associated with any active steps. Signature Requests generated in response to a Bind Execute Action are restored in the event of a FactoryTalk Batch Server warm boot.
Response Completion
Cancellation
Overlap
Automatic Cancellation
Warm Reboot
52
The following is an explanation of the modifications made to support FactoryTalk Batch Electronic Signatures:
Remove Execute Batch Server When the FactoryTalk Batch Server receives a legal Remove execute, the area model configuration is checked to determine if a confirmation Signature is required for the batch removal request. If one is required, then a Signature Request is generated using the specified Signature Template and the batch removal action is queued pending completion of the Signature Request. Manual Phase Control - When the Server receives a legal Phase Reset Execute, it checks the area model configuration to determine if a confirmation signature is required. If so, then a Signature Request is generated using the specified Signature Template and the phase reset action is queued pending of the Signature Request completion. Response Completion An ActionID is returned by the Execute used to locate the generated signature. When all Signature Signoffs associated with a Remove Execute are completed, then the batch specified in the Remove execute is removed from the batch list if the Remove instruction is still legal. When all Signatures associated with a Phase Reset are complete, then the Manual Phase Control batch specified in the Phase Reset Execute is removed from the Batch List if the Phase Reset instruction is still legal. Overlap If a Remove Execute is received targeting a batch for which a queued Remove Execution Action already exists pending Signature completion(s), then the new Remove Execute fails. The failed executes response item is populated with an appropriate response string. If a Phase Reset Execute is received targeting a batch for which a queued Phase Reset Execution Action already exists pending Signature completion(s), then the new Phase Reset Execute fails. For purposes of determining the legality of overlapping of executes, Remove Executes are treated as Phase Reset Executes. This means that if a Remove Execute action is pending Signature completion on a Manual Phase Control batch, then a Phase Reset issued via a Phase Execute to the same batch fails because of the Remove Execute overlap. Cancellation When an incomplete Signature associated with a Remove Execute Action is cancelled, then the queued Remove Execute Action is terminated and its associated incomplete Signature Requests are System Cancelled. When an incomplete Signature associated with a Phase Reset Execute Action is cancelled, then the queued Phase Reset Execute Action is terminated and its associated incomplete Signature Requests are System Cancelled. Automatic Cancellation A Remove Execute Action that is queued pending Signature Completion(s) is terminated if the target batch changes to an illegal state for Batch Removal, resulting in System Cancellation of its incomplete Signature Request(s). A Phase Reset Execute Action that is queued pending Signature Completion(s) is terminated if the target batch changes to an illegal state for Batch Removal, resulting in System Cancellation of its incomplete Signature Request(s). Warm Reboot Signature Requests generated in response to a Phase Reset or a Remove Execute Action are System Cancelled in the event of a FactoryTalk Batch Server warm boot.
53
Response
54
Step Execute Completion Cancellation When all Signatures associated with a Step Execute Action are completed, then the queued Step Execute Action is performed if it is still legal. When any Signature generated by a Step Execute Action is cancelled, then the Active Step Change action is terminated and its associated incomplete Signature Requests are System Cancelled. When a Step Execute is received targeting a procedure that already has a pending Step Execute Action, then the new Step Execute fails. The failed Executes response item is populated with an appropriate error message. For purposes of determining overlapping legality executes, Command and Remove Execute Actions are treated as being Step Execute Actions. This means, for example, that if a Step Execute Action is pending Signature completion, then an AUTO command issued via a Command Execute to the same procedure fails because of the overlap with the Step Execute Action. Warm Reboot Signature Requests generated in response to a Step Execute Action are not restored in the event of a FactoryTalk Batch Server warm boot.
Overlap
55
Cancellation
Overlap
56
Parameter Deviations Automatic Cancellation Parameter Deviation Signature Requests are System Cancelled if any other incomplete signatures associated with the same Action ID are cancelled. The Server does not change the parameter value sent in the ACK or SETPARM if any of the required signatures are cancelled. A FactoryTalk Batch Server Warm Boot restores Parameter Deviation Signature Requests generated by a SetParm Execute Action, but not those generated by an Ack Execute Action.
Warm Reboot
57
Response
Completion
Cancellation
Overlap
58
To change the value of the ESignature Network Directory policy setting open the FactoryTalk Administration Console. (See FactoryTalk Batch Default Policy Settings for more information.)
1. Log on to the FactoryTalk Local Directory. 2. The Explorer window displays the FactoryTalk Local Directory. Point to: System > Policies > Product Policies > Batch > Equipment Editor > Configuration > Options.
59
3. Right-click Options, and then click Properties. The Option Properties dialog box opens.
4. Select the ESignature Network Directory policy setting. If you are using Network security select True, to use Electronic Signatures on a stand alone computer, select
False.
60
CHAPTER 6
Windows Services
The FactoryTalk Batch Server and Archiver operate as Windows services. During FactoryTalk Batch installation, the user account specified during the installation is assigned to the Log On As: This Account: option, found in the (Administrative Tools) Services dialog box. Running as a Windows service allows the FactoryTalk Batch Server to run in the absence of an interactive Windows logon. Additionally, logging on or logging off Windows during operation does not disrupt the server execution. The FactoryTalk Batch Server can be configured to start automatically, giving Server control to Windows Services, or can be controlled manually using the FactoryTalk Batch Service Manager. The Service Manager can also control the type of boot method that the Server uses, as well as run the Server in demo mode.
Specifying the boot method or demo mode in the FactoryTalk Batch Service Manager does not alter the Batchsvr.ini file and has no effect on the Server when automatically starting.
61
Connection
The Connection area contains the following:
Item Computer Select Computer Service Definition Displays the selected computer. Selects the computer where the service is located. Allows you to select a service from a list of Batch services for the selected computer.
Service State
The Service State area contains buttons, text and a graphic traffic light service state representation. The following possible states and corresponding colors are displayed:
STARTING RUNNING STOPPED PAUSED NOT CONNECTED START PENDING None Green Red Yellow None None
The state of the FactoryTalk Batch Service Manager (information from the Connection and Server groups) is stored from the last time the Service Manager was run. These values are written when the FactoryTalk Batch Server is closed.
62
Server
The Server area contains the following:
Item Definition
FactoryTalk Batch Server: Allow Demo Mode Allows the FactoryTalk Batch Server to run with full functionality without a license for a two-hour period. After two hours, the Server stops running. Allows the FactoryTalk Batch Server to be started should a valid activation not be found. The grace period is seven days, after which a valid FactoryTalk Activation license is required. The FactoryTalk Batch Server starts in a completely initialized condition. All restart data is erased and all recipe content is removed from the Batch List. The FactoryTalk Batch Server starts and attempts to restore the set of batches that were on the batch list when the Server previously terminated. The restart files are altered so only one Warm restart may be attempted. Restarts the FactoryTalk Batch Server only if it is able to restore all of the batches to the batch list. Restart does not alter the restart files so another Warm-All or Warm restart may be attempted. This is the default setting for automatic restarts. This button opens the Batch Server Statistics dialog box.
Cold Boot
Warm Boot
Server Statistics
General Tab
The General tab lists various data on the number of batches and prompts being currently handled by the FactoryTalk Batch Server, as well as the Windows time on the server, the
63
time the Batch Server was started, and the name and creation date of the current area model.
Messages Tab
The Messages tab is used to monitor FactoryTalk Batch Server log information. The messages displayed in the three sections are the most recent messages written to the Server log by the Server.
64
Severe
65
2. Click the Select Computer button. The Select Computer dialog box opens.
66
3. In the Enter the object name to select area, type the name of the computer where the Batch Server is installed (or click the Advanced button to search for a computer). 4. Click OK to close the Select Computer dialog box. 5. From the Service list, select FactoryTalk Batch Server. 6. Select Allow Demo Mode if you want to run FactoryTalk Batch in demo mode. If you run FactoryTalk Batch in the demo mode, be aware that the Server stops after two hours of operation. 7. Click the Start/Continue button to start the service. Wait for the status to change to RUNNING. 8. Click the Server Statistics button. The Batch Server Statistics dialog box opens. 9. Select the PCD Communications tab. The Data Server Status box displays the status of the conversation. Make sure that conversation is GOOD. 10. Click Start. The tag verification process begins. When tag verification is COMPLETED, click OK, or click Stop to end the verification process and then click OK.
If the number of COM servers exceeds the viewable area within the Data Server Status box, a scroll bar displays, enabling you to scroll through the list.
11. Click Close. The Batch Service Manager dialog box closes.
67
When the FactoryTalk Batch Server starts, it performs a license check. If a valid activation is found, a successful license check is returned to the Server. As a result of the license check, the Server determines which applications have a license. If its normal license check process fails, the Server requests grace period activation from FactoryTalk Activation. The manner in which the grace period activation is requested depends on the area model and why the license check process failed. The Server will log the request for, and receipt of, the grace period license. When grace period activation is requested for multiple activations by one process, the grace period is ended and the timer reset when any of the multiple activations can be successfully obtained. Every four hours the FactoryTalk Activation software attempts to check out each activation requested as a grace period activation by the FactoryTalk Batch Server. If any one of these activations is successfully checked out, the grace period for the Server ends.
If the FactoryTalk Batch Server is started in the Demo mode, an exception is made to the license and unit checks. Even if no licenses are found, the Server will run for two hours and then shut down.
2. From the Edit menu, select New > Key. A new key folder is added. 3. Type the Key Name without the file extension.
68
CHAPTER 7
2. From the list of services, double-click Batch Server. The Batch Server Properties dialog box opens.
69
3. In the Startup type area, select Automatic to allow the Batch Server to start automatically upon system startup. 4. Select the Log On tab. 5. From the Log On As area, select This account. 6. Click the Browse button. The Select Users dialog box opens. 7. Select the User to be used for the Batch Server, and then click OK. The Select User dialog box closes. 8. In the Password box, type the password for the Batch Server account. 9. In the Confirm password box, re-type the password. 10. Click OK to close the Batch Server Properties dialog box. 11. Close the Services dialog box.
From the FactoryTalk Batch Equipment Editor Options menu, click Server Options. The Server Options dialog box opens with the default Project Settings tab as the active tab. The Batchsvr.ini file located in the BATCHCTL shared directory on the FactoryTalk Batch Server computer is automatically detected and displayed in the Project Settings tab. The Server Options dialog box contains some or all of the following tabs, depending on which FactoryTalk Batch modules are installed:
Batch Server Cross Invocation Descriptors and Defaults Hyperlink Descriptors and Defaults Material Policies
70
File Name. If the Server is installed on another computer, then the Initialization File Name would use UNC names.
From the Server Options dialog box, verify that the default FactoryTalk Batch Server initialization file name is correct. The default file is Batchsvr.ini, which is located in the BATCHCTL share in the Bin directory (Batch\bin\). The default should not be changed.
Setting Project Directories You must set directories for the following: Primary Journal, Secondary Journal, Error Logging, Instructions (if you are using FactoryTalk eProcedure) and Equipment Database. (Refer to the FactoryTalk Batch Getting Results Guide for more information on setting project directories.)
The Primary Journal path must be defined or the FactoryTalk Batch Server will not start. The Primary Journal path must be on the Server computer in the BATCHCTL share. In addition, if the Primary Journal or Secondary Journal path is invalid, the Server will not start. If an invalid path is used, an error message indicating the invalid path is written to the batchsvr.log file.
1. Click the Browse button to open the Select Directory dialog box. 2. Select the appropriate directory, and then click OK to return to the Server Options dialog box. The selected UNC directory path name is inserted into the appropriate box. Storing Recipes The Store Recipes Using area allows you to specify the format for storing recipes. The default format is Binary Files. When the Binary Files option is selected, recipes are stored in separate files according to recipe level. Procedures are stored as .bpc files, Unit Procedures are stored as .upc files, and Operations are stored as .uop files. When the Microsoft SQL Server Database option is selected, recipes are stored in a SQL Server database. When the XML Files option is selected, recipes are stored in separate .xml files.
71
Procedures are stored as .pxml files, Unit procedures as .uxml files and Operations as .oxml files. In the Store Recipes Using area, you can select from the following locations for recipe storage:
Binary Files specify the appropriate directory Microsoft SQL Server Database specify the node (computer name) and database name XML Files specify the appropriate directory
This note applies only if you are using SQL Server for recipe storage. If SQL Server is not installed on the same computer as the Batch Client and you want to see a list of available SQL Server databases in the Server Options dialog box, install SQL Servers Client Connectivity option. Do a custom install of SQL Server to install the Client Connectivity option.
Defining Redundant Servers FactoryTalk Batch can be configured to store batch journals and batch restart information in two separate locations. The use of a secondary server allows you to perform a manual failover if there is a hardware failure on the primary FactoryTalk Batch Server computer. (See Performing a Manual Failover for more information.) The second computer must be capable of running the Server. Defining redundant servers is accomplished by specifying the primary and secondary restart path names. These path names indicate where system files are written should the system experience a failure. If the secondary path name is not specified, FactoryTalk Batch does not create secondary files.
Archiver recovery - The eventdir.txt and the archque.txt are not updated as secondary files. As part of the manual failover procedure you must manually copy the files from the primary directory to the secondary directory.
72
You must install your area model file and all recipe files (and all instruction files if using eProcedure) on both the primary server and the secondary server. 1. Select the Restart Control tab.
2. Select the appropriate restart type for the Batch Server from the Restart Type area. The default is Warm Restart. 3. Click the Primary Path browse button. The Select Directory dialog box opens. 4. Select the MyProject\restart folder located in the BATCHCTL share on the primary servers hard drive (default is c:\Program Files\Rockwell Software\Batch\MyProject\restart), and then click OK. 5. Click the Secondary Path browse button. The Select Directory dialog box opens. 6. Locate and select the MyProject\restart folder located in the BATCHCTL share on the secondary servers hard drive, and then click OK. 7. Repeat steps 1 through 6 on the redundant server computer, selecting the Batch\MyProject\restart folder on the redundant server as the Primary Path. The Secondary Path can remain blank or point to another redundant server. Additionally, you must configure a data server to communicate with the process controller on the redundant server computer. The redundant server computer needs to communicate with the process controller that is running the phase logic.
You must also verify that the primary and secondary journal project directories are defined. (See Project Settings Tab for information on defining project directories.)
2. Select the appropriate option from the Reporting Application area. The following sections define the available reporting application options.
73
Report Editor
As of version 9.0, the Report Editor functionality was phased out and is no longer supported. If you are currently using the Report Editor functionality, it is recommended that you transition to a different reporting method, such as FactoryTalk Historian Classic for Batch or another third-party reporting application).
Archiver (End of Batch) Selecting Archiver (End of Batch) defers control of batch reporting to the FactoryTalk Batch Archiver and only performs batch reporting upon removal of the batch from the Batch List. The End of Batch Archiver runs in the security context of the FactoryTalk Batch Server. When using End of Batch archiving, the Archiver must be disabled as a Windows service and cannot be controlled using the FactoryTalk Batch Service Manager. (See the FactoryTalk Batch Archiver Users Guide for information on disabling the Archiver as a service.)
If Electronic Signatures are enabled, you must specify Archiver (End-of-Batch) archiving to ensure that all event journal records are properly archived.
1. Select Archiver (End of Batch). 2. In the Archiver area, select Delete files after archive to allow for the deletion of the .evt files after the Archiver has stored the data in the ODBC database.
Deleting files after archiving is not a reversible action and is not recommended.
3. In the Table Name box, type the name of the table that contains the batch data. The default is BATCHHIS.
The Database Connect String box should contain, at a minimum, ODBC;. It updates automatically when the data source is selected the first time the Archiver is started after installation. However, if you know the name of the data source, you can enter ODBC;DSN=DataSourceName; and you can skip the Archiver setup function. Changing the default Table Name from BATCHHIS requires 1) you to create a new table and 2) you must update the stored procedure named BHInsert to use the new table name. (See the FactoryTalk Batch Archiver Users Guide for instructions on creating a new table.)
Archiver (Incremental) Selecting Archiver (Incremental) defers control of batch archiving to the FactoryTalk Batch Archiver and performs batch reporting at user-defined intervals during batch execution. This option requires that you specify the incremental period between active archiving. The Incremental Period can be set in Minutes or Seconds. The minimum setting is 5 seconds. The maximum is 9999 minutes. If a value outside of this range is entered, the Archiver will run in 5 minute incremental periods. The Incremental Archiver must be stopped and restarted for changes in the incremental period to take effect. The Incremental Archiver must be configured with a Windows user account allowing it to log on the system. When using incremental archiving, the FactoryTalk Batch Archiver
74
must be configured to run as a Windows service with an automatic startup type. The FactoryTalk Batch Service Manager can be used to monitor and control the Archiver service. (See the FactoryTalk Batch Archiver Users Guide for information on enabling the Archiver as a service.) 1. Select Archiver (Incremental). 2. In the Archiver area, select Delete files after archive to allow for the deletion of the .evt files after the FactoryTalk Batch Archiver has stored the data in the ODBC database.
Deleting files after archiving is not a reversible action and is not recommended.
3. In the Table Name box, type the name of the table that contains the batch data. (The default is BATCHHIS.) 4. In the Incremental Period box, type a value and select Minutes or Seconds. User-Defined (End of Batch) Selecting User-Defined (End of Batch) allows you to define a batch reporting application that is not listed in the Reporting Application area. This option requires that you specify the paths and names of the applications .ini and .exe files. 1. Select User-Defined (End of Batch). 2. Click the Executable File browse button to locate the applications executable file. The Select Archiver Executable File dialog box opens. 3. Select the appropriate .exe file, and then click Open. 4. Click the Initialization File browse button to locate applications initialization file. The Select Archiver Initialization File dialog box opens. 5. Select the appropriate .ini file, and then click Open. None Select this option if no batch reporting or archiving application is to be used. Never Does not maintain a queue. This is the default selection.
The Never setting (causes the archiver queue file to not get written to. If you are using a custom archiver and want to write to this queue file, then a setting other than "Never" must be used and you must manually maintain the size of the archive queue file.
75
2. Select the appropriate check boxes to indicate the event type data for FactoryTalk Batch Archiver collection. Clear the check boxes for the data that is not to be collected.
Hold Propagation The Hold Propagation area allows you to indicate the hold propagation type to use when the FactoryTalk Batch Server detects a failure caused by a watchdog timeout, a handshake
76
timeout, or a phase failure (PHASE_F > 0). A Hold command associated with a failure propagates up through the recipe hierarchy as high as the mode and selected option allows.
Hold Propagation Type Phase Operation Description Only the affected phase is held, allowing the balance of the phases unit and all other units to continue running. Only the affected phase and the related operation are held, allowing the balance of the operations unit and all other units to continue running. The phase and the related unit are held and all other units continue running. (Default) Holds the entire batch when a failure is detected by the FactoryTalk Batch Server.
Unit Batch
The following diagram shows how a steps mode can affect the hold propagation. Depending on the steps mode, the batch may be held at a lower level than the selected hold propagation option.
Hold Propagation Set to: Batch
Procedure Unit Procedure Operation Phase
A M M
Operation
Procedure Unit Procedure Operation Phase
A M
Failure
Failure
Failure
A = Auto Mode M = Manual Mode
Failure
Failure
Communications Timeout The Communications Timeout area allows you to configure the FactoryTalk Batch Servers watchdog timer. The Period (msec) box allows you to set the watchdog timer setpoint in milliseconds. When the timer expires, the FactoryTalk Batch Server checks communication with the process-connected devices data server and performs the set/reset test on the data server
77
watchdog timer. In the event of a failed conversation, the Server attempts to reconnect. The default is 10000.
To avoid server update problems, the PLC watchdog timer setpoint must be configured to have a value that is twice the total value of the FactoryTalk Batch Server watchdog timers period value and allowable failures value. Example: If the Servers watchdog timeout period is set to 10000 milliseconds (10 seconds), and the allowable failures is set to 5, then set the PLC watchdog timer setpoint to 100000 milliseconds (100 seconds): 2 (5 x 10000) = 100000
The Allowable Failures box allows you to indicate how many Set/Reset retries the FactoryTalk Batch Server should perform before it declares that conversation with the server is BAD and issues a HOLD command. The default is 5. Miscellaneous The Miscellaneous area allows you to define options relating to the Batchsvr.log and the BatchSvr.ini file. The Maximum Log File Size box allows you to input the maximum size (in bytes) for the log file. When the log file reaches the maximum specified size, all new data is appended to the top of the log and old information is overwritten. The Minimum Disk Space box allows you to input the minimum disk space (in bytes) that must be available before a batch can be added to batch list. This helps to avoid data loss due to inadequate disk space. The Default Batch ID box allows you to specify a default batch ID; this batch ID automatically populates the Batch ID box when each batch is created. (See Customizing Batch IDs for more information.) Enable Event Journals Signatures turns event journal signatures on or off. The Event Journal Signature function is a tool for detecting any unauthorized changes to electronic batch records (.evt files). (See the FactoryTalk Batch System Files Reference Guide for more information about Event Journal Signatures.)
Do not edit the batchsvr.log or batchsvr.ini files directly unless you are specifically instructed to do so by Rockwell Automation Technical Support. The Batchsvr.ini file contains data items that determine the configuration of the FactoryTalk Batch Server and how the server operates in relation to the other FactoryTalk Batch components.
Cross Invocation Descriptors and Defaults Tab The Cross Invocation Descriptors and Defaults tab allows you to specify cross invocation labels and set default cross invocation strings for different resource types. Using the FactoryTalk Batch Equipment Editor, you can define up to five cross invocation strings for each resource within the area model. Each time a selection changes in the FactoryTalk Batch View and ActiveX Controls, the cross invocation strings associated with the equipment resource are retrieved from the FactoryTalk Batch Server and evaluated. The contents of these strings can indicate a shortcut menu item and subitems,
78
the caption(s) for the shortcut menu item(s), and the data that is passed to the automation server. (See Working with Cross Invocation for more information.)
Resource Types The Resource Types list allows you to select a resource type for the cross invocation labels and strings you define. Select one of the following from the list: Equipment Modules, Process Cells, Resources, or Units. Descriptors The Descriptors area allows you to enter up to five cross invocation labels for each resource type. These labels are used within the resources Edit dialog box. Default Values The Default Values area allows you to assign default cross invocation strings to each of the cross invocation labels defined above for the selected resource type. Any default cross invocation string can be overwritten when a specific resource type instance is edited.
Changes to the default value are not applied to the currently configured equipment in your area model. However, any new equipment you add to your area model uses the new default value settings.
79
for each resource within the area model. (Refer to the FactoryTalk eProcedure Administrators Guide for additional hyperlink information.)
Resource Types The Resource Types list allows you to select a resource type for the hyperlink labels and URLs you define. Select one of the following from the list: Equipment Modules, Process Cells, Resources, or Units. Descriptors The Descriptors area allows you to enter up to five hyperlink labels for each resource type. These labels are used within the resources Edit dialog box. Default Values The Default Values area allows you to assign default URLs to each hyperlink label defined for the selected resource type. Enter the URL address for the hyperlink in the box that corresponds to the correct hyperlink label. The label in box 1 of the Descriptors area corresponds to the URL address in box 1 of the Default Values area. Default URLs can be overwritten when a specific resource type instance is edited.
If a hyperlink value is not defined, either as a default or when the specific resource type instance is created, the hyperlink label is not visible in eProcedure.
80
Option when Material Server Comm is Lost You can choose from two options when communication with the Material Server is lost: Failure and Hold or Switch to Manual. By default, the FactoryTalk Batch Server is configured to Failure and Hold. In this case, batches are placed in the HELD state when communication with the Material Server is lost. The FactoryTalk Batch Server automatically resumes communication with the Material Server when it becomes available. If you want to run batches even when communication is lost, configure the FactoryTalk Batch Server to Switch to Manual. In Manual mode, the Server prompts the operator for information normally supplied by the Material Server. You must restore the communication manually when the Material Server becomes available. (For more information on restoring communication manually, see Restoring Communication in the FactoryTalk Batch Material Manager Administrators Guide.) Hold on Split Feed You can choose the Yes option to hold batches or the No option to continue to run batches in the event of a split feed. By default, the Yes option is selected and the batch is HELD when a split feed occurs. If you select the No option, you must create a loop in the recipe so that the binding process can select another container for material additions when a split feed occurs. You can easily add a material loop to your recipe with the Create Material Loop button in the FactoryTalk Batch Recipe Editor. (For information regarding material loops, see the FactoryTalk Batch Recipe Editor Users Guide.)
81
name, or if you are switching control to another FactoryTalk Batch Server computer, you need to manually modify the .NET registry key on all remote client computers to point to the Server computer. If the FactoryTalk Batch Client components are installed on the Server computer, this key should remain blank.
The FactoryTalk Batch Server computer's .NET registry key should always be blank and only used for remote client computers.
1. Open the Registry Editor. 2. Select the HKEY_LOCAL_MACHINE on Local Machine window. Navigate to the SOFTWARE\BATCHCTL\Net subkey. 3. Double-click the Server registry value. 4. Modify the value data: Server = <MachineName>, where <MachineName> is the computer name on which the FactoryTalk Batch Server is installed.
82
83
3. Right-click BATCHSERVER in the tree and select Remove Server. 4. From the File menu, click Synchronize. 5. Select the network model for the Material Server. 6. Right-click any <Undefined> FactoryTalk Batch Server in the tree, and then click Add Server. 7. Type a name in the Alias box. 8. Click the Computer Name box, and then select the computer to be used as the secondary Server. 9. From the File menu, click Synchronize. 10. Start the process-connected device communication software on the secondary Server. The secondary Server computer needs to communicate with the process controller running the phase logic. 11. Ensure that the project directories for the secondary Server are assigned to local directories. Use the Server Options dialog box in the FactoryTalk Batch Equipment Editor. 12. Use the FactoryTalk Batch Service Manager to start the FactoryTalk Batch Server software on the secondary Server computer, selecting Warm or Warm All as the startup type. The secondary Server allows the batches to be restarted based upon information written by the primary Server. 13. If you are also using eProcedure, use the FactoryTalk Batch Service Manager to start the eProcedure Server on the secondary Server computer. 14. For each computer running the FactoryTalk Batch View, enter the computer name of the secondary server as the NET registry key value. (See Modifying the .NET Registry Key for information on editing the NET registry key.) 15. Stop and restart each FactoryTalk Batch View instance and any other software that communicates directly with the FactoryTalk Batch Server. This causes the View instance to connect with the secondary Server.
The existing batches are placed in the MANUAL mode with transitions in the HELD state. Place the batches in AUTOMATIC mode, clear the failures, and then restart the batch.
84
The message EQUIPMENT MODULE NOT RESPONDING is shown on the status bar when the step is selected. It is also displayed in the Phase List Display area of the Phase Control window when the phase is selected. A System Message event type is logged into the electronic batch record. The description includes the fact that a time-out occurred as well as the type and ID of the command that timed out. In addition, the event is recorded in the FactoryTalk Batch Server log file with a severity status of SEVERE and the description is the type and ID of the timed-out command. If a communication error is detected while the command handshake is in process, the command handshake timer is stopped. The timer is reset and restarted if communication is successfully restored. If the command handshake completes after the timeout period, then the commands that are pending the handshake completion are processed. However, the error must be cleared before the batch can be restarted. In order to restart a batch, you must issue the CLEAR_FAILURES command. If the command handshake completes successfully, the error is cleared and the batch can be restarted. Otherwise, the error is not cleared and the batch is not restarted. The operator should check the execution status of the process-connected device. The Batchsvr.ini file contains an item used to configure the length of time, in seconds, that the FactoryTalk Batch Server waits for a command handshake before issuing a timeout. If the item is not included in the Batchsvr.ini file, it defaults to 60. The valid range is 5 to 600.
[XMAN] CommandTimeOut=90
This value is read when the FactoryTalk Batch Server starts. If you change the value, stop and restart the Server.
85
86
CHAPTER 8
The FactoryTalk Batch View when the Goto HMI button is selected. The ActiveX Controls when the ActiveX control shortcut menus are invoked by rightclicking on the running object. The FactoryTalk Batch ProcedureView ActiveX control does not display the Cross Invocation menu when you right-click on the step. The FactoryTalk Batch View displays a message indicating the step is not bound when you select the Goto HMI button.
Within the FactoryTalk Batch client applications, there are a number of selectable procedural elements. Each of these procedural elements relates to a specific equipment resource. Each equipment resource may be configured to have cross invocation strings (defined on the Cross Invocation tab of any configurable equipment resource in the Area Model). Procedural Element > Equipment Resource > Cross Invocation Strings Each cross invocation string defines the following:
The text for displaying the Cross invocation menu item. The data for passing to the automation server.
The following table shows the various FactoryTalk Batch View windows and the Equipment resource to which a selected procedural element is linked. For Cross
87
invocation to be implemented, the Cross invocation strings must be configured for the equipment resource.
FactoryTalk Batch View Window Batch List Corresponding Equipment Resource Process Cell (Procedure) Unit (Unit Proc or Operation) Procedure as SFC/Table Batch Process Cell (Procedure) Unit (Unit Proc or Operation) Unit Procedure Operation Recipe Phase Unit Unit Equipment Module
Event Journal
Batch
Unacknowledged Prompts
Unacknowledged Prompts
Equipment Module
Phase Control
Arbitration
Recipe
Alarm Summary
N/A
N/A
Phase Summary
Equipment Module
Equipment Module
88
A cross invocation string must be enclosed entirely in square brackets [ ]. Anything outside of the square brackets is ignored by the Server. Within the square brackets, the initial text (to the first semicolon) indicates the menu item(s) caption(s). All text within the square brackets after the first semicolon defines the context data passed to the automation server when the menu item is selected. A single string can specify one cross invocation item with any number of subitems. The first comma-delimited portion of the cross invocation string identifies the menu item for the shortcut menu, and each subsequent sub-string identifies a subitem. The data passed in response to all subitems is identical. Subitems are optional. Example: [Menu Item, Subitem 1, Subitem 2; %P, %S, %R]
The cross invocation string portion that specifies the data to pass to the automation server when selecting a menu item is defined by escape sequences. The escape sequences are replaced by the context data they represent before the string is passed. The valid escape sequences are identified in the following table along with their meaning.
Escape Sequence %P
Replaced By: The path to the selected step. In some instances, this value can be empty. (See Context Data Responses for more information.) Examples: CreateID CreateID \t Procedure \t Unit Procedure \t Operation \t Phase
%N %C %T %S
Equipment resource name to which the selected control recipe corresponds. Class name from which the equipment resource corresponding to the step was created. Equipment resource type to which the selected control recipe corresponds. Computer on which the FactoryTalk Batch Server is executing.
89
Escape Sequence %B %M
Replaced By: Batch ID of the selected control recipe. Menu item caption that was selected. If submenu items exist, they appear in the following order: the caption of the menu item appended with a colon, then the index number of the submenu item appended with a colon, and then the caption of the submenu item selected. Resource ID of the equipment resource to which the selected control recipe corresponds.
%R
%C
%T %S %B %M %R
* If the control recipe runs across multiple process cells, the context data replaced by %N and %C is the first process cell in the process cells list of associated with the recipe.
90
The following describes each escape sequence relative to the element selected within the FactoryTalk Batch View Phase Control window. (See the FactoryTalk Batch View Users Guide for information regarding selectable elements.)
Escape Sequence %P Process Cell Empty Unit Path (if exists). The context data that replaces %P (when selecting a unit) is the unit procedure path or operation that owns that unit, and blank otherwise. Phases Create ID (if exists). The context data that replaces %P when selecting an equipment phase is the Create ID of the Batch within which the phase is executing. This only exists if that equipment phase is currently executing within the context of a batch. Name of equipment module Phase Class name 3 (phase) Node Batch ID (if exists) Menu caption Equipment module resource ID
%N %C %T %S %B %M %R
Name of process cell Process Cell Class name 1 (process cell) Node Empty Menu caption Process cell resource ID
Name of unit Unit Class name 2 (unit) Node Batch ID (if exists) Menu caption Unit resource ID
The following illustrates the type of data that could be passed to the automation server when the Batch ID is selected in the FactoryTalk Batch View and the batch is running.
The automation server must be configured for responding appropriately to the data to which it is passed.
91
Configuring Cross invocation for the FactoryTalk Batch View and ActiveX Controls Once the cross invocation strings are defined, the FactoryTalk Batch View and ActiveX Controls must be configured to support cross invocation. FactoryTalk Batch View is configured to support cross invocation under the General tab of the System Configuration and Defaults window. On this tab, cross invocation must be selected and the program identifier of the automation server must be specified.
Once configured in FactoryTalk Batch View, the cross invocation menu items become visible when a procedural element is selected (that corresponds to an Equipment Resource with configured cross invocation strings) followed by selecting the Goto HMI button. The ActiveX Controls are configured to support cross invocation when the following two properties are configured for the ActiveX object:
InvocationProgID ShowCustomMenu
92
The InvocationProgID property must contain the program identifier of the automation server. The ShowCustomMenu property must be set to True so that the cross invocation strings are visible on the ActiveX objects shortcut menu during runtime as shown:
93
94
CHAPTER 9
95
Item Date Time Type User Computer Source Category Event ID Description Data
Description Date that the event occurred Time that the event occurred Type of the event (i.e., Information, Error, etc.) Configured domain user Computer on which the FactoryTalk Batch Server is running BatchSvr Category of the event ID of the event Description of the event File and line number within the FactoryTalk Batch Server source code that generated the entry.
Event ID Description 1000 1001 1002 1003 1004 Server demand started successfully in demo mode. Server demand started successfully in production mode. Server auto started successfully. Server failed to auto start. See the Batchsvr.log file for more information. Server failed to demand start. See the Batchsvr.log file for more information.
Do not edit the Batchsvr.log files.The Batchsvr.log contains critical information Technical Support needs to determine the cause of a FactoryTalk Batch Server failure. Start Start Start Start Start 1005 1006 1007 1008 1009 Command line arguments are inconsistent. Unexpected command line argument [Descriptive String]. Service handler not installed. Not running as a service or StartServiceCtrlDispatcher failed. Log directory does not exist. Validate ErrorLogDirectory key value in Batchsvr.ini.
Do not edit the Batchsvr.ini file unless specifically instructed by Technical Support. Start 1010 Unable to start due to access permissions on log directory specified by ErrorLogDirectory key value in Batchsvr.ini.
96
Category Start Start Start Start Start Start Start Start Start Start Start Start Start Start Start
Event ID Description 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 Batchsvr.log file could not be created/opened. Validate pathname in Batchsvr.ini. Unable to start. Log file (Batchsvr.log or Verify.log) does not have write access permission. Unable to start. Unable to access log file (Batchsvr.log or Verify.log). Unable to start. Verify.log file does not have write access permission. Unable to start due to missing Batchsvr.ini file. Unable to start due to access permissions on Batchsvr.ini file. Unable to start due to access problem with Batchsvr.ini file. Access error on Batchsvr.ini detected prior to logging on as user specified in Batchsvr.ini. Access error on Batchsvr.ini detected while running as user specified in Batchsvr.ini. Access error on log file detected while running as user specified in Batchsvr.ini. Access error on event files detected while running as user specified in Batchsvr.ini. Unable to start because primary event file directory specified by EventDirectoryPath key in Batchsvr.ini is missing. Unable to start because secondary event file directory specified by EventDirectoryPathSecondary key in Batchsvr.ini is missing. Unable to start because of access permissions on primary event file directory specified by EventDirectoryPath key in Batchsvr.ini. Unable to start because of access permissions on secondary event file directory specified by EventDirectoryPathSecondary key in Batchsvr.ini. Unable to start because of access permissions on Archque.txt file in primary event file directory. Unable to start because of access permissions on Archque.txt file in secondary event file directory. Unable to start because of access permissions on Eventdir.txt file in primary event file directory. Unable to start because of access permissions on Eventdir.txt file in secondary event file directory. Unable to start because RestartDirectoryPath key not specified in Batchsvr.ini.
97
Event ID Description 1031 1032 1033 1034 1035 1036 1037 1038 Unable to start because RestartDirectoryPath specified in Batchsvr.ini missing. Unable to start because of access permissions on RestartDirectoryPath specified in Batchsvr.ini. Unable to start because of access permissions (security?) on RestartDirectoryPath specified in Batchsvr.ini. Unable to start because RestartDirectoryPath2 specified in Batchsvr.ini missing. Unable to start because of access permissions on RestartDirectoryPath2 specified in Batchsvr.ini. Unable to start because of access permissions (security) on RestartDirectoryPath2 specified in Batchsvr.ini. Server started by an ActiveX client. Domain user name is blank and must be initialized in the SECURITY section of the Batchsvr.ini. The Server will not have any network credentials, which means it cannot access anything off node (i.e., data servers, event journal files, or recipes). Internal Error. Call to CoInitializeSecurity failed. Internal Error. Call to RegisterClassObjects failed. The SQL Server database cannot be opened. Server warm booting. Server cold booting. Server started. Server warm all booting. Data Server: [Descriptive String] status changed to GOOD. Data Server: [Descriptive String] status changed to SUSPECT. Data Server: [Descriptive String] status changed to LOST. Data Server: [Descriptive String] status changed to BAD. Data Server: [Descriptive String] status changed to an unknown conversation status. Data Server: [Descriptive String]. Server shutting down. Server exception occurred. Please refer to the Batchsvr.log file for information.
Start Start Start Boot Boot Boot Boot Boot Boot Boot Boot Boot Boot Shutdown Shutdown
1039 1040 1041 2000 2001 2002 2003 3000 3001 3002 3003 3004 3005 4000 4001
98
Category Shutdown
Event ID Description 4002 Server automatically shutting down from demo mode. Server tag verification process Started. Server tag verification process Aborted. Server tag verification completed, [Descriptive String1] of [Descriptive String2] tags verified successfully. Server registered. Server unregistered. Server registered as a service. Notify SCM: The service is stopping. Notify SCM: Service stopped. Notify SCM: The service is starting. Notify SCM: The service is running. SERVICE_CONTROL_STOP received from Service Control Manager. Unexpected SERVICE_CONTROL_PAUSE received from Service Control Manager. Unexpected SERVICE_CONTROL_CONTINUE received from Service Control Manager. SERVICE_CONTROL_INTERROGATE received from Service Control Manager. SERVICE_CONTROL_SHUTDOWN received from Service Control Manager. Bad Service Request. Command Line: [Descriptive String]. Argument received from SCM or BatchSCM: [Descriptive String]. HRESULT = [Descriptive String]. Thread [Descriptive String] started. Exception in object [Descriptive String1] in method [Descriptive String2]. Service could not be marked for deletion by the SCM. Debug: [Descriptive String].
Tag_Verification 5000 Tag_Verification 5001 Tag_Verification 5002 Registration Registration Registration Control Control Control Control Control Control Control Control Control Control 6000 6001 6002 7000 7001 7002 7003 7004 7005 7006 7007 7008 7009
Category_Debug 8000 Category_Debug 8001 Category_Debug 8002 Category_Debug 8003 Category_Debug 8004 Category_Debug 8005 Category_Debug 8006
99
100
CHAPTER 10
Click the Start button, point to All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch, and then click Simulator. The Phase Simulator opens. The FactoryTalk Batch Server and FactoryTalk Batch View can now run in a simulated environment.
101
recipe. The Simulator simulates the RUNNING, STOPPING, HOLDING, ABORTING, and RESTARTING states for all phases configured in the recipe.
The Simulator simulates only phase states for area models that have no more than 50 parameters and 50 report parameters.
Dwell Time
Indicates the length of time, in seconds, that a specific state is active for the selected phase.
Time of Request
Indicates the time, within the dwell period, at which a request is made.
Type of Request
Indicates the type of request to make. (Refer to the FactoryTalk Batch PCD Programmers Technical Reference Guide for more information about requests.)
Request Parameters
Each request can have up to three parameters that further describe the request.
A continuous phase is an equipment module whose phase logic does not transition to the COMPLETE state. You can simulate continuous phase logic by selecting Continuous Phase. When a transition that follows a step running continuous phase logic evaluates to TRUE, and the step is not involved in Transfer of Control, then the Batch Server sends a STOP command to the equipment module. If the equipment module with continuous phase logic is involved in Transfer of Control, and the transition evaluates to TRUE, the Transfer of Control procedure is executed, transferring ownership of the equipment module from the step prior to the transition to the step following the transition. A NEW_PARAMETERS command is issued to the equipment modules phase logic when the Transfer of Control occurs, notifying the phase logic that new recipe parameter values associated with the new recipe step are available for download if the phase logic requests a download. (In order to use a continuous phase in an actual batch, appropriate phase logic must be written to define non-terminating behavior. Refer to the NEW_PARAMETERS Command section in
102
the FactoryTalk Batch PCD Programmers Technical Reference Guide for more information.) 1. From the Edit menu, click Phase Configuration. The Phase Configuration dialog box opens.
103
View parameter tag values and associated parameter names View request tag values Set owner of phase to External Change the phases state for phases under External Control Restore active requests for HELD/RESTARTED phases Change report parameter tag values Change value of the Failure bit Set phase to COMPLETE Acknowledge/Clear requests of phases under External control
The Phase Status dialog box is accessed through the Simulators Edit menu and consists of the following sections and fields:
Definition Allows you to select a phase from all configured phases for the active area model. Allows you to select Phase Parameter Tags, Parameter Report Tags, and Request Data Tags. The Parameter column below the list displays the associated information. All values are view-only, except the Report Parameter Tags. You may modify a value for a Report Parameter Tag and click the Update Report Data button to update the report tag value in the FactoryTalk Batch Phase Simulator. Closes the Phase Status dialog box.
Close
104
Definition Sets the active phase to its corresponding terminal state: COMPLETE, HELD or ABORTED. The Request register must contain a 0 before the Set Complete button can take the active phase to its corresponding terminal state. Sends the current value in the Report Parameter Tag Value field(s) to the FactoryTalk Batch Server. Issues the appropriate command, to the active phase, based on the current state of the phase. The command is issued if the Owner is set to 1 (one) for External. Issues the appropriate command, (Abort or Reset), to the active phase, based on the current state of the phase. The command is issued if the Owner is set to 1 (one) for External. The active phase will be issued the appropriate command, Hold or Restart, based on the current state of the phase. The command is issued if the Owner is set to 1 (one) for External. Acts as a toggle, switching the value in the Owner register between 0 (zero) and 1 (one). A 0 (zero) represents FactoryTalk Batch as the owner and a 1 (one) represents an External owner. Acknowledges the current request (first click) and clears the request (second click). When a request is acknowledged, the value in the Request register is changed to 10 (ten), indicating that the request confirmation was received from the FactoryTalk Batch Server. When the request is cleared, the value in the Request register is changed to 0 (zero), indicating that the request was cleared. Opens a dialog box that allows you to simulate sending a request to the FactoryTalk Batch Server. (See the FactoryTalk Batch PCD Programmers Technical Reference for more information.) Displays the Equipment ID of the unit ID that currently owns the selected phase. Displays the current status for the phase: 10 = ABORTING 20 = HOLDING 30 = STOPPING 40 = RESTARTING 50 = RUNNING 60 = HELD 70 = COMPLETE 80 = STOPPED 90 = ABORTED 100 = IDLE
Abort/Reset
Hold/Restart
Owner
Ack/Clear Request
Set Request
105
Definition Displays the current request for the selected phase, or displays one of the following: 10 = Received confirmation from the FactoryTalk Batch Server 20 = Previous request was canceled 30 = Previous request was not canceled
Displays the active step index for the selected phase. Saves the step index number when the phase receives a Hold command. When the phase is restarted, this value is copied into the Step Index register. Displays the value for the Failure register. A 0 (zero) indicates there are no failures. You can enter any other value to simulate a failure. Indicates the current owner of the selected phase. A 0 (zero) indicates FactoryTalk Batch is the owner; a 1 (one) indicates an external owner. Indicates the status of the phases Pause bit. A 0 (zero) indicates the Pause bit is OFF; a 1 (one) indicates the Pause bit is ON. The Pause bit must be ON to allow for semi-auto processing. Displays the value for the Paused register. A 0 (zero) indicates the phase has not received a Pause command. Any other value indicates the phase has received a Pause command. Indicates the status of the phases single step register. A 0 (zero) indicates the single step mode is OFF; a 1 (one) indicates the single step mode is ON. Displays the Restore Request register value. A 0 (zero) indicates that the request register contents are not copied to the request buffer register when the phase receives a Hold command; a 1 (one) indicates that the contents are copied to the request buffer register when the phase receives a Hold command. Displays the Clear Request register value. A 0 (zero) indicates that the request buffer register contents are not copied to the request register when the phase receives a Restart command. A value of 1 (one) indicates that the contents will be copied from the request buffer register when the phase receives a Restart command. Displays the Download Request register value. A 0 (zero) indicates that a download request was not issued; a 1 (one) indicates that a download request was issued. Displays the accumulated amount of time, in seconds, that the active state for the selected phase has been running.
Failure Register
Owner Register
Pause Register
Paused Register
106
Viewing a Phase 1. From the Edit menu, click Phase Status. The Phase Status dialog box opens. 2. Select the appropriate phase from the Select Phase list. The following sections discuss various functions available from the Phase Status dialog box. Viewing Phase Parameter Tag Values The phase parameter tag values are read-only and cannot be modified in the Simulator. The FactoryTalk Batch Server writes these tags when a download request is processed.
From the Arrays list, select Phase Parameter Tags. Each parameter tag associated with this phase is displayed, along with its current value and type.
From the Arrays list, select Request Data Tags. Each request data tag associated with this phase displays, along with its current value and type.
Changing Ownership of the Phase The Owner button acts as a toggle, switching the value in the Owner register between 0 (zero) and 1 (one). A 0 (zero) represents Batch as the owner and a 1 (one) represents an external owner. 1. From the Select Phase list, select the appropriate phase. 2. To set ownership to External, click the Owner button when the value in the Owner register is 0 (zero). To set ownership to Batch, click the Owner button when the value in the Owner register is 1 (one). Commanding a Phase The FactoryTalk Batch Phase Simulator allows you to change the state of a phase. An active phase can be commanded to COMPLETE without gaining phase ownership. All other state change commands require the phase be under external control. The Start/Stop,
107
Abort/Reset and Hold/Restart buttons are modal, in that the command issued is determined based on the phases active state at the time the button is clicked. Only legal state change commands are executed. For example, if a phase is RUNNING and the Start/ Stop button is clicked, the STOP command is issued. START is not a legal command to a phase in the RUNNING state. (Refer to the FactoryTalk Batch PCD Programmers Technical Reference for additional information on legal state transitions.) The following table shows the phases transition when the state change command is received, along with the associated state value (##).
COMMAND COMPLETE START STOP ABORT RESET HOLD RESTART HOLDING (20) RESTARTING (40) STOPPING (30) ABORTING (10) INITIAL STATE FINAL STATE COMPLETE (70) RUNNING (50) STOPPED (80) ABORTED (90) IDLE (100) HELD (60) RUNNING (50)
1. Select the phase to command from the Select Phase list. 2. To set the phase to COMPLETE, click the Set Complete button. 3. For all other state change commands, set the Owner of the phase to External. 4. Click the appropriate state change command button (Start/Stop, Abort/Reset, or Hold/Restart). If the requested state change is legal, the server sends the command to the FactoryTalk Batch View and the phase transitions to the appropriate state. The new state value is displayed in the Status register in the Phase Status dialog box. If the phase is running and the Abort/Reset button is selected, the phase goes to ABORTING. To transition the phase to the ABORTED state, select the Set Complete button. If a phase is running and the Hold/Restart button is selected, the phase goes to HOLDING. To transition the phase to the HELD state, select the Set Complete button. Acknowledging and Clearing a Request Requests must be acknowledged and then cleared to allow a phase to continue processing when running under External control. The Ack/Clear Request button must be clicked twice, first to acknowledge the request, then to clear the request. 1. From the Select Phase list, select the phase to be commanded. 2. If the Request register contains a request, click the Ack/Clear Request button to acknowledge the request. The value in the Request register changes to 10 (ten), indicating that the request confirmation was received from the Batch Server.
108
3. Click the Ack/Clear Request button to clear the request. Upon clearing the request, the value in the Request register changes to 0 (zero), indicating that the request was cleared. The phase continues to process. Restoring and Clearing Requests Requests generated by a phase can be stored in the request buffer registers should the phase receive a Hold command. The requests can then be copied back to the request registers when the phase receives a Restart command. The Restore Req and Clear Req registers must both contain a 1 (one) to allow for the saving and restoring of requests for a HELD/RESTARTED phase. 1. From the Select Phase list, select the phase to be commanded. 2. In the Restore Req register, type a 1 (one). 3. In the Clear Req register, type a 1 (one).
109
1. From the Simulator window, select Unit Tag Status from the Edit menu. The Unit Tag Status dialog box opens. 2. Make any required modifications to the Unit Tag Values, and click the Update Values button. The new values are written into the FactoryTalk Batch Phase Simulator unit tags. 3. Click OK to return to the FactoryTalk Batch Phase Simulator window.
110
CHAPTER 11
Click the Start button, point to All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch, and then select Network Editor. The Network Editor window opens.
If running on Windows Vista or Windows Server 2008, you must run the Network Editor as administrator. Right-click Network Editor and select Run as administrator.
111
Hierarchy Pane
The Hierarchy pane provides a hierarchical view of the application servers in your FactoryTalk Batch system. The Network Model is the parent item in the hierarchy list, with the following application servers listed as Network Model members: Material Server, BatchERP Server, and FactoryTalk Batch Server 1 through Batch Server 10. The following indicators appear next to each server listed:
Indicates the server is recognized on the network Indicates the server is not defined or recognized Indicates there is a problem with the server or the servers configuration
Detail Pane
The Detail pane provides information specific to the item selected in the Hierarchy pane. Network Model Information The following items are available when Network Model is selected in the Hierarchy pane.
Item System Name Network Model from Time Stamp User Name Apply Changes Undo Changes Synchronize All Application Servers Description Allows you to name your FactoryTalk Batch system. The default is Network Model. Displays the name of the computer from which the FactoryTalk Batch system was last synchronized. Displays the time of the last synchronization. Displays the Windows user ID of the person who performed the last synchronization. Saves changes made to the FactoryTalk Batch system information. Undoes changes made to the FactoryTalk Batch system information that are not applied. Initiates the synchronization of the application servers.
Application Server Information The following items are available when a server or Undefined is selected in the Hierarchy pane.
Item Alias Computer Name Configure Description Displays a user-defined alias for the selected application server. Displays the computer name for the selected server. Allows you to specify the name of the material database when using FactoryTalk Batch Material Manager. The default database is MaterialBasedRecipe.
112
The Network Editor does not verify database names. Changes made to the database name are immediate for the clients and servers. If the database name is invalid, the Material Editor will not open. Before changing the database name, check the spelling and synchronize the Network Editor. After changing the database name, confirm that the Material Editor opens and can read the database.
Results Pane
The Results pane provides information messages regarding the results of the last synchronization. Included in the list is an icon indicating the type of message listed, the name of the computer that performed the synchronization, and the message generated by the synchronization process. The table below shows icons used in the messages and explains what types of messages they represent.
Information Error Warning Represents an information message. Indicates an error message. Indicates a warning message.
Menu Bar
The menu bar contains the pull-down menus for File, Edit, View, and Help. File Menu From the File menu, you can select a Network Model, synchronize all servers, print, and exit the Network Editor application.
Edit Menu From the Edit menu, you can add or remove a server from the Network Editor.
113
View Menu From the View menu, you can show or hide the toolbar/status bar, and refresh the Network Editor. You can also specify how data is viewed in the panes as well as setting other user preferences.
Status Bar
The status bar at the bottom of the window displays text messages on the left side. In addition, the status bar displays one or more icons on the right side, representing the status
114
of the application and/or data. The following is a list of states that can be displayed in the status bar:
Database: The Network Editor is accessing data. Server: The Network Editor is accessing other servers. Printing: A report is being printed or previewed. Processing: The Network Editor is processing data. Waiting: The Network Editor is busy.
2. Type the computer name in the Enter the object name to select area, or click the Advanced button to search for a computer. 3. Click OK. 4. Click the Synchronize button.
115
Adding a Server
1. In the Hierarchy pane, select the type of server to add.
Material Server BatchERP Server Batch Servers 1 through 10
2. Click the Add Server button. The Modify Server dialog box opens.
3. In the Alias box, type an alias name. This is the name that displays in the Network Editor. 4. In the Computer Name box, type the computer name, or use the browse button (shown at left) to locate and select the computer from the list of computers on your domain. 5. Click OK.
Removing a Server
1. In the Hierarchy pane, select the server to remove. 2. Click the Remove Server button.
Click the Synchronize button. The Network Editor refreshes and the results of the synchronization process display in the Results pane.
It is a good idea to synchronize after adding or removing a server from the network model.
116
The General tab is used to configure the basic behavior and appearance of the Network Editor views and dialog boxes. The selections on the General tab are used in conjunction with other sections of the User Preferences dialog box. In the Options area you have the following selections:
Use application colors: Select to assign colors, other than the current Windows
colors, to the background and text in the views. (See Editing Colors for more information.)
Use application font: Select to change the font, font style, and size from the default Windows style. (See Editing Fonts for more information.) Information tips: Select to enable single line tips that appear when you move the cursor over a button or field. (See Editing Information Tips for more information.) Animate dialogs: Select to have dialog boxes fly out from the location from which they are opened. Confirm deletion: Select to display an Are you sure? message when you delete
Confirm exit: Select to have the application ask if you want to exit. Leave disabled to exit without a confirmation message.
Editing Colors
The Network Editor defaults to the current Microsoft Windows color scheme. You can change the color of the text and background. 1. On the General tab in the User Preferences dialog box, select Use application colors.
117
3. Disable Use Windows colors to enable the Background color and Text color lists. 4. Select the desired colors from the appropriate list, and then click Apply.
Editing Fonts
The Network Editor defaults to the current Windows fonts. You can change the display font. 1. On the General tab in the User Preferences dialog box, select Use application font. 2. Select the Font tab.
3. Click the Select Font button. The Font dialog box opens. 4. Select the desired font, style, and size from the appropriate lists, and then click OK. 5. Click Apply.
118
3. To enable the Background color and Text color lists, disable Use Windows colors. 4. To change the tip color, select the text and background colors from the appropriate lists, and then click OK. 5. To change the tip font, click the Change Font button. The Font dialog box opens. Select the desired font, style, and size from the appropriate list, and then click OK. 6. To change the timing of information tips, use the Up and Down arrows to change the settings in the Timing area.
Delay determines how soon a tip displays when the cursor stops on an area with a
tip.
Visible duration determines how long the tip is visible before closing.
7. Click Apply.
119
Changing List View Properties The List View Properties area contains the following options to change the appearance and behavior of items seen in a list view.
Hot list selection If selected, an item is automatically highlighted and selected when the cursor remains over the item for a certain period of time. List information tips If selected, single-line tips appear when you move the cursor
over a button or field. (See Editing Information Tips for more information.)
Flat scroll bars If selected, scroll bars appear 2-dimensional. If disabled, scroll bars have a 3-dimensional appearance (Windows default). The following figure illustrates both the default (on the left) and flat (on the right) scroll bars:
Header drag and drop If selected, users can click and drag a header from one location to another in order to rearrange the columns. Header hot tracking If selected, an item is automatically highlighted but not selected when the cursor moves over a header item. You must still click the item at least once to activate it. Subitem images Not currently enabled.
Changing View Fonts Changes made to the font on the View tab User Preferences dialog box are not permanent. Use the Font option on the General tab. (See Editing Fonts for more information.) Changing View Colors Changes made to the color on the View tab User Preferences dialog box are not permanent. Use the Colors option on the General tab. (See Editing Colors for more information.)
120
2. Select the Reports tab. The default report style for most views is Formatted.
3. To change the type of printed report, select either List or Formatted to the right of the appropriate report.
If you select the List format, set the page orientation to landscape. From the File menu, select Print Setup, select Landscape in the Orientation area, and then click OK.
4. Where available, you can select Include Related Data, and any additional data associated with the selected item (single items only not lists or groups) also prints on the report. 5. In the Footer Text box, type a word or phrase to appear centered at the bottom of each page. 6. Click Apply.
121
Changing Margins 1. To change the margins, fonts, and colors of a printed report, click the desired Report button (List, Formatted, or Graphical). The Report Page Configuration dialog box opens.
2. Change the margin widths of the printed report if desired. Type the desired amounts in each box for the Left, Right, Top, and Bottom margins. A visual representation of each margin change displays in the Report page preview area. Note that this is not to scale. 3. If you want to use inches instead of metric measurements, disable Metric Measurements. 4. Click OK to close the Report Page Configuration dialog box. 5. Click Apply. Setting the Report Fonts and Colors There are four areas in a report for which you can edit the fonts and colors:
Heading Prints across the top of each page, generally in a larger, bolder font
Sub Heading Refers to the field names on the report, such as Server. In
formatted reports, subheadings print to the left of the actual report data.
Body Refers to the actual report data. Body text is usually smaller and lighter
Footing Prints the page number, date and time that the report is printed across
the bottom of each page, generally in a smaller font than the rest of the report.
122
1. To change the font type, style, and size of each section in the report template (heading, subheading, body, or footer), select the Fonts tab.
2. Click the button for the report section you want to edit. The Font dialog box opens.
3. Select the desired font, font style/size, and then click OK. 4. If your printer supports color printing, you can add color to the report. Select the Colors tab.
123
5. Click the color selection button corresponding to the report section to which you want to add color. The Color dialog box opens. 6. Select a color from the Color dialog box, and then click OK. You will see a visual representation of each color change in the Report page preview area of the dialog box. 7. Repeat for the other sections of the report, as desired. When you are finished changing fonts and colors, click OK to close the Report Page Configuration dialog box. 8. Click Apply. Working with Columns and Rows The Results pane contains data items in columnar format. The data items cannot be edited directly. If you select List in the User Preferences dialog box, you can manipulate the columns in the Results pane as follows:
Action Sorting columns How to Perform Click a column header to sort the items in the column alphabetically or numerically. Automatically: To make the column width fit the contents, double-click the boundary to the right of the column heading. Sizing columns Manually: Drag the boundary on the right side of the column heading until the column is the desired width. Click once on a row to highlight it, and then click again. The item name is encased in an editing box so that you can rename the item. Editing the item name Double-click on a row to open the Properties dialog box, allowing you to edit the item name. Right-click on a row to display the shortcut menu; select Rename. Double-click on a row to open the Properties dialog box to edit the rows information. Editing a row Copy, delete, or move rows Right-click on a row to display the shortcut menu; select Properties or other editing operations. Right-click on a row to display the shortcut menu; select Cut, Copy, Paste, or Delete.
Printing Reports
The Network Editor report printing feature allows you to print network, server, or result pane information, in a report formatted with headers, footers and column headings (in list reports). There are two report formats available: formatted and list. The header (at the top of the page) consists of the report name, while the footer (at the bottom of the page) contains the printing date/time and the page count.
124
A formatted report presents the information down the page, with bold field names as shown in this figure.
A list report presents the data in a columnar, spreadsheet format, with one line per data item. The field names become column headings as shown in this figure.
You can customize the reports by setting margins, changing font styles, and selecting text colors. In addition, you can enter custom text that is also included in the footer. (See Setting Report Preferences for more information.)
Previewing Reports
The Print Preview function of the Network Editor allows you to see how a printed report looks before you send it to the printer. 1. Click the Print Preview button. The Print Preview window opens, displaying the report as it will look when printed. The following options are available from the Print Preview window:
Next Page If there is more than one page in the report, click Next Page to view the next page of the report. Prev Page Click to view the previous report pages (if there is more than one
Two Page Allows you to view two pages of a report in the same window. One Page Returns to the default preview setting of one page per window.
125
Zoom In/Out Click Zoom In to magnify the preview page. Click Zoom Out to reduce the size of the page in the preview window. Close Closes the preview window.
2. Click Close to return to the Network Editor. You can either print the report or make additional report configuration changes.
Printing Reports
1. In the Network Editors Hierarchy pane, select the list or item(s) that you want to print. 2. From the File menu, click Print. You could also click the Print button or press CTRL+P to display the Print dialog box. 3. Ensure that the correct printer is selected, and click OK.
To configure heading /footer fonts and add a custom footer to your reports, see Setting Report Preferences for instructions.
Printing a Range of Reports You may want to print just certain pages of the report. You can do so by entering the starting and ending page numbers of the section you want printed. 1. In the Network Editors Hierarchy pane, select the list or item(s) that you want to print. 2. Click Print. 3. In the Page Range area, click Pages. Type the page numbers to print in the From and To boxes. 4. Ensure that the correct printer is selected and click OK.
126
CHAPTER 12
Troubleshooting
This section contains information on error log and tag verification log generation, and how these logs are used to troubleshoot system problems. This section also contains a list of specific error messages that may be encountered after installing and/or running FactoryTalk Batch, and possible troubleshooting solutions.
127
to increment the integer beyond a value of 999 results in a wrapping of the value back to one. If this value is not present or is invalid, then a current value of one (1) is assumed. This results in the creation of a log file copy with the name 001.log and the updating of the field to a value of two (2). If the FactoryTalk Batch Server generates a name for a copied log file, and the file name already exists in the directory where the copy is to be stored, the Server attempts to create a new name for the copied log file. The Server generates new log file names by incrementing the CopyFileID value until an unused file name is found. The integer used to generate this file name is incremented one last time and this value stored into the CopyFileID field in the Batchsvr.ini file. If no unused file names are found, then the Server is forced to overwrite the file name generated with the CopyFileID fields original value.
Termination of FactoryTalk Batch During Warm Restart Description Event Event File Name YourBatchDescripti on System Message PValue \\MachineName\Program Files\Rockwell Software\Batch\YourProject\ JOURNALS\4125.evt Batch terminated due to error attempting to restore batch during WARM restart
128
12 Troubleshooting
Termination of FactoryTalk Batch During Warm Restart Description Event Event File Name YourBatchDescripti on System Message PValue \\MachineName\Program Files\Rockwell Software\Batch\YourProject\ JOURNALS\4125.evt End Of BATCH
Field# 1 2 3 4 5 6
Value This field is left blank. INFO This field is left blank. This field is left blank. This field is left blank. This field is left blank.
129
Field# 7 8 9 10
Value This field is left blank. This field is left blank. This field is left blank. The text Tag Verify Has Not Been Run
The tag verification log file is not intended to wrap. In the event of an unexpected problem or circumstance, the Verify.log file is limited to 9,000,000 bytes. If the Verify.log file exceeds this size, the file is wrapped, just like the Batchsvr.log file. An analysis of an existing tag verification log file showed that an area model with 888 tags generated a log file with a size of 159,050 bytes, which indicates an average of 180 bytes per tag in the verification log file. This implies that a 9,000,000-byte file should be able to verify approximately 50,000 tags before the log file would wrap. The FactoryTalk Batch Server only keeps the tag verification log file open during the tag verification process. When a program has a file open, the file cannot be deleted or renamed. The Server overwrites any existing tag verification log file each time a tag verification begins. If the Server encounters a tag verification log file that is Read Only, the Server changes the protection on the file to allow it to be overwritten.
The System Monitor can examine the use of computer resources by FactoryTalk Batch components, as well as other processes and applications, and it can help determine if a process or application is using too much CPU time or memory. The pre-defined Performance Chart, supplied with FactoryTalk Batch, charts specific processes that can
130
12 Troubleshooting
affect the performance of FactoryTalk Batch, and can be an important tool in identifying and troubleshooting system problems.
The performance chart is intended to be used primarily as a debugging and diagnostic tool by FactoryTalk Batch product support personnel.
The Windows System Monitor is used to view chart data, alerts, logs and reports. Additionally, charts can be saved for future review. To view the FactoryTalk Batch performance chart, make sure that the System Monitor is set to chart view mode. (Refer to your Windows documentation for more information on using the System Monitor.)
Click the Start button, point to All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch, and then click Performance Chart. The Performance dialog box opens with the pre-defined charts listed.
Troubleshooting Errors
This section outlines errors that may be encountered while running FactoryTalk Batch and possible solutions to these errors. Automatic repair of Batch component installation fails This can happen if one or more necessary folders were unintentionally moved (in Windows explorer). For example, if the Schema folder gets moved away from its original install path, the install package starts up automatically and tries to repair the problem. This repair can clear out the Model and Server keys in the registry, which can make the Batch client editors generate warning dialogs because they are not able to find the Network Model. If this happens, completely uninstall the application and then reinstall it.
131
Journal path has not been defined in FactoryTalk Batch Server options. Modify the FactoryTalk Batch Server options to include a valid Primary Journal path. Verify that the Secondary Journal path, if defined, is valid.
Restart path has not been defined in FactoryTalk Batch Server options. Modify the FactoryTalk Batch Server options to include a valid Primary Restart path. Verify that the Secondary Restart path, if defined, is valid.
Incorrect Net registry key value. The FactoryTalk Batch Server computers local Net registry key value should be blank. The FactoryTalk Batch Server is always installed with the default user and password. The FactoryTalk Batch Servers logon/password settings are not migrated from the Server .ini file during an upgrade. To run the Server as a different user, you must change the logon/password settings, using the Control Panel Services dialog box, after a new installation.
FactoryTalk Batch Server runs for a specific period of time and then stops, and consistently stops at the same time interval. Error Message: (none)
Check the FactoryTalk Batch Service Manager. If the Allow Demo Mode check box is selected, this could be the problem.
FactoryTalk Batch Service Manager does not display the FactoryTalk Batch Server and/or Archiver. Error Message: (none)
The computer where the services are located is not selected. Use the Select Computer button to select the appropriate computer. The FactoryTalk Batch Server and/or Archiver services are not registered with the Windows Registry. To register a service, click the Start button, point to All Programs, and then select Command Prompt. Navigate to the Program Files\Rockwell Software\Batch\bin directory. To register the FactoryTalk Batch Server type batchsrv /service at the command prompt, and then press ENTER. To register the FactoryTalk Batch Archiver, type batcharc /service at the command prompt, and then press ENTER.
FactoryTalk Batch Service Manager displays Batch.Server Class instead of Batch Server. Error Message: (none)
132
12 Troubleshooting
The service displays the class name instead of the display name. This is caused by DCOMCNFG configuring the FactoryTalk Batch Server service to display the class name of the service instead of the display name. When this occurs, the Server no longer supports its COM interface and must be reinstalled.
The FactoryTalk Batch View/Client is properly configured, but cant view the Event Journals. Error Message: (none)
The text in FactoryTalk Batch dialog boxes does not display properly. Error Message: (none)
FactoryTalk Batch does not support the use of large fonts. Use the Display Properties dialog box to change the default system font size to Small Fonts.
Unable to locate files. Error Message: The Recipe directory file could not be found.
The server options for the FactoryTalk Batch Server are not configured to point to the folder that contains the Recipe.dir file. (See Editing the FactoryTalk Batch Server Options for more information.)
An Application Log error is generated. Error Message: The Application log file is full.
Use the Event Viewer to change the Application Event Log Wrapping setting to Overwrite Events as Needed: 1. Click the Start button, point to All Programs > Administrative Tools, and then select Event Viewer. The Event Viewer opens. 2. Right-click Application Log, and select Properties. The Application Log Properties dialog box opens. 3. In the Log size section, select Overwrite events as needed. 4. Click OK. 5. Exit the Event Viewer. A Licensing error message is generated in Microsoft Visual Basic. Error Message: License information for this component not found. You do not have an appropriate license to use this functionality in the design environment.
133
Visual Basic should be installed before FactoryTalk Batch is installed. If you have already installed FactoryTalk Batch: 1. Uninstall the FactoryTalk Batch client to remove the ActiveX controls. (Refer to the FactoryTalk Batch Installation Guide for information on removing the ActiveX Controls). 2. Re-install Visual Basic. 3. Re-install the FactoryTalk Batch client using the FactoryTalk Batch Setup program. Recipes Not Visible From FactoryTalk Batch View Program. Error Message: (none)
When the Create a Batch button is clicked, no recipes show up in the Select a Recipe dialog box. The Released to Production item is not selected in the recipe header data. For each recipe that should appear in the Select a Recipe dialog box, ensure that the Released to Production check box is selected. This can be done by selecting the Header data option for the recipe and selecting the Released to Production check box.
List of available SQL Server databases not displayed in the Server Options dialog box. Error Message: (none) When the browse button for SQL Server databases is clicked, no databases are displayed in the Database Selection dialog box. Install SQL Servers Client Connectivity option. This is found on the FactoryTalk Batch Installation CD. Do a custom install of SQL Server to install the Client Connectivity option. Event Journal files are not being created. Error Message: (none)
The primary journal directory must be located on the FactoryTalk Batch Server computer in the BATCHCTL share. If the Primary Journals directory is located on a computer other than the Server computer, or not within the BATCHCTL share, and that computer becomes inaccessible, the Server continues executing batches but is unable to create event journals for those batches. You will not receive a notification of the problem.
134
APPENDIX A
135
The following steps disable editing of the batch ID. In this case, the box on the Batch Creation dialog, which displays when a batch is added to the batch list, is grayed out.
If a failure occurs in the generation of a custom batch ID, the batch ID is editable regardless of the setting.
1. Perform steps 1-3 in the previous section, Enable Editing of Batch IDs. 2. Click the General tab, and then in the BatchID Editing section, deselect the Allow Editing of Batch ID check box.
5. Click OK.
136
If the AutoBatchID execute fails or the generated batch ID contains invalid characters, the Batch ID box in the FactoryTalk Batch View becomes editable even if the Allow Editing of Batch ID check box in the View/Configuration and Defaults/General is disabled. If you created a default batch ID, it populates the Batch ID box and is editable. This feature allows the operator to enter the batch ID manually in the event of a failure.
The general steps to customize the DLL are as follows: 1. Copy the entire Custom folder, found on the FactoryTalk Batch CD, including all subdirectories, to the local hard drive, leaving the structure intact. 2. Double-click BatchIDCreation.vbp. The Visual Basic project opens. If you see error messages about references that are not yet in the Visual Basic project, click Yes until you see the message that Visual Basic is unable to set the version compatible component. Click OK. 3. From the Project menu, select References. The References dialog box opens. There are several files that are required for references used in the Visual Basic project. These references must be set manually within the Visual Basic IDE. 4. From the Available References list, select the following references:
The COM+ Runtime library, COMSVCS.dll, that is needed for COM+ functionality. If this file is not on your system use MTXAS.dll.
OLE Automation
The OLE Automation support DLL, STDOLE32.tlb, which is usually a standard Visual Basic reference.
The AutoBatchID type library, batchidcreationinsertion.tlb, required to create your customized version of the BatchIDCreation.dll. 5. Click OK. 6. From the Project menu, select BatchIDCreation Properties. The Project Properties dialog box opens. 7. Select the Component tab, and then select Binary Compatibility. 8. Click the browse button, locate C:\Program Files\Rockwell Software\\Bin\BatchIDCreation.dll, and then click Open. 9. Click OK. 10. Modify the source code located between the Begin - Code Modifications heading and the End - Code Modifications heading within [GenerateBatch] to define the BatchID value.
The batch ID can contain a maximum of 255 characters with no spaces or invalid characters. The batch ID can be comprised of any characters except the following: The defined list separator, single or double quotes, brackets, parentheses, the percent sign (%), the tab character ( \t ), the carriage return character ( \r ), or the new line character ( \n ).
137
11. From the File menu, click Make BatchIDCreation.dll. The Make Project dialog box opens. Compile the project into a .dll named BatchIDCreation dll. 12. Click OK. 13. Replace the default BatchIDCreation.dll in the BATCHCTL\Bin folder with the newly compiled BatchIDCreation.dll. 14. Restart your computer.
138
APPENDIX B
If the password ever expires, the service eventually fails to log on.
If this account is ever disabled/deleted, the service eventually fails to log on.
If the user account is a domain account, remove any local user accounts with the same name.
If you are using a local account and expect that account to have access to resources on other computers in a workgroup environment, you must create accounts with the same name and password on each computer in the workgroup.
Add the new Server user account to the batchsvr_group and Administrators group. By adding the new account to the batchsvr_group it inherits all the required user rights and access permissions. If FactoryTalk Batch Material Manager is part of your system, add the new FactoryTalk Batch Server user account to the MTBatchServer group on the Material Server computer.
139
Add the new FactoryTalk Batch Server user account to the FactoryTalk Batch Server service. (See Changing the Server User Account for the FactoryTalk Batch Server Service for more information.)
If you are running the FactoryTalk Batch Archiver in the incremental mode, add the new FactoryTalk Batch Server user account in the Batch Archiver service. If FactoryTalk eProcedure is part of your system, add the new FactoryTalk Batch Server user account to the eProcedure Server service.
Add the new FactoryTalk Batch Server user account to the Batch COM object in Component Services > My Computer > COM+ Applications. (See Changing the Server User Account in FactoryTalk Batch COM+ Applications for more information.) If you are using Workgroup security, create the new FactoryTalk Batch Server user account on all FactoryTalk Batch Client computers in the Workgroup. Add the new FactoryTalk Batch Server user account to Component Services > My Computer > Properties > COM Security on all remote FactoryTalk Batch View computers. Configure the account with the following Access Permissions: Local Access and Remote Access. (See Changing the Server User Account in My Computer Properties for more information.) If eProcedure is part of your system, add the new FactoryTalk Batch Server user account to Component Services > My Computer > Properties > COM Security on all remote eProcedure client computers. Configure the account with the following Access Permissions: Local Access and Remote Access. (See Changing the Server User Account in My Computer Properties for more information.)
If you are using Workgroup security, change the password for the FactoryTalk Batch Server user account on all FactoryTalk Batch computers in the workgroup. Change the password for the FactoryTalk Batch Server user account in the FactoryTalk Batch Server service. (See Changing the Server User Account for the FactoryTalk Batch Server Service for more information.)
If you are running the FactoryTalk Batch Archiver in the incremental mode, change the password for the FactoryTalk Batch Server user account to the Batch Archiver service. If eProcedure is part of your system, change the password for the FactoryTalk Batch Server user account in the eProcedure Server service.
Change the password for the FactoryTalk Batch Server account in the Batch COM object in Component Services > My Computer > COM+ Applications. (See Changing the Server User Account in FactoryTalk Batch COM+ Applications for more information.)
140
Changing the Server User Account for the FactoryTalk Batch Server Service To change the user account for the FactoryTalk Batch Server service complete to the following steps on the Server computer. 1. Point to Administrative Tools > Services, and then click Services. The Services dialog box opens. 2. Right-click Batch Server, and then click Properties. The FactoryTalk Batch Server Properties dialog box opens. 3. On the Log On tab, select This Account and type the new user and/or password. 4. Click OK.
If you are using the FactoryTalk Batch Archiver in the incremental mode, change the user account name and/or password for the Batch Archiver service. If eProcedure is part of your system, change the user account name and/or password for the eProcedure Server service.
5. Close Services. Changing the Server User Account in FactoryTalk Batch COM+ Applications To change the FactoryTalk Batch Server user account in Batch COM+ Applications complete to the following steps on the FactoryTalk Batch Server computer. 1. Point to Administrative Tools > Component Services. 2. Expand Component Services, Computers, My Computer and COM+ Applications. 3. Right-click Batch, and then click Properties. The Batch Properties dialog box opens. 4. On the Identity tab, select This user and type the new FactoryTalk Batch Server user name and/or password. 5. Click OK.
The new permissions are applied the next time the FactoryTalk Batch Server is started on the computer.
Changing the Server User Account in My Computer Properties To change the FactoryTalk Batch Server user account in My Computer Properties complete to the following steps on the FactoryTalk Batch Client computers. 1. Point to Administrative Tools > Component Services. 2. Expand Component Services and Computers. 3. Right-click My Computer, and then click Properties. The My Computer Properties dialog box opens. 4. On the COM Security tab, click the Edit Default button in the Access Permissions area. The Access Permission dialog box opens. 5. Click the Add button to open the Select Users, Computers, or Groups dialog box.
141
6. Type the new FactoryTalk Batch Server user account name and then click OK. 7. In the Access Permission dialog box, select the new FactoryTalk Batch Server account. In the Permissions list, select Allow for Local Access and Remote Access. 8. Click OK twice. 9. Close Component Services. 10. Restart the computer.
142
APPENDIX C
143
1. On the computer where the FactoryTalk Batch Server is installed, open the Registry Editor: From the Start menu, select Run, type regedit or regedt32 in the Open box, and then click OK.
3. In the right pane, double-click SupportMultipleDisplays. The Edit String dialog box opens.
144
4. Type TRUE in the Value data box, and then click OK.
5. Close the Registry Editor. When the registry variable SupportMultipleDisplays is absent or its value is FALSE in the Batch Server computer, only one instance of the Batch View is allowed on each computer in the FactoryTalk Batch system. When SupportMultipleDisplays is set to TRUE in the Batch Server computer, multiple instances of the Batch View are allowed on each computer in the FactoryTalk Batch system.
145
5. Type the desired name for the new configuration file in the format of BatchVEW_description.ini, where _description is the user name. All configuration file names must start with BatchVEW and end with .ini. Example: There are two users, John and Gail, for whom you are setting up configuration files. Copy and paste BatchVEW.ini and rename it BatchVEW_John.ini. Paste BatchVEW.ini again and rename it BatchVEW_Gail.ini. 6. Start the FactoryTalk Batch View: From the Start menu, select All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch > View. The Display Configuration dialog box opens.
7. Click Start to launch the Batch View with the default BatchVEW.ini file, or select a configuration file from the Available Configurations list, and then click Start. The Batch View opens. The title bar displays the name of the configuration file used to start the program.
Creating Configuration Files When Launching Batch View If you have not yet created unique configuration files for each instance of the Batch View to be opened, you can do so when the Display Configuration dialog box opens.
146
1. Start the FactoryTalk Batch View: From the Start menu, select All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch > View. The Display Configuration dialog box opens.
2. Select the Start View with a New Configuration option. 3. Select a configuration on which to base the new configuration from the Base Configuration list, for example, BatchVEW_John.ini. 4. Type a new user name in the New Configuration Description box, for example BatchVEW_Kelly.ini. The new configuration file name displays in the New Configuration File box. 5. Click Start. The Batch View opens with the name of the configuration file used to start the program displayed in the title bar.
147
Software\Batch; the location of the log files would be C:\Program Path\Rockwell Software\Batch\bin.
If the BatchVEW.ini file does not exist, the Batch View displays an error message and then terminates.
Starting the Batch View With a Configuration File You can specify the configuration file name in the command prompt as follows:
148
If the SupportMultipleDisplays option is set to TRUE on the Batch Server computer and no configuration file is specified in the command prompt, the Display Configuration dialog box opens, allowing you to select an existing configuration file or create a new one. If the SupportMultipleDisplays is set to TRUE on the Batch Server computer and the specified configuration file does not exist, the Batch View displays an error message and then terminates.
149
150
Batch
151
CHAPTER 1
Document Organization
The following subjects are presented in this guide:
Introduction to the FactoryTalk Batch Equipment Editor Configuring Enumerations Using Parameters and Control Strategies Defining Data Servers Creating Global Binding Requirements Process Cell, Unit, and Tag Configuration Configuring Phases and Equipment Modules Using Electronic Signatures Saving and Copying Area Models Importing and Exporting Area Models
As outlined in the ISA S88.01 Batch Control Standard, the facilitys area model is organized into the following S88.01 physical model components:
In addition to the area model creation, the Equipment Editor allows specification of communication functions, as well as FactoryTalk Batch Archiver functions.
153
If you are using FactoryTalk Batch with FactoryTalk Batch Material Manager, you must set security for FactoryTalk Batch to access the material database. (See Security Settings in the FactoryTalk Batch Material Manager Administrators Guide for instructions on implementing Equipment Editor security.)
If a FactoryTalk Security user with Equipment Editor permissions opens Equipment Editor while currently logged on to the FactoryTalk Directory, the security permissions are the same. If a Windows-linked user with Equipment Editor permissions opens Equipment Editor, the user will also be logged on to the FactoryTalk Directory. The Log on to FactoryTalk dialog box opens when a user is not found.
FactoryTalk Windows-linked user: A user account created in Windows and then added to the FactoryTalk Directory.
If the FactoryTalk Use single sign-on system policy setting is Disabled or the Equipment Editor Single-SignOn product policy setting is False then the Log on to FactoryTalk dialog box opens and a FactoryTalk Security user with permissions to open the Equipment Editor must be entered. (See the FactoryTalk Batch Administrators Guide for more information on Equipment Editor security.)
154
2. If the Log on to FactoryTalk dialog box opens, enter a user name and password and then click OK.
3. If you enter a FactoryTalk user name and password that is not configured to run the Equipment Editor, the Batch Equipment Editor dialog box opens.
4. If the user you enter is not found in the FactoryTalk Directory then the Logon Message dialog box opens. Click OK to close the dialog box.
155
The Equipment Editor window contains the following components: Class View Area Displays the existing cell classes, unit classes, or phases in the active area model. The column heading reflects the active level. Double-clicking (or right-clicking) an icon opens the Edit dialog box for that item. Design View Area This area is used to construct the area model and displays the layout of the active level. In Select mode, double-clicking an item displays the layout of the next lower level. Rightclick the item to open the Edit dialog box. Location Bar The location bar indicates the unit and process cell in which you are currently working. The bar is displayed/hidden by selecting Location Bar on the View menu; the selection works as a toggle. Menu Bar
Help
156
Toolbar The FactoryTalk Batch Equipment Editor toolbar contains a group of buttons used to perform commands in the Equipment Editor. The buttons, from left to right, are:
New: Creates an area model. Open: Opens an existing area model. Save: Saves the active area model. Cut: Deletes the highlighted item and saves it to the clipboard. Copy: Copies the highlighted item to the clipboard. Paste: Pastes the cut or copied item from the clipboard. Share: Shares the selected unit or phase.
CTRL
+N +O +S
CTRL
CTRL
DELETE
CTRL
+C +V +H
CTRL
CTRL
Go Down: Moves down through the levels, displaying the next lower level. -Go Up: Moves up through the levels, displaying the next higher level. --
Zoom: Allows you to specify a magnification (between 50% and 200%) of -the current SFC display. Add New Object: Opens the appropriate Create dialog box for the active level. Edit Area: Allows you to edit the area information. Edit Enumerations: Opens the Create Enumeration Sets and Enumerations dialog box. Edit Servers: Opens the Create Servers dialog box. -CTRL
+A +M +D
CTRL
CTRL
Synchronize: Synchronizes the Equipment Area Model with the RSLogix CTRL + L project file. Edit Shared Resources: Opens the Edit Resources dialog box. Edit Properties: Opens the appropriate Edit dialog box for the selected item. Edit Tags: Opens the Edit Tags dialog box.
CTRL
+R +E +T
CTRL
CTRL
157
Edit Unit Attributes: Opens the Edit Unit Attributes dialog box.
CTRL
+U
Edit Global Binding Requirements: Opens the Edit Global Unit Binding CTRL + B Requirements dialog box. Edit Signature Templates: Opens the Edit Signature Templates dialog box. -Configure Command Verification Policies: Opens the Edit Command Verification Policies dialog box. Select Instance: Changes the cursor to the selection tool. Link Units: Changes the cursor to the linking tool. Unlink Units: Changes the cursor to the unlinking tool. Invoke Recipe Editor: Opens the FactoryTalk Batch Recipe Editor.
CTRL
+P
-----
Status Bar On the right side, the status bar displays the selected unit, process cell, and current user name.
158
CHAPTER 2
PHASE_FAILURES YES_NO MATERIALS (for Material Server-installed system) MATERIAL_CLASSES (for Material Server-installed system) CONTAINERS (for Material Server-installed system) REPORTING_CONTEXTS
You are not allowed to change the data type and the members of the YES_NO, MATERIALS, MATERIAL_CLASSES, or CONTAINERS system-maintained enumeration sets. You can also create custom enumerations and enumeration sets within an area model.
Data Servers
A FactoryTalk Batch data server is a reference to an OPC, FactoryTalk Live Data or CIP (Common Industrial Protocol) data server program and one of its associated data sources. Data servers are used to pass data between the FactoryTalk Batch Server and the process
159
connected device (PCD). You configure a separate FactoryTalk Batch data server for each data source, and its associated data server program, that communicates with the FactoryTalk Batch Server. This allows FactoryTalk Batch to access current tag data within the process connected device, which is necessary to successfully run recipes, arbitrate equipment, and control single phases.
The FactoryTalk Live Data protocol is based on the OPC Data Access protocol.
Resources
Resources include any human resources, systems, or items that are not classified as a process cell, unit, or equipment module, but are required to manufacture a batch. Often, resources represent control modules such as pumps, motors, and valves. However, resources are not limited to equipment. Resources can include anything required to create a batch, such as people, quality control systems, forklifts, etc. Once resources are defined, you assign them to process cells, units, and equipment modules as necessary equipment. This information is used by the FactoryTalk Batch Server for arbitration purposes.
Process Cells
A process cell is a logical grouping of equipment required for the production of one or more batches. A process cell must contain all components required to run a specific recipe, including units, equipment modules, and any other required resources, such as control modules.
Units
A unit consists of equipment modules and/or control modules centered around a materialcontaining vessel that performs one or more major processing activities. The material the vessel contains is usually transformed either physically, chemically, or biologically. Units run one operation or unit procedure-level recipe at a time. Process & Instrumentation Diagrams (P&IDs) are a good source of information for determining unit boundaries. Often, process facilities contain multiple instances of similar equipment, such as unit vessels that consist of the same or similar components and functionality. In this case, these groupings of similar equipment can be described as a unit class. In the area model database, you can create unit classes (such as MIXER_CLS), and one or many unit instances (such as MIXER_A and MIXER_B) of a particular unit class. Recipes can be configured to run within a specific unit instance or within a unit class. The action of specifying the particular unit in which a recipe runs is called unit binding. If a recipe is configured to run within a unit instance, the unit in which the recipe will run is specified at the time the recipe is created. If a recipe is configured to run within a unit class, the recipe can run in any unit instance of that unit class. The specific unit instance is determined in one of the following ways:
By the operator when the batch is created, prior to starting the batch. By the operator, after the batch is started, at the time a unit procedure level recipe is ready to run (the operator responds to a prompt). By the FactoryTalk Batch Server, after the batch is started, at the time a unit procedure level recipe is ready to run.
160
They minimize the number of recipes that need to be maintained. They allow the freedom to choose the most appropriate unit to which to bind the recipe at the time the batch is run.
Unit Attribute Tags Unit attribute tags are items in the area model database that represent a single piece of process-connected device information. Unit attribute tags are linked to a process tag such as a level, temperature, or flow process variable. Unit attribute tags allow actual process values to be used in recipe transition conditions. To define unit attribute tags in the area model database, create unit attributes (such as LEVEL_PV) and unit attribute tag instances (such as LI101_PV). Each unit attribute tag instance is linked to a specific tag in the process-connected device. Each unit instance may have one (and only one) unit attribute tag instance of each unit attribute. Once a unit attribute tag instance is defined, it is part of the area model database and can be used in recipe transition conditions for any recipe. In other words, the unit attribute tag instance can be used in a recipe that will be bound to any unit instance in the area model (not just the unit instance for which the unit attribute tag was defined).
Phases
A phase is usually a general representation of a group of equipment that performs a minor processing activity or a sub-function for a unit. Phases may have associated parameters and reports. An instance of a phase is referred to as an equipment module. Each phase contains attributes common to all equipment modules of that specific phase type. Phases are used to create recipes in the FactoryTalk Batch Recipe Editor. Parameters Parameters are used by the FactoryTalk Batch Server to send values to the processconnected device. Parameters are configured for individual phases using the FactoryTalk Batch Equipment Editor. When a phase is added to an operation using the FactoryTalk Batch Recipe Editor, the phase inherits these parameters as formula values. You may then accept the default values, assign new values, or defer the value assignment to a recipe parameter or to the operator. Parameters are useful when trying to minimize the number of phases or recipes that must be created. All material-enabled phases have mandatory MATERIAL and AMOUNT parameters. Optionally, CONTAINER, MATERIAL_CLASS, LOT, and LABEL parameters may be added. Reports The FactoryTalk Batch Server uses reports to receive values from the process-connected device. Reports are configured for individual phases using the FactoryTalk Batch Equipment Editor. All material-enabled phases have mandatory ACTUAL_AMOUNT and FEED_COMPLETE reports.
161
Control Strategies Control strategies are user-defined groupings of parameters and reports that can be associated with a single phase. Organizing parameters into separate control strategies allows phases to assume multiple roles without generating unnecessary phase I/O. Upload/Download Parameter Subsets The Upload/Download Parameter Subsets allow you to define phase recipe parameter subsets for Download on Start and Download on Transfer of Control, providing for more efficient batch execution. Similarly, you can also define phase report parameter subsets for Upload on Transition to a Terminal State and Upload on Transfer of Control. Download Parameter Subsets When parameters are defined for a phase class, they can be optionally grouped into subsets: Download on Start or Download on Transfer of Control.
If Download on Start is selected, the FactoryTalk Batch Server downloads these parameters to the process-connected device (PCD) before the Server issues a Start command to the phase. Once the download is verified, the Server starts the phase. The phase logic can explicitly request this or the equipment module can be configured for the Server to automatically download these parameters before it issues a START command. If Download on Transfer of Control is selected, the parameters may be downloaded to the PCD when a Transfer of Control situation occurs. Transfer of control means that two instances of the same phase exist in a recipe and are separated by a recipe transition condition that contains something other than <Phase Name>.State = Complete. In this case, the phases running logic does not terminate when the transition condition becomes true. When the transition condition becomes true, the phase logic must explicitly request the Server to download the Transfer of Control subset of parameters to the PCD.
Upload Report Subsets When reports are defined for a phase class, they can be optionally grouped into subsets: Upload on Terminal State or Upload on Transfer of Control.
If Upload on Terminal State is selected, the FactoryTalk Batch Server uploads this subset of reports from the process-connected device (PCD) after the phase logic transitions to a terminal state of COMPLETE, STOPPED or ABORTED. The phase logic can explicitly request the Server to upload these reports or the equipment module can be configured for the Server to automatically upload these reports after the phase logic transitions to a terminal state. If Upload on Transfer of Control is selected, the reports are uploaded to the PCD when a Transfer of Control situation occurs. In this case, the phase logic must explicitly request the FactoryTalk Batch Server to upload the Transfer of Control report subset from the PCD.
162
Equipment Modules
An equipment module is an instance of a phase. When a phase is added to a unit it becomes an equipment module. An equipment module maps to the equipment phase in the engineered logic via tag addresses. If a single instance of this phase is required by multiple units, it may be shared between the units. Usually, there is only one instance of a phase per unit. Material-enabled phases, however, allow multiple instances of a phase within a single unit. Equipment modules mapped to the same phase have independent resource IDs. Equipment Module Tags Equipment module tags represent data associated with a specific equipment module during the execution of a recipe. The number of tags associated with an equipment module depends on the actual phase configuration. Each equipment module has a minimum of ten pre-defined tags with which it is associated. Additional tags may be configured. There are three types of additional tags:
If the phase is configured to require any of these additional tags, a corresponding tag is created in the equipment module.
1. From the File menu, select New. A blank area model is created. 2. From the Edit menu, select Area, or click the Edit Area toolbar button. The Edit Area dialog box opens. 3. Type a unique name for the area in the Name box. 4. Type a version number in the Version box. Click OK to return to the Design View area. The area name is displayed in the title bar of the Design View area. 5. From the File menu, select Save or Save As. The Save As dialog box opens with Untitled.cfg as the default file name. 6. Type an appropriate file name, and then click Save to save the area model. The area model is saved to the configuration file and can be opened at any time for modification. 7. Restart the Batch Server to use the new area model.
You must restart the FactoryTalk Batch Server to initiate the changes and re-verify any recipes that are to run against any area model you have modified.
163
If you are also running Material Manager and the FactoryTalk Batch Server loses communications with the Material Server while the area model is being created or edited, some of the enumeration sets will contain only the default values NULL_MATERIAL, NULL_CLASS, and NULL_CONTAINER. (See the FactoryTalk Batch Administrators Guide for more information on the various Batch Server restart options.)
When opening area models created using FactoryTalk Batch version 10.0 or later, you are given the option to have the area model automatically migrated to the latest Batch version. Your existing data is migrated to the new schema. If you choose not to migrate the area model, you are unable to open it in the current FactoryTalk Batch Equipment Editor version.
164
Handling Material Database Changes FactoryTalk Batch Material Manager only If a member of the MATERIAL enumeration set previously assigned to a phase is no longer in the material database, a warning message displays the error.
Selecting Continue causes the NULL_MATERIAL enumeration to be substituted for the unsupported enumeration. Selecting Cancel opens the area model unchanged. When you open the affected phases Parameter tab, the first enumeration in the alphabetically sorted list will be substituted for the unsupported enumeration.
The controller ID of a material and container is used as the ordinal value for the enumeration. If the items controller ID is modified in the material database, the ordinal value of the associated enumeration changes, which could affect the phase logic.
Material Database Is Unavailable The MATERIALS and CONTAINERS enumeration sets are recreated each time an area model is created, opened, or imported. If the Material Server is unavailable, the enumeration sets will only contain the default values NULL_MATERIAL and NULL_CONTAINER.
165
166
CHAPTER 3
167
1. From the File menu, select Import. The File Import dialog box opens.
2. From the Files of type list, select XML Files (*.axml). 3. Locate and select the XML file to import. 4. Click Open to initiate the import process. A message box displays the name of each component being imported and validated. 5. When the import process is complete the message, All sections have been imported! displays. Click OK to complete the import process and return to the Equipment Editor. 6. From the File menu, select Save As to save the newly imported file. The Save As dialog box opens with Untitled.cfg highlighted in the File name box. 7. Type the new file name in the File name box, being sure to overwrite the current file name. 8. Click Save to save the new file. The new area model is saved and the file name is displayed on the Equipment Editor title bar.
If you named the file anything other than the area model currently selected in the Server Options dialog box, you must change the Server Options settings before you can use the new area model. (See the FactoryTalk Batch Administrators Guide for information on setting server options.)
Importing Enumerations The following system enumeration sets are created and maintained by the FactoryTalk Batch Equipment Editor:
PHASE_FAILURES YES_NO REPORTING_CONTEXTS MATERIALS (if Material Server is installed) MATERIAL_CLASSES (if Material Server is installed) CONTAINERS (if Material Server is installed)
168
With the exception of PHASE_FAILURES and REPORTING_CONTEXTS, you cannot change the data type or the members of these system-maintained enumeration sets. The XML file must include these system enumeration sets only for the purpose of validation against the schema. These system enumeration sets cannot be imported.
The PHASE_FAILURES AND REPORTING_CONTEXTS system enumeration sets can be imported along with any user-defined enumerations in these enumeration sets.
Importing System Phases The following system phase sets are created and maintained by the FactoryTalk Batch Equipment Editor:
$NULL $TIMER
On import of system phases, the entire phase is validated and only those that match completely are imported. The $NULL phase class is validated against the following:
The name of the phase class must be $NULL There must be no configured recipe or report parameters There must be no configured messages There must be no configured control strategies There must be no configured request parameters There must be no configured message partners All other configurable values are not set
On import of system phases, the entire phase is validated and only those that match completely are imported. The $TIMER phase class is validated against the following:
The name of the phase class must be $TIMER_X (where X is the type of Timer and the unit of measure; $TIMER_DN_SECOND or $TIMER_UP_DAY, for example) There must be no configured messages There must be no configured control strategies There must be no configured request parameters There must be no configured message partners
If any of the system phases ($TIMER or $NULL) contain errors only the first error is displayed.
The following message will be displayed when the export process is complete: Area configuration data has been exported to the file: [path&filename]. 6. Click OK to complete the export process and return to the Equipment Editor. Exporting Enumerations With the exception of PHASE_FAILURES and REPORTING_CONTEXTS, you cannot change the data type or the members of the system-maintained enumeration sets. The XML file must include these system enumeration sets only for the purpose of validation against the schema. These system enumeration sets can be exported but cannot be imported. See Importing Enumerations for a list of all system enumeration sets.
The PHASE_FAILURES AND REPORTING_CONTEXTS system enumeration sets can be exported along with any user-defined enumerations in these enumeration sets.
Exporting System Phases All system phases ($NULL or $TIMER) are exported. All associated recipe and report parameters and associated data (for $TIMER_X phases) are part of the export (where X is the type of Timer and the unit of measure; $TIMER_DN_SECOND or $TIMER_UP_DAY, for example).
170
The command line validates the information in the XML file and overwrites the existing file specified by OutputFile. Any error messages will be appended to the log file.
The command line program will not validate material-specific information, which includes: Running status of the Material Server Existence of the referenced materials Existence of the referenced material classes Existence of the referenced containers
If the command line arguments are valid, the program returns a 0 (zero), indicating a successful import. If the command line arguments are invalid, the command line program returns a 1 (one), indicating a failure. You can view the return code in the log file (shown below) to check if the conversion succeeded or failed.
AreaModelXMLToBinary.exe must be installed in the Batch/bin directory. AreaModelXMLToBinary.tlb must be installed in the Batch/bin directory.
171
The COM object can be accessed in any COM-aware programming environment. COM Object Syntax The syntax of the interface method of the COM object is:
HRESULT AreaModelXMLToBinary.ConnvertXMLToBinary (BST InputFile, BSTR OutputFile)
where:
AreaModelXMLToBinary: BSTR InputFile: BSTR OutputFile: Example using C++: Instance of the interface IAreaModelXMLToBinary Specifies the path for the input XML filename. Specifies the path for output binary filename.
If you are using C++ to create the COM object, the syntax looks like the following code sample:
#import AreaModelConvert.tlb .... IAreaModelConvertPtr piAreaModelConvert; piAreaModelConvert.CreateInstance(AreaModelConvert.AModelXMLToBinary ); HRESUTL hr= piAreaModelConvert ->ConnvertXMLToBinary (InputFile, OutputFile); BSTR bstr = piAreaModelConvert ->MessageString(); Example using Visual Basic:
If you are using Visual Basic to create the COM object, the syntax looks similar to the following example.
Dim obj As Object Dim returnCode As Integer Set obj = CreateObject(AreaModelConvert.AreaModelXMLToBinary) returnCode = obj.ConvertXMLToBinary([InputFile], [OutputFile]) If returnCode = 0 Then MsgBox (Conversion Successful) Else MsgBox (Error: & Conversion did not complete.)
where: [InputFile] is the path and file name of the XML area model (.axml) and [OutputFile] is the path and file name of the binary area model file (.cfg). Spaces are not allowed in the path names unless contained in quotation marks, as shown in the previous example. UNC names are also supported, as demonstrated in the syntax example below.
returnCode = obj.ConvertXMLToBinary(\\batchctl\SampleDemo1\recipes\ice_cream1.axml , \\batchctl\SampleDemo1\recipes\ice_cream1.cfg)
172
CHAPTER 4
Using Enumerations
Enumerations are a variable data type consisting of a numeric value (called an ordinal value) and an associated text string. The process-connected device and the FactoryTalk Batch Server communicate using the numeric ordinal value. The Server then displays the ordinal values associated text string to the operator. Enumeration sets are used to group related enumerations.
Negative ordinal values can also be used as shown in the following example. Example:
The agitator in Premixer B (Unit #2) might use the following enumeration set:
* PHASE_FAILURES enumerations cannot have an ordinal greater than 32767 or less than 0 (zero).
PHASE_FAILURES
By default there are no members in this enumeration set. You need to add your own enumerations, based on your particular implementation requirements.
PHASE_FAILURES enumerations cannot have an ordinal greater than 32767 or less than 0 (zero).
REPORTING_CONTEXTS
This enumeration set makes it possible to add reporting context strings to phase parameters and reports, so the events about them may be more easily queried and
173
sorted. You can add, remove and edit enumeration set members to this enumeration set. The default enumeration is NULL, with an ordinal value of 0.
PHASE_FAILURES and REPORTING_CONTEXTS are the only system enumeration sets to which you can add enumerations. System enumeration sets are displayed in bold text to differentiate them from custom enumeration sets.
YES_NO
This is a simple enumeration set that contains two members: NO with an ordinal value of 0 and YES with an ordinal value of 1. You cannot modify this enumeration set.
Represents the set of materials configured in the Material Manager material database. The default enumeration is NULL_MATERIAL, with an ordinal value of 0. This value allows you to assign an enumeration to a parameter of type MATERIALS, delaying the actual material assignment until the recipe is built. All other enumeration set members are recreated each time an area model is created, opened or imported, based on the material data in the material database. The controller ID range for Materials is from 1 to 9999999999.
The MATERIALS and CONTAINERS enumeration sets only contain the default enumerations if the Material Manager material database is unavailable.
Represents the set of containers configured in the Material Manager material database. The default enumeration is NULL_CONTAINER, with an ordinal value of 0. All other enumeration set members are recreated each time an area model is created, opened, or imported, based on the container data in the material database. The controller ID range for Containers is from 1 to 9999999999.
The controller ID of a material and container is used as the ordinal value for the enumeration. If the items controller ID is modified in the material database, the ordinal value of the associated enumeration changes, which could affect the phase logic.
Represents the set of material classes configured in the Material Manager material database. The default enumeration is NULL_CLASS, with an ordinal value of 0. All other enumeration set members are recreated each time an area model is created, opened, or imported, based on the material class data in the material database. The MATERIAL_CLASSES enumeration set members created from the material server have a one-to-one relation with the material classes in the Material Server The name of the enumeration member is the material class name and the ordinal of the enumeration member is the controller ID of that material class. The Material Class controller ID range is from 1 to 9999999999.
174
4 Using Enumerations
2. Click the New button in the Sets box. The Create Enumeration Set dialog box opens.
3. Type the new enumeration set name. Click OK to return to the Create Enumeration Sets and Enumerations dialog box. The new enumeration set name is displayed in the Enumeration Sets column.
If you do not add members to a new enumeration set, the set will not display as an option in the Enum/E.U. dropdown list when updating phase parameters and/or reports.
You cannot add members to the system enumeration sets: YES_NO, MATERIALS, MATERIAL_CLASSES, and CONTAINERS.
2. Type the enumeration name and the ordinal, or accept the default ordinal value. Click OK to return to the Create Enumeration Sets and Enumerations dialog box. The new enumeration name displays in the Enumerations column.
PHASE_FAILURES enumerations support positive ordinals from 0 to 32767 only.
175
1. Open the Create Enumeration Sets and Enumerations dialog box. 2. Click the enumeration set or enumeration to be edited. 3. Click the appropriate Edit button.
If you are editing an enumeration, type the new enumeration name and a new ordinal value if you want to change the default value.
If you are editing an enumeration set that has not yet been assigned to any tag, parameter, or report items, the Edit Enumeration Set Name dialog box opens.
a. Enter the new enumeration set name and click OK to return to the Create Enumeration Sets and Enumerations dialog box. If the enumeration set has already been assigned to tags, parameters, or reports, a warning appears with a list of the items to which the enumeration set has been assigned.
b. Click Yes to edit the enumeration set name. The items listed in this dialog box will be modified to include the new enumeration set name. Or, click No to cancel the modification.
176
4 Using Enumerations
3. Click OK to return to the Create Enumeration Sets and Enumerations dialog box. 4. Click Close to return to the Equipment Editor Design View area.
3. Click the Delete button. Continue to step 4 if you are deleting an enumeration. Skip to step 5 if you are deleting an enumeration set. 4. Enumerations:
If the enumeration is not used as a default for a phase parameter, a warning appears verifying deletion of the enumeration. Click Yes to delete the enumeration. Click No to cancel the deletion. If the enumeration is used as a default for a phase parameter and you click Yes to delete, a message appears stating that the enumeration cannot be deleted and gives the phase parameter name with this enumeration as the default value. The phase parameter must first be modified to remove the enumeration as the default value. Click OK to close the warning dialog box and return to the Create Enumeration Sets and Enumerations dialog box. If the enumeration set has not yet been assigned to any tag, parameter, or report items, a warning appears verifying deletion of the enumeration set. Click Yes to delete the enumeration. Click No to cancel the deletion. A warning appears with a list of the items to which the enumeration set has been assigned.
5. Enumeration Sets:
a. Click Yes to delete the enumeration set. A message displays the number of tags, parameters, and reports that will change because of the deletion. Click OK to close the message dialog box and return to the Create Enumeration Sets and Enumerations dialog box. b. Click No to cancel the deletion. 6. Click Close to return to the Equipment Editor Design View area.
Items that were using the deleted enumeration set will be defaulted to Type = Integer and Eng.Units = Eng.Units.
177
178
CHAPTER 5
Accept the default formula value (this is the corresponding phase parameters default value). Assign a new value. Defer the formula value assignment to the operator or to another kind of parameter associated solely with the recipe called a recipe formula parameter. (See the FactoryTalk Batch Recipe Editor User's Guide for more information on recipe formula parameters).
Using parameters can minimize the number of phases or recipes that need to be created. (See Parameters for more information.)
Parameters Example
Following is an example of how parameters can be used in implementing FactoryTalk Batch: A plant has a unit that can be used to mix several different products. You need to define a phase indicating the agitators speed in the mixer unit. You could define a different phase for each of the required speeds, or you could define one phase and configure a parameter for the agitator speed. When you use the phase in a recipe, you can assign a value immediately or later. By deferring the value assignment, you create one operation that can be used in multiple recipes.
179
Every OPC equipment module has a minimum of ten standard tags. When you configure the phase from which the OPC equipment module is created, you define the number of tags required for parameter and report communications, as well as additional request tags.
For PhaseManager equipment modules assigned to a Logix5000 CIP data server, you do not need to define the number of parameter, report, and request tags. The correct number of tags are automatically configured when you synchronize the area model with the RSLogix 5000 project. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
Configuring Additional Request, Parameter, and Report Tags for Equipment Modules
One of the ten standard tags associated with every OPC equipment module is a Request tag. The process-connected device uses the Request tag to request service from the FactoryTalk Batch Server. Sometimes, the process-connected device needs to communicate more information to the Server than can be accommodated by the single standard Request tag. For this purpose, you may also specify, on the phase, the number of additional request tags needed for an OPC equipment module. (See the FactoryTalk Batch PCD Programmer's Technical Reference Guide for more information.)
For PhaseManager equipment modules assigned to a Logix5000 CIP data server, you do not configure request tags. The tags are automatically created for Logix5000 CIP equipment modules when you synchronize the area model with the RSLogix 5000 project. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
It is possible to configure a different number of phase parameters and reports than parameter and report tags for an OPC equipment module. For some OPC equipment module phase logic programs, you may not want the number of parameters to match the number of parameter tags, or the number of reports to match the number of report tags. If you want the number of parameters and reports on the phase to always equal the number of parameter tags and report tags on the associated equipment modules, you can enable Parameter/Tag Locking on the phase. (See Configuring Phases for more information.) If you do not have Parameter/Tag Locking enabled, you must specify, on the phase, the number of parameter and report tags that exist on the associated OPC
180
equipment modules. This number may be different from the number of defined phase parameters and reports for OPC equipment modules.
For Logix5000 CIP equipment modules, Parameter/Tag Locking is always enabled, regardless of the setting you select. When you synchronize the area model with the RSLogix 5000 project file, the Equipment Editor creates the same number of parameter tags as parameters that exist on the phase, and the same number of report tags as reports that exist on the phase. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
The number of parameters and reports associated with the phase. The number of tags in the equipment module that are associated with those parameters, reports, and additional requests. This is done either by enabling parameter/tag locking, or by specifying the actual number of tags.
The configuration for RSLinx Enterprise FactoryTalk Live Data (FTD) tags is identical to that of OPC tags.
When you create the OPC phase instance (equipment module assigned an OPC data server), you specify:
The memory addresses/tags in the process-connected device associated with each of the ten standard tags. The memory addresses/tags in the process-connected device associated with any configured parameters, reports and additional request tags.
If the number of equipment module tags does not equal the number of parameters for the specified phase (the number of equipment module tags should be equal to the highest parameter ID number), the Upload/Download functionality will not operate correctly. Additionally, in order to correctly pass parameter values, the phase logic must use request data parameters for specifying how FactoryTalk Batch uploads the parameters.
181
The following table shows each parameter and report data type that can be defined in the Equipment Editor and its corresponding data types that can be stored in PCD memory:
Equipment Editor Data Type Real Integer Enumeration String Compatible PCD Data Types Real Real, Integer Real, Integer String
Phase Parameters
Phase parameters are values passed from the FactoryTalk Batch Server to the phase logic during the recipe phases execution. Phase parameters usually correspond to Equipment Module tags, which are addressed to actual, configured parameters in the processconnected device. When you are configuring the phase, you define phase parameters. When you are configuring the OPC equipment module, you define the corresponding parameter tags, including the address or tag in the process-connected device to which it is addressed.
For PhaseManager equipment modules that are assigned to a Logix5000 CIP data server, the parameter tags are automatically created when you synchronize the area model with the RSLogix 5000 project. You do not have to define parameter tags for Logix5000 CIP equipment modules.
Phase Reports
Phase reports are values passed from the process-connected device to the FactoryTalk Batch Server. Report values contain data that indicates how the phase functioned. They are included in the event journal file (.evt) for the running batch and can be included in FactoryTalk Batch reports. Phase reports usually correspond to equipment module tags which are addressed to configured parameters in the process-connected device.
The configuration for RSLinx Enterprise FactoryTalk Live Data (FTD) report tags is identical to that of OPC tags.
182
When you are configuring the phase you define phase reports for the phase. When you are configuring the OPC equipment module, you define the corresponding report tags, including the address or tag in the process-connected device to which it is addressed.
For PhaseManager equipment modules that are assigned to a Logix5000 CIP data server, the report tags are automatically created for you when you synchronize the area model with the RSLogix 5000 project. You do not have to define report tags for Logix5000 CIP equipment modules.
Types of Containers
There are three types of containers used in Material Manager: Composite, Plug-Flow and Pallet. All three containers require the material specification to contain at least a material name. Composite and plug-flow containers support a material specification that includes a lot name. Pallet containers support a material specification that includes a lot name and/or a label. So, if you have a material specification that is only a material name, then any three of the container types are valid. However, if you have a material specification that includes a material name, lot, and label, then only the pallet container type is valid.
183
The CONTAINER parameter is used to hold the name of the container to which a step is bound when a batch is run. It is created with a default value of NULL_CONTAINER. The CONTAINER parameter cannot be assigned a value in the area model or in a recipe. Either the FactoryTalk Batch Server or the operator determines the appropriate container to which the step should be bound. At that time, the value of the bound containers name is assigned to the CONTAINER parameter. Other than the default value, the parameter will only contain a value while the step is bound during run time. The MATERIAL_CLASS parameter represents a set of material classes configured in the material database. It is created with a default value of NULL_CLASS. The only attributes of MATERIAL_CLASS that can be modified are Default and Download on Start, depending on whether or not control strategies are enabled. The LOT parameter is used to refine the list of materials to which a phase can be bound. The lot specifies a discrete quantity of a given material. When this parameter is blank at run time, the Batch Server will bind to a container without regard to the lot. The LABEL parameter represents a sublot of a material, which is a discrete quantity of a given materials lot distributed to a specific container. In material addition phases, the label is used to refine the material list to which a phase can be bound. In material distribution phases, the label is applied to the sublot of material distributed into inventory.
You cannot edit the values of the optional material parameters (except for the MATERIAL_CLASS parameter) within the FactoryTalk Batch Equipment Editor.
Scaling Parameters
By selecting the Scale checkbox for a parameter, you can set a parameter to automatically be adjusted proportionally when a batch containing an equipment module that is based on this phase class is scaled at runtime. For the parameter example shown below, if a batch containing an equipment module based on this phase class was run at a scale of 200%, the ADD_AMOUNT value would be automatically incremented by 200%. The ADD_AMOUNT would be adjusted to 100, since the Default is 50. Likewise, if the batch was run at a scale of 50%, the ADD_AMOUNT would be adjusted to 25.
184
Method is the policy portion that defines the set of acceptable limits for a parameter or report. When you add a parameter or report to a phase you can accept the default Verification Method, which is No Limits, or you can select a different Verification Method. (See Configuring Verification Policies for more information.)
If you want to require electronic signatures as part of a Verification Policy, you must set up Signature Templates before you configure the Verification Policy. (See Creating a Signature Template for more information.)
185
The example phase contains three phase parameters, PARAMETER_A, PARAMETER_B, and PARAMETER_C, and a report parameter named REPORT_A. As illustrated above, a parameter can be associated with only one control strategy as is the case with PARAMETER_A and PARAMETER_C, or it can be associated with more than one control strategy as is the case with PARAMETER_B and REPORT_A. Additionally, parameters associated with more than one control strategy can have separately defined values for each control strategy as illustrated by PARAMETER_B.
186
control strategies. Additionally, if a phase is executed using manual phase control, you can select which control strategy to use before running the phase.
The tags in the equipment module and the phase logic in the process-connected device(s) must be configured to support control strategy use. When a process-connected device requests to download phase parameters or upload phase reports, only the appropriate phase parameters and reports will be loaded, based on the control strategy. You are responsible for properly configuring and mapping the phase and report parameters to the tags in the process-connected device(s). (See the FactoryTalk Batch PCD Phase Programmers Technical Reference for information on working with the PCD interface.)
You can assign parameters to none, one, or both of the upload/download sets. By assigning a parameter or report to a subset, that parameter/report, along with the other members of the subset, will be downloaded (parameters) or uploaded (reports) when the appropriate phase logic request is issued. The following sections, Download Parameter Requests and Upload Report Requests describe these requests.
The 145 (Request Failed) command value can be issued by the FactoryTalk Batch Server when processing a phase logic request experiences an error. This enhanced error handling phase logic protocol is optionally supported by making a request where the value is 10,000 greater than the current standard requests. For example, if you wish to upload a report parameter using the enhanced phase logic request, add 10,000 to the standard request code of 2200 to get the enhanced request code of 12200. (See the FactoryTalk Batch PCD Programmers Technical Reference for more information.) When using Auto Upload with the FactoryTalk Batch Server configured for Warm or Warm All Restart, the Server may upload material addition information twice when a phase is transitioned to External during the upload. Check the journal file. If the upload has occurred twice, you should manually adjust the amount in the material database. The setpoint of the amount parameter is recalculated with each warm restart as well, so this number may need to be manually updated.
187
The following table is an example of a phase and how its parameters and reports can be assigned to the different subsets.
AGITATE_1 Parameters SPEED TIME LEVEL TEMP. TIME_2 AMT_TO_DUMP DL on Start X X X X X X DL on TOC Reports X X AGITATE_TIME AVG_TEMP AVG_SPEED AMT_DUMPED UL on Terminal State X X X X X UL on TOC X
If you want the FactoryTalk Batch Server to download only the parameters assigned to the Download on Start subset, use the following download requests:.
(OPC or FTD) equipment modules 1501 or 11501 request Logix5000 CIP equipment modules PXRQ instruction, External request: Download Input Parameters Subset DINT[0] - 1
If you want the FactoryTalk Batch Server to download only the parameters assigned to the Download on TOC (Transfer of Control) subset, use the following download requests:
(OPC or FTD) equipment modules 1502 or 11502 request Logix5000 CIP equipment modules PXRQ instruction, External request: Download Input Parameters Subset DINT[0] - 2
When one of these requests is issued, each parameter is downloaded to the memory address or tag in the process-connected device that corresponds to the parameter tag in the equipment module. (See the FactoryTalk Batch PCD Programmers Technical Reference for more information on OPC or FTD equipment module Download requests. See the FactoryTalk Batch PhaseManager Users Guide for more information on Logix5000 CIP equipment module Download requests.)
188
If you want the FactoryTalk Batch Server to upload only the reports assigned to the Upload on Terminal State subset, use the following upload requests:
(OPC or FTD) equipment modules 2501 or 12501 request Logix5000 CIP equipment modules PXRQ instruction, External request: Upload Output Parameters Subset DINT[0] - 1
If you want the FactoryTalk Batch Server to upload only the reports assigned to the Upload on TOC (Transfer of Control) subset, use the following upload requests:
(OPC or FTD) equipment modules 2502 or12502 request Logix5000 CIP equipment modules PXRQ instruction, External request: Upload Output Parameters Subset DINT[0] - 2
(See the FactoryTalk Batch PCD Programmers Technical Reference Guide for more information on the OPC or FTD equipment module Download requests. See the FactoryTalk Batch PhaseManager Users Guide for more information on the Logix5000 CIP equipment module Download and Upload requests.)
Automatically download the parameters grouped into the Download on Start Subset when all the conditions required to start the phase are true. Automatically upload the appropriate report values grouped into the Upload on Terminal State Subset when the phase transitions to a terminal state of COMPLETE, STOPPED or ABORTED.
189
The Automatic Upload/Download feature eliminates the need to send the Download on Start or Upload on Terminal State request from the phase logic to the FactoryTalk Batch Server.
Downloading parameters on Transfer of Control and uploading reports on Transfer of Control is not automatic and still requires a phase logic request.
The Automatic Download Parameter on Start and Upload Report on Terminal State functions are configured for each individual equipment module (as long as the parameters and reports of the phase from which the equipment module was created are grouped into the appropriate subsets). The Automatic Download Parameter on Start and Upload Report on Terminal State functions may also be configured independently of each other on an equipment module. In addition, for the Upload Report on Terminal State function, you may specify any or all terminal states for which the automatic function is applicable: COMPLETE, STOPPED or ABORTED.
The 145 (Request Failed) command value can be issued by the FactoryTalk Batch Server when processing a phase logic request experiences an error. This enhanced error handling phase logic protocol is optionally supported by making a request where the value is 10,000 greater than the current standard requests. For example, if you wish to upload a report parameter using the enhanced phase logic request, add 10,000 to the standard request code of 2200 to get the enhanced request code of 12200. (See the FactoryTalk Batch PCD Programmers Technical Reference for more information.)
When a phase logic request is issued for Download on Start, only the SPEED, TIME, LEVEL, and TEMP parameters will be included. When a phase logic request is issued for Download on TOC, only the SPEED and TIME parameters will be included. When a phase logic request for Upload on Terminal State is issued, only the AVG_SPEED, AGITATE_TIME, AVG_TEMP, and AMT_DUMPED reports will be included.
190
When a phase logic request for Upload on TOC is issued, only the AVG_SPEED and AGITATE_TIME reports are included.
AGITATE_1 (Control Strategies enabled; CS1 is the default control strategy) DL on DL on Start TOC CS1 X X X X X X X X X X X UL on Terminal State X UL on TOC CS1 X X X X X X
Reports AVG_SPEED
AGITATE_TIM X E AVG_TEMP X
AMT_DUMPED X
AMT_TO_DUMP X
191
192
CHAPTER 6
Report parameters for automated and manual (eProcedure) phases Changes to the recipe parameter values made by operators from the FactoryTalk Batch View or ActiveX controls Completion of eProcedure steps Batch or phase commands issued by operators from the FactoryTalk Batch View or ActiveX controls General usage that can be configured to display at any time when executing an automated or manual phase
Electronic signatures are stored in the Batch Event Journal with their corresponding electronic records. These electronic signatures include all the components necessary for compliance with 21 CFR Part 11.
In the FactoryTalk Batch Equipment Editor, select the FactoryTalk Batch Archiver event filters for the signature events you want to capture for use in FactoryTalk Historian for Batch reports or other reports. (See the FactoryTalk Batch Archiver Users Guide and the
193
FactoryTalk Batch Administrators Guide for more information on configuring the Archiver event filters for electronic signatures.)
If Electronic Signatures are enabled, you must specify Archiver (End-of-Batch) archiving to ensure that all event journal records are properly archived.
Next, create signature templates for your area model. If you want to obtain electronic signatures for recipe parameters and report parameters of specific phases, you must configure the verification method and signature template to be used when you create or edit the phase. If you want the FactoryTalk Batch Server to download all the limits information to the phase logic, map parameter tags and report tags to the appropriate limit tags on the equipment modules. If you want to require signature verification for the execution of specific commands, set up command verification policies in the Equipment Editor, using the signature templates you created. These steps are discussed in more detail later in this chapter. When the master recipe is built, the recipe parameter limits that trigger the verification policy are defaulted from the parameter limits specified on the equipment phase. These values can be changed at the recipe level in the FactoryTalk Batch Recipe Editor. If a phase has been configured to obtain a signature for deviation of report limits, those limits must be specified on the report for the phase in the Recipe Editor. (See the FactoryTalk Batch Recipe Editor Users Guide for more information.) When a batch is run and parameter or report deviations occur requiring signature verification, or the operator issues commands requiring signature verification, a signature is added to the signature list in the View, the Electronic Signature ActiveX control, or the eProcedure client, prompting the appropriate users to enter signatures. (See the FactoryTalk Batch View User Guide, FactoryTalk Batch ActiveX Controls User Guide, and the FactoryTalk eProcedure Client Users Guide for more information.) All signatures entered are recorded as Signature events and can then be viewed in the Batch Event Journal viewer in the Batch View. (See the FactoryTalk Batch Administrators Guide for more information on the electronic signature event types. See the FactoryTalk Batch View Users Guide for more information on viewing signature events in the Batch Event Journal viewer.) After signature event data is generated you can create FactoryTalk Historian Classic for Batch reports or other reports that capture electronic signature data.
194
The following flow chart shows the sequence of tasks in the setup and configuration, execution, viewing, and reporting of electronic signatures.
195
Adding a Signature Template Configuring Signature Template Signoffs Assigning Security Permissions for a Signoff
Template Index
Signoffs Tab Template Name Signoff Lists the templates that have been added on the General tab. Select the template to see its signoff information or to configure signoffs. Each number in the list represents a required signature for the selected template. These values are determined by the value selected in the Signoffs Required field on the General tab. Select the number of the Signoff you want to see or configure. Keep in mind which value you selected in the Last Signoff field on the General tab. (Optional) Enter a short phrase describing the significance of the selected signoff, for example, Command Authorized by Signer, Done By Signer, or Checked by Signer. The Meaning is displayed as part of the signoff event recorded in the Batch event journal. The Meaning field can range from 0-80 characters, and can contain any viewable and printable character. Special control or non-printable characters are not valid.
Meaning
196
Definition Select whether a comment is Optional, Required, or Not Allowed by the signer at the time the signoff is entered. Displays the users and groups of users that can complete the selected signoff. If this area is blank, no security permissions have been configured yet. Security Permissions must be configured for all signoffs before the Edit Signature Templates dialog box can be closed. Opens the Select Group dialog box where you select which users and groups have permission to complete the selected signoff. Removes the selected user or group from the Security Permissions box, and removes the users or groups permission to complete the selected signoff.
Add Delete
3. Click the New Template button. The Create Signature Template dialog box opens.
4. In the Template Name field, enter a unique name to identify the template. The name must begin with an alpha character (a-z or A-Z) and may be followed with any
197
combination of alphanumeric characters or underbars. This field is not case sensitive. Spaces are not accepted as valid input.
Choose a name that will easily identify the templates properties or purpose. The Template Name will be used to identify the signature template when the command verification policies, phases, and recipes are being configured.
5. (Optional) A unique identification number is defaulted in the Template Index field. You can change this number if you want, but it must be a positive integer.
If you enter a decimal in the Template Index field, the value is automatically rounded up or down to the nearest integer. If the nearest integer is already assigned to another template, a Duplicate Index value error message is displayed.
6. Click OK. The Create Signature Template dialog box closes and the new template is listed in the Signature Templates list on the Edit Signature Templates dialog box. 7. In the Signoffs Required drop-down, select the number of signatures that must be obtained for this signature template. 8. In the Last Signoff drop-down, select the number of the signoff that corresponds to the signature that must be completed last, after other signatures have been entered. If the signatures dont have to be completed in any particular order, select None.
9. Now you are ready to configure the signoffs for the signature template you just added.
198
3. From the Signoff list, select the number that represents the Signoff you want to configure.
This Signoff list corresponds to the Last Signoff list on the General tab. When you complete the following steps, keep in mind which Signoff number was selected as the Last Signoff on the General tab.
4. In the Meaning field, enter a short phrase that describes the significance of this signoff.
The Meaning is displayed as part of the signoff event recorded in the Batch event journal.
5. From the Comment drop-down, select whether signer comments are Optional, Required, or Not Allowed. 6. In the Security Permissions area, assign privileges to the users and groups that are authorized to complete this signoff. (For detailed instructions see Assigning Security Permissions for a Signoff.)
199
When you have finished assigning security permissions for the signoff, the User and Group names are displayed in the Security Permissions area.
7. Click the Apply button to apply your changes. 8. If you are creating a template that requires more than one signoff, repeat steps 3 7 until all the signoffs have been configured for the template. 9. When you are finished configuring all the signoffs for the template you can return to the General tab to add other signature templates, or click the OK button to close the dialog box. Assigning Security Permissions for a Signoff When you are configuring signoffs for a signature template, you must specify which users or groups may complete each signoff. Before you can assign security permissions for a signoff you must have completed the following:
Added a signature template in the Edit Signature Templates dialog box on the General tab. (See Adding a Signature Template for more information.) On the Signoffs tab, selected the Template Name, Signoff number and Comment option, and entered a Meaning. (See Configuring Signature Template Signoffs for more information.)
200
Now you are ready to assign security permissions for the selected Signoff.
1. On the Signoffs tab, in the Security Permissions area, click the Add button. The Select User or Group dialog box opens.
2. In the Select User or Group dialog box, click Show all to view a list of all users and groups. The list displays all FactoryTalk Security users and groups and all Windowslinked users and groups defined in the FactoryTalk Directory Server.
Changing the FactoryTalk Directory Server after adding users and groups to Signature Templates is not supported. Doing so may cause Signature Signoffs to fail.
201
You can select more than one Name in the list by holding down the SHIFT or CTRL keys while you click a Name.
202
Removing Signoff Permissions for a User or Group If you want to remove the authority from an individual or group to complete a particular signoff, select the individual or group in the Security Permissions area of the Signoffs tab on the Edit Signature Templates dialog box, and click the Delete button.
To modify a signature template, complete the following steps: 1. Open the area model file. 2. From the Edit menu, select Signature Templates. The Edit Signature Templates dialog box opens. 3. In the Signature Templates list, select the template you want to modify. 4. Modify the fields on the General tab that you want to change. 5. Click OK to close the Edit Signature Templates dialog box, or Apply to save your changes and keep the dialog box open.
204
Signature Template
1. From the Edit menu, select Command Policies (or click the Configure Command Policies toolbar button). The Edit Command Verification Policies dialog box opens.
Because the ability to secure FactoryTalk eProcedure instruction files does not currently exist in FactoryTalk Security, you can require an electronic signature on Parameter Change to prevent unauthorized users from executing instructions.
205
2. Select the checkbox next to the command that requires an electronic signature. The Select Signature Template dialog box opens.
3. From the Select Template list, select the signature template that defines the signature policy you want to use for this command. 4. Click OK. The Select Signature dialog box closes, and the signature template you chose is displayed in the Signature Template box next to the selected command.
5. Repeat steps 2 - 4 for each additional command that requires an electronic signature. 6. Click OK.
206
1. From the Edit menu, select Command Policies. The Edit Command Verification Policies dialog box opens.
2. Click the Browse button next to the Signature Template for the command you want to change. The Select Signature Template dialog box opens. 3. From the Select Template list, select the signature template that defines the signature policy you want to use for this command. 4. Click OK. The Select Signature dialog box closes, and the signature template you chose is displayed in the Signature Template box next to the selected command. 5. Repeat steps 2 - 4 for each additional verification policy you want to change. 6. Click OK.
207
indicating that the signature template is not in use for this command and no signature verification is required.
If you want to re-enable the signature requirement for a command, just select the Requires Signature checkbox. The Signature Template that was previously used will automatically be activated.
3. Click OK.
208
CHAPTER 7
Simulator OPC PCPhase OPC Rockwell RSLinx Classic Gateway OPC RSOPC Gateway
Rockwell RSLinx Classic OPC Logix5000 CIP RSLinx Enterprise FactoryTalk Live Data Instruction-based Server (eProcedure only)
Note: You cannot create a data server using the Instruction-based Server. This data server is created automatically. Data server definition files should never be edited directly. Please contact Rockwells Customer Support if you have questions regarding DSDF files.
209
OPC Data Access FactoryTalk Live Data (FTD) Common Industrial Protocol (CIP)
The Data Servers dialog box provides a list of data servers that have been defined for the active area model. The first data server in this list is used as the default. The list can be sorted in ascending or descending alphabetical order by clicking the Name header.
Type
Add Edit
210
Item Remove
Definition Opens the Remove Data Server dialog box used to remove an existing data server. The dialog box displays a list of all associated equipment modules, equipment module tags, and unit attribute tags that will be removed. Allows closing the dialog box without applying a data server selection.
Close
211
Item Location
Definition Only used with OPC data servers. The location of the OPC data server. If the data server is located on the local computer, Local must be selected. If the data server is located on a remote network computer, Remote must be selected and the name of the computer where the data server is located must be provided. The name of the remote computer should be entered using the naming scheme of the network transport. By default, Universal Naming Convention (UNC) names and Domain Names System (DNS) names are supported. Only used with RSLinx Enterprise FactoryTalk Live Data (FTD) data servers. A string that defines the path to a data server located in the FactoryTalk Directory. (See Adding an RSLinx Enterprise FactoryTalk Live Data Server for more information.) The type of watchdog protocol to be used by the data server. This can be either the Standard or Enhanced protocol. (See the FactoryTalk Batch PCD Programmers Technical Reference for information on watchdog protocols.) The OPC access path for the watchdog write item. This is disabled if the data server does not require separate read and write items or does not require an access path. The OPC item name for the watchdog write item. This is disabled if the data server does not require separate read and write items. The default On Control and Off Control scan rates for the data server, in milliseconds. The valid range of the On Control scan rate is 250 to 30,000 milliseconds. The valid range of the Off Control scan rate is 250 to 60,000 milliseconds. The usage of these rates is determined by the type of data server selected. Typically, these values do not need to be modified.
Watchdog Protocol
Watchdog Write Item Access Path Watchdog Write Item Name Scan Rates
1. From the Edit menu, select Data Server, or click the Edit Data Servers toolbar button. The Data Servers dialog box opens.
212
2. Click the Add button. The Add Data Server dialog box opens. 3. Type a name for the data server in the Name box. 4. From the Type list, select the data server definition that corresponds to the physical OPC data server you are defining. 5. If necessary, type the appropriate values for the Default Item Access Path, Watchdog Item Access Path, and Watchdog Item Name. 6. Select the appropriate option from the Location area. If Remote is selected, type the remote data server name. 7. Click the More button. 8. From the Watchdog Protocol area, select either the Standard or Enhanced protocol. 9. If necessary, type the appropriate values for the Watchdog Write Item Access Path and the Watchdog Write Item Name. 10. From the Scan Rates area, type the On Control and Off Control scan rates for the data server. 11. Click OK to save the data server configuration and return to the Data Servers dialog box.
Install and configure RSLinx Enterprise. (For more information refer to RSLinx Enterprise Help.) Create an Application in the FactoryTalk Directory. (For more information refer to FactoryTalk Help located in the FactoryTalk Administration Console.)
213
Add an RSLinx Enterprise data server to the FactoryTalk Application. Adding a data server to an Application provides a link between a hardware device containing tags and the FactoryTalk Directory. (For more information refer to FactoryTalk Help located in the FactoryTalk Administration Console.)
Adding an Live Data Server The items necessary to configure an RSLinx Enterprise FactoryTalk Live Data (FTD) server in the FactoryTalk Batch Equipment Editor are identical to OPC servers with the exception of the RSLinx Enterprise Server Path. To add an RSLinx Enterprise FactoryTalk Live Data server to the area model complete the following steps: 1. Open the Equipment Editor Data Servers dialog box and click Add. The Add Data Server dialog box opens. 2. Type a name for the data server in the Name box. 3. From the Type list, select RSLinx Enterprise Live Data. When the data server Type is RSLinx Enterprise Live Data, the RSLinx Enterprise Server Path text box replaces the Location text box in the Add Data Server dialog box.
4. If necessary, type the appropriate values for the Default Item Access Path, Watchdog Item Access Path, and Watchdog Item Name. 5. Type the connection string for the RSLinx Enterprise Server Path. (See Configuring the RSLinx Enterprise Server Path for more information.) 6. Click the More button.
214
7. If necessary, type the appropriate values for the Watchdog Write Item Access Path and the Watchdog Write Item Name. 8. From the Scan Rates area, type the On Control and Off Control scan rates for the data server. 9. Click OK to save the data server configuration and return to the Data Servers dialog box. Configuring the RSLinx Enterprise Server Path Once you add an RSLinx Enterprise data server to an Application in the FactoryTalk Directory, the RSLinx Enterprise Server Path connection string needed to configure the RSLinx Enterprise FactoryTalk Live Data server in the FactoryTalk Batch Equipment Editor displays in the Communication Setup dialog boxs title. In the following example, the RSLinx Enterprise Server Path connection string is: RNA://$Global/MyApplication/.
To open the FactoryTalk Communication Setup dialog box complete the following steps. 1. Open the FactoryTalk Administration Console and log on to the appropriate FactoryTalk Directory. 2. Point to MyApplication > RSLinx Enterprise > Communication Setup. 3. Right-click on Communication Setup and select Open. The Communication Setup dialog box opens. The RSLinx Enterprise Server Path connection string displays as part of the title.
215
If the data server is not assigned to any equipment modules, the following message displays:
If the data server is assigned to equipment modules, the Remove Server dialog box opens, displaying these equipment modules and unit attribute tags associated with the data server.
The displayed equipment modules and all of their tags, as well as the displayed unit attribute tags will be deleted when you remove the data server. 3. Click Yes to delete the data server and remove all associated equipment modules and tags. Click No to cancel the deletion and return to the Data Servers dialog box. 4. Close the Data Servers dialog box.
216
217
218
CHAPTER 8
Resources
Resources are defined in the FactoryTalk Batch Equipment Editor as any human resources, systems, or items that are not classified as a process cell, unit, or equipment module, but are required to manufacture a batch. Often, resources represent control modules such as pumps, motors, and valves. However, resources are not limited to equipment. Resources can include anything required to create a batch, such as people, quality control systems, forklifts, etc. Once resources have been defined, you assign them to process cells, units, and equipment modules as necessary equipment. This information is used by the FactoryTalk Batch Server for arbitration purposes. You must define your resources in the area model prior to assigning these resources as shared equipment. You can accomplish this by creating resource classes (such as PUMPS) and resource instances (such as PMP102). After resource instances are defined in the area model, they can be assigned to process cells, units, equipment modules, and other resources as necessary equipment that will be allocated by the FactoryTalk Batch Server. To configure a resource instance, you assign a name, equipment ID, the maximum number of owners, and any other equipment requirements for that resource. When you define the maximum number of owners, you are defining the number of area model components that can simultaneously use the resource.
Resources can be simultaneously owned by one or more area model components, depending on the program. For example, if a pump is physically configured to charge an ingredient into three different vessels but it has the capacity to charge only two of the three vessels simultaneously, you would define the pump as a shared resource and specify the maximum number of owners as 2.
Arbitration of Resources
Before the recipe procedure can begin execution, all resources needed by the process cells, units, and phases in which the recipe procedure is running must be acquired by the FactoryTalk Batch Server through arbitration. The following example shows how each recipe level behaves when its corresponding area model component requires resources.
219
Resources are defined as required by an area model component in the Edit Process Cell, Edit Unit, or Edit Equipment Module dialog boxes on the Arbitration tab.
Area Model Component Corresponding Requiring Resource Recipe Level Recipe Name Process_ Cell_A Procedure Behavior of Recipes Running in Area Model Component
CLS_FRENCHVANILLA CLS_FRENCHVANILL running in Process_Cell_A cannot begin execution until resources required by Process_Cell_A have been acquired by the Batch Server CLS_SWEETCREAM_UP CLS_SWEETCREAM_U P:1 and :1 CLS_SWEETCREAM_OP CLS_SWEETCREAM_O P:1 running in Unit_A :1 cannot begin execution until resources required by Unit_A have been acquired by the Batch Server. ADD_EGG:1 ADD_EGG:1 running in Equipment_Module_A cannot begin execution until the resources required by Equipment_Module_A have been acquired by the Batch Server.
Unit_A
When a resource is deleted, it is removed from all needed equipment lists in which it previously existed.
220
8 Resources
2. To create a new resource class, click the Add Class button. The Edit Resource Class dialog box opens. 3. Type the new resource class name in the Edit Resource Class dialog box. 4. Click OK to return to the Edit Resources dialog box. The new resource class is displayed in the Resource Classes column of the Edit Resources dialog box. 5. To add a resource instance to a resource class, select the new resource class, and then click the Add button. The Edit Resources: [Resource Name] dialog box opens. The Edit Resources dialog box contains the following four tabs:
Arbitration Hyperlink)
2. Type the resource name in the Name box. (For example, Pump101, PV203, etc.) 3. Type the appropriate Equipment ID, or accept the default ID. 4. Click Apply to save changes and continue, or click OK to return to the Edit Resources dialog box.
221
2. In the Max Owners field, enter the number that represents how many process cells, units, equipment modules, or other resources can maintain ownership of this resource at one time. 3. In the Equipment Allocation by Resource area, browse the area models equipment hierarchy to specify equipment this resource will need to acquire. A plus sign (+) to the left of the equipment type indicates equipment of that type has been defined. Clicking the plus sign expands the list to display the defined equipment. After a list is expanded, the plus sign changes to a minus sign (-) indicating that the list can be collapsed. The lack of a plus or minus sign to the left of an equipment type indicates that no equipment of that type has been defined, OR the equipment type cannot be used as a needed equipment item at this level.
222
8 Resources
To add equipment to the right pane, select the equipment needed by the resource in the left pane and click the Add button. The equipment this resource will need to acquire is now displayed in the right pane. To remove equipment, select the equipment to delete in the right pane and click the Remove button. The selected equipment is removed from the list.
4. Click Apply to save changes and continue, or click OK to return to the Edit Resources dialog box.
2. Type the cross invocation string contents information in the Cross Invocation Label # boxes. (See the FactoryTalk Batch Administrators Guide for instructions on entering this information.) 3. Click Apply to save changes and continue, or click OK to save changes and return to the Edit Resources dialog box.
223
1. Hyperlinks are only used with eProcedure. If hyperlinks are being used, select the Hyperlink tab of the Edit Resources: [Resource Name] dialog box.
2. Type a valid URL string in the Hyperlink Label # English boxes. (See the FactoryTalk eProcedure Administrators Guide for instructions on entering this information.) 3. Click Apply to save changes and continue, or click OK to return to the Edit Resources dialog box. 4. When you have finished creating the shared resources, click OK to return to the Design View area.
224
CHAPTER 9
225
Operator button the corresponding operator is inserted into the expression at the current cursor position and displayed in the Expression Builder text box.
Expression operators
Binding expressions support the following operators. The precedence of the execution is depicted from highest to lowest. An operator with a higher precedence will be executed before an operator of lower precedence.
Expression Operator () NOT, *, /, AND +, -, OR <, <=, >, >= =, < > Description Expressions within parentheses are evaluated before expressions outside of parentheses. Logical NOT, subtraction. Multiplication, division, and logical AND. Addition, subtraction, and logical OR. Less than, less than or equal to, greater than, and greater than or equal to. Equal to, and not equal to.
Data types
The data types supported are integer, real, string and enumeration. The following are data type examples: Integer: 423 Real: 423.123456789012 String: The string constant must be in quotes: READY. Enumeration: As a string, the enumeration constant must be in quotes: BUTTER_PECAN. As an integer, the ordinal for the enumeration may be: 4.
226
Operands
Operands used within a global unit binding expression can reference Recipe Header data, Global Unit Attributes, and constants. The following table illustrates examples of allowable expression entities and the required syntax.
Expression Entity Recipe Header data Global Unit Attribute Constant Expression Syntax [Recipe Header item] Unit Attribute Name Example [VERSION_NUMBER] CAPACITY 100
Expression Validation
When you click OK, the expression is validated for consistency and syntactical correctness. If the defined expression validates successfully, the Expression Builder closes. If the expression is invalid then the location of where the first error was encountered is highlighted, and you will see a description of the error displayed in a message box, and the Expression Builder does not close. The following validation rules must be met:
An Expression must resolve to either TRUE or FALSE and meet the following criteria: An Expression must contain at least one operator (+ (addition), - (subtraction), * (multiplication), / (division), = (equals), > (greater than), < (less than), <= (less than, or equal to), >= (greater than, or equal to), <> (not equal to), Not, And, and Or.
Each entity (Recipe Header field, Global Unit Attribute, or constant) must be separated by an operator. The entities being operated on must evaluate to acceptable data types (String with a String; Integer with Integer or Real; Real with Integer or Real).
Maximum expression length must not exceed 1023 characters. Duplicate expressions are allowed.
Although you are unable to create an invalid expression, a previously valid expression may become invalid through subsequent changes elsewhere in the area model. When the Edit Global Unit Binding Requirements dialog is invoked all binding expressions are re-validated. if any current expressions have become invalid due to subsequent changes an error message opens and the dialog displays an asterisk beside each invalid expression.
227
2. Click the Add Requirement button. The Unit Binding Expression Builder opens. 3. Enter the desired expression or build an expression by selecting options from the three different sections of the Expression Builder.
A binding requirement expression evaluates to either a TRUE or FALSE value, TEMPERATURE < 20.3, for example.
4. Click OK to save the expression and return to the Edit Global Unit Binding Requirements dialog box.
5. Continue building more binding requirements, or click OK to exit the dialog box.
228
2. Click the browse button next to the requirement you want to edit. The Unit Binding Expression Builder opens.
3. Make the desired changes, and then click OK. 4. Click OK to close the Edit Global Unit Binding Requirements dialog box.
2. Click the Delete Requirement button, and then click OK to confirm the deletion or Cancel to keep the requirement. 3. Click OK to close the Edit Global Unit Binding Requirements dialog box.
229
230
CHAPTER 10
3. Type a name for the process cell class. 4. Select an icon from the Icon column. Click OK to return to the Class View area.
If the icon column is empty, see Verifying Icon Paths.
Configuring the General Data The following is a list of fields in the General tab of the Edit Process Cell dialog box:
Item Name Definition The name of the process cell. (The default name is PROCESS_CELL#, where # is a consecutive number starting with 1, assigned to each process cell as it is added to an area.) The icon selected for the process cell class (view-only). The name of the process cell class (view-only). For use with RSBizWare BatchERP only. The ERP alias is the SAP name for that process cell. The ERP alias maps the process cell from Batch to SAP. The equipment identification number that identifies this process cell. (A default ID is automatically assigned to the process cell, based on the next available sequential number. The first item added to an area is assigned ID #1.) The equipment ID must be the same as the equipment ID used by the phase logic to request this process cell.
Equipment ID
232
1. Select the General tab. 2. Type a process cell name in the Name box.
3. For RSBizWare BatchERP only. The ERP alias is the process cell name in SAP. It maps the process cell from FactoryTalk Batch to SAP. Type the SAP R/3 process cell name in the ERP Alias box. 4. Type the equipment ID in the Equipment ID box, or accept the default ID. 5. Click Apply to save changes. Configuring the Arbitration Data The following is a list of fields in the Arbitration tab of the Edit Process Cell dialog box:
Item Name Definition The name of the process cell (view-only). The default name is PROCESS_CELL#, where # is a consecutive number starting with 1, assigned to each process cell as it is added to an area. The icon selected for the process cell class (view-only). The name of the process cell class (view-only). The maximum number of owners (other process cells, units, equipment modules, or other resources) that can simultaneously use this process cell. (The default is 1.)
Equipment Allocation A list of the equipment for which ownership is required by this process by Resource cell in order for any procedural element linked to the process cell to begin execution. (The default is blank.) In general, any required resources should be assigned to the lowest possible level, allowing for maximum efficiency when running multiple processes.
In the Equipment Allocation by Resource area, the left pane is a hierarchical display of the current equipment configuration of the area model. The hierarchy has two roots: Process Cells and Resources. The right pane is the list of equipment this process cell is dependent upon. Any equipment in this list must be acquired by the process cell before any procedural element linked to this process cell can begin execution.
233
Expand Process Cells to view all the process cells defined within the area model. From here, organization is hierarchical; process cells contain units and units contain equipment modules. Expand Resources to view a list of all the configured resources within the area model. 1. Select the Arbitration tab. 2. Type the maximum number of owners in the Max Owners box.
3. Browse the area models equipment hierarchy to specify equipment the process cell must acquire. The lack of a plus or minus sign to the left of an equipment type indicates no equipment of that type has been defined, OR the equipment type cannot be used as a needed equipment item at this level. To add equipment, select the equipment needed by the process cell under the Equipment Allocation by Resource area and click the Add button. The selected equipment displays in the right pane. To remove equipment, select the equipment to delete in the right pane and click the Remove button. The selected equipment is removed from the list. 4. Click Apply to save changes. Configuring Cross Invocation Data The following is a list of fields in the Cross Invocation tab of the Edit Process Cell dialog box:
Item Name Definition The name of the process cell (view-only). The default name is PROCESS_CELL#, where # is a consecutive number starting with 1, assigned to each process cell as it is added to an area. The icon selected for the process cell class (view-only). The name of the process cell class (view-only).
Icon Class
234
Definition The cross invocation strings indicate the addition of an item to the FactoryTalk Batch View and ActiveX controls shortcut menus, including the caption for each menu item and the data to be passed to the specified automation server when the menu item is selected. (See the FactoryTalk Batch Administrators Guide for more information.) The default labels associated with each of the five fields are Cross Invocation Label # (where # is 1 through 5). These labels can be modified in the Server Options dialog box, and can only be seen in the Edit Process Cell dialog box.
1. Select the Cross Invocation tab. Type the cross invocation string information in the Cross Invocation Label # boxes. (See the FactoryTalk Batch Administrators Guide for more information.)
Icon Class
235
Definition The URLs associated with each hyperlink label. (See the FactoryTalk eProcedure Administrators Guide for more information on hyperlinks.) The default labels associated with each of the five fields are Hyperlink Label # English (where # is 1 through 5). These labels can be modified in the Server Options dialog box. The labels are used in the eProcedure Clients Equipment view.
1. If hyperlinks are being used, select the Hyperlink tab. 2. Type a valid URL string in the Hyperlink Configuration boxes. (See the FactoryTalk eProcedure Administrators Guide for more information.)
3. Click Apply to save changes. Click OK to return to the Design View area.
236
2. Verify the directory paths for each type of icon. 3. Click OK to return to the Design area.
Icons must be stored in the appropriate directory as a .bmp file. The icon must be a square or rectangle, with a width made up of an even number of pixels. Icons with an odd numbered pixel width will not display. The file must not exceed 7K in size (116 x 116 pixels). Icons exceeding the size limit will be displayed as a blank icon with a red question mark. Icons are stored in one of the following directories:
Unit Classes
Unit Backgrounds
Phases
237
238
CHAPTER 11
Configuring Units
A unit consists of equipment modules and/or control modules centered around a materialcontaining vessel that performs one or more major processing activities. The material contained in the central vessel is usually transformed either physically, chemically, or biologically. Units run one operation or unit procedure-level recipe at a time. Process & Instrumentation Diagrams (P&IDs) are a good source of information for determining unit boundaries. Often process facilities contain multiple instances of similar equipment, such as unit vessels that consist of the same or similar components and functionality. These groupings of similar equipment can be described as a unit class. In the area model database, you create unit classes (such as MIXER_CLS) and one or many unit instances of a particular unit class (such as MIXER_A and MIXER_B). Recipes can be configured to run within a specific unit instance or within a unit class. The action of specifying the particular unit in which a recipe runs is called unit binding. If a recipe is configured to run within a unit instance, the unit in which the recipe will run is specified at the time the recipe is created. If a recipe is configured to run within a unit class, the recipe can run in any unit instance of that unit class. The specific unit instance is determined in one of the following ways:
By the operator when the batch is created, prior to starting the batch By the operator, after the batch is started, at the time a unit procedure level recipe is ready to run (the operator responds to a prompt) By the FactoryTalk Batch Server, after the batch is started, at the time a unit procedure level recipe is ready to run
They minimize the number of recipes that need to be maintained. They allow the freedom to choose the most appropriate unit for binding the recipe at the time the batch is run.
To navigate to the unit level, double-click a Process Cell icon or select a Process Cell icon and click the Go Down button ( ).
239
2. From the Class menu, select New, or click the Add New Object button. The Create Unit Class dialog box opens with the assigned defaults.
Global unit attributes (Viewonly; these are associated with every Unit Class in the area model)
3. Type the desired unit class name. 4. Select an icon in the Icon column.
If the icon column is empty, see Verifying Icon Paths.
5. If unit attributes have been defined and will be used with this unit class, select the check box for the tag(s) to assign to the unit from the Unit Attributes list. (See Adding a Unit Attribute for more information.)
Global unit attributes are associated automatically with the Unit Class being created. (See Creating a Global Unit Attribute for more information.)
6. Click OK.
240
11 Configuring Units
Configuring General Data The following fields appear on the General tab of the Edit Unit dialog box:
Item Name Class ERP Alias Equipment ID Data Server Definition The unique name assigned to this unit. The units class name (view-only). The icon associated with the unit class displays next to the Name and Class. RSBizWare BatchERP only. The ERP alias is the SAP name for that unit. The ERP alias maps the unit from Batch to SAP. The unique number that identifies this unit. This must be the same equipment ID used in the phase logic to request this unit. Select a data server to be assigned to all equipment modules subsequently created in the unit. Will not change the data server for any equipment modules that already exist in the unit.
1. Select the General tab of the Edit Unit dialog box. 2. Type the unit name in the Name box. This name is displayed to the operator during batch execution.
241
3. For RSBizWare BatchERP only. The ERP alias is the unit name in SAP. It maps the unit from Batch to SAP. Type the SAP R/3 unit name in the ERP Alias box. 4. Type the equipment ID in the Equipment ID box. 5. In the Data Server box, select a data server from the list. The data server you choose will be automatically assigned to all equipment modules that are subsequently created in that unit. If you do not want to affect the equipment modules and tags, select the default option of <None>.
Selecting a data server here will not change the data server for any equipment modules that already exist in the unit.
6. Click Apply to save changes. Configuring Unit Attribute Tags Data The following fields appear on the Attribute Tags tab of the Edit Unit dialog box:
Item Name Class Unit Attribute Tags Definition The unique name assigned to this unit (view-only). The units class name (view-only). The icon associated with the unit class displays next to the Name and Class. Process-connected device data associated with the unit that is used with recipes. Unit attribute tags are organized by unit attributes. Unit attribute tag instances are created at the time the unit is configured.
1. Select the Attribute Tags tab of the Edit Unit dialog box.
2. In the Unit Attribute Tags area, click the Add button and create the required unit attribute tags. (See Creating a Unit Attribute Tag for more information.)
If any global unit attributes have been created for the area model, their associated tags are also listed.
3. To edit an existing tag, select the tag in the Unit Attribute Tags area and click the Edit button. The Edit Unit Attribute Tag dialog box opens.
Unit attribute tags can only be assigned to OPC or RSLinx Enterprise Live Data (FTD) data servers. They cannot be assigned to Logix5000 CIP data servers.
242
11 Configuring Units
4. To remove an existing tag, select the tag in the Unit Attribute Tags area and click the Remove button.
You will not have the option to cancel the removal of the unit attribute tag. However, you can click the Cancel button and any changes you have made to the unit definition will be undone.
5. Click Apply to save changes. Configuring Arbitration Data The following fields appear on the Arbitration tab of the Edit Unit dialog box:
Item Name Class Class Icon Definition The unique name assigned to this unit (view-only). The name of the class of the unit (view-only). The unit class icon (view-only).
Equipment Allocation An equipment list requiring ownership by this unit in order for any by Resource procedural element linked to the unit to begin execution.
In the Equipment Allocation by Resource area, the left pane is a hierarchical display of the current equipment configuration of the area model. The tree has two roots: Process Cells and Resources. The right pane is the list of equipment this unit is dependent on. Any equipment in this list must be acquired by the unit before any procedural element linked to this unit can begin execution. Expand Process Cells to view all the process cells within the area model. From here, organization is hierarchical, so process cells contain units and units contain equipment modules. Expand Resources to view a list of all the configured resources within the area model. 1. Select the Arbitration tab of the Edit Unit dialog box.
2. Browse the area models equipment hierarchy to specify equipment the unit must acquire. The lack of a plus or minus sign to the left of an equipment type indicates that
243
no equipment of that type has been defined, OR that the equipment type cannot be used as a needed equipment item at this level.
To add equipment, select the equipment needed by the unit under the Equipment Allocation by Resource area and click the Add button. The equipment selected is displayed in the right pane. To remove equipment, select the equipment to delete in the right pane and click the Remove button. The equipment selected is removed from the list.
Configuring Cross Invocation Data The following fields appear on the Cross Invocation tab of the Edit Unit dialog box:
Item Name Class Class Icon Cross Invocation Configuration Definition The unique name assigned to this unit (view-only). The name of the class of the unit (view-only). The unit class icon (view-only). The cross invocation strings indicate the addition of an item to the Batch View and ActiveX controls shortcut menus, including the caption for each menu item and the data to be passed to the specified automation server when the menu item is selected. (See the FactoryTalk Batch Administrators Guide for more information.) The default labels associated with each of the five fields are Cross Invocation Label # (where # is 1 through 5). These labels can be modified in the Server Options dialog box, and are seen in the Edit Equipment Module dialog box.
1. Select the Cross Invocation tab of the Edit Unit dialog box.
244
11 Configuring Units
2. Type the cross invocation string information in the Cross Invocation Label boxes. (See the FactoryTalk Batch Administrators Guide for more information.) 3. Click Apply to save changes. Configuring Hyperlink Data This feature is used in conjunction with FactoryTalk eProcedure only. The following fields appear on the Hyperlink tab of the Edit Unit dialog box:
Item Name Class Class Icon Hyperlink Configuration Definition The unique name assigned to this unit (view-only). The name of the unit class (view-only). The unit class icon (view-only). The URLs associated with each hyperlink label. (See the FactoryTalk eProcedure Administrators Guide for more information.) The default labels associated with each of the five fields are Hyperlink Label # English (where # is 1 through 5). These labels can be modified in the Server Options dialog box. The labels are used in the eProcedure Clients Equipment view.
1. If hyperlinks are being used, select the Hyperlink tab of the Edit Unit dialog box.
2. Type a valid URL string in the Hyperlink Configuration boxes. (See the FactoryTalk eProcedure Administrators Guide for instructions on entering this information.) 3. Click Apply to save changes. Click OK to return to the Design View area.
Sharing Units
When a single unit instance is required by more than one process cell, it must be shared by all process cells that require it. You create the unit instance in one process cell. This unit instance is then shared by the other process cell(s). Do not create a new instance of the same unit in the other process cells. Prior to sharing a unit instance, ensure that the unit is physically able to be shared. A unit may have only one owner at a time. Sharing a single unit allows any of the process cells with which it is shared to gain ownership of it during batch execution, but the unit cannot be owned by more than one process cell at the same time. When a unit instance is shared, any changes made to it are reflected in each process cell that contains the shared unit instance, including its physical placement in the Design View area. When an instance of a shared unit is deleted from one process cell, the unit instance is removed from the selected process cell but it is still present in any other process cells to which it belongs. 1. Create the unit that is to be shared. 2. Move to the process cell that does not contain this unit. 3. Click the Share button. The Share Unit Between Process Cells dialog box opens with a list of existing process cells.
246
11 Configuring Units
A plus sign (+) to the left of the process cell indicates that units have been defined within that process cell. The lack of a plus sign or minus sign to the left of a process cell, indicates that no units have been defined within that process cell. Display the units in each process cell by clicking the plus sign (+) for the appropriate process cell folder. 4. Select the unit to be shared, and click OK. The Share Unit Between Process Cells dialog box closes. The selected units icon, with a small hand at the bottom left corner, is displayed in both process cells.
Deleting an instance of a shared unit only deletes the link to that unit. The unit is not deleted until the last instance of the unit is deleted.
247
248
CHAPTER 12
Configuring Tags
FactoryTalk Batch uses tags to communicate with the process-connected device. For OPC and RSLinx Enterprise FactoryTalk Live Data (FTD) equipment modules, you define tags in the area model equipment database. Area model tags point to a specific memory address or tag in the process-connected device. The FactoryTalk Batch Server and the processconnected device exchange information and communicate through these tags.
For PhaseManager equipment modules that are assigned to a Logix5000 CIP data server, you do not have to define tags. The tags are created automatically when you synchronize the area model with the RSLogix 5000 project. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
Unit attribute tags are items in the area model database that represent a single piece of process-connected device information. Unit attribute tags are linked to a process tag such as a level, temperature, or flow process variable. Unit attribute tags allow actual process values to be used in recipe transition conditions. An equipment module uses equipment module tags to communicate with the engineered logic in the process-connected device. Every equipment module has a minimum of ten standard tags with which it is associated. When you define the phase from which an OPC or RSLinx Enterprise FactoryTalk Live Data equipment module is created, you must also indicate the number of tags required for parameter and report communications, as well as additional tags for requests from the process-connected device to the FactoryTalk Batch Server.
Once a unit attribute tag instance is defined, it is part of the area model database and can be used in recipe transition conditions for any recipe. In other words, the unit attribute tag
249
instance can be used in a recipe that will be bound to any unit in the area model (not just the unit for which the unit attribute tag was defined).
Prior to creating the unit attribute tags, compile a list of data servers and tag addresses to which FactoryTalk Batch will connect. You can only create unit attribute tags that have an OPC or RSLinx Enterprise FactoryTalk Live Data (FTD) data server as their data source. You cannot create unit attribute tags that represent tag information from a Logix5000 CIP data server.
3. Type a name for the new attribute in the Name box. 4. Select the appropriate tag type from the Type list. 5. If the tag type is Enumeration, select the appropriate enumeration name from the Enumeration list. 6. Type the Engineering Units used for the tag.
250
12 Configuring Tags
7. Type a Description of the attribute (optional). 8. Click OK to return to the Edit Unit Attributes dialog box. 9. Continue adding unit attributes, or click OK to exit. All changes are saved.
251
Item
Definition If data source is Dynamic, the value comes from the PCD, and the following server information must be defined:
Data Server
Displays the data server from which the tag is acquiring data. This list includes all configured data servers for the active area. Only OPC and RSLinx Enterprise FactoryTalk Live Data data servers appear in the selection list. Logix5000 CIP data servers are not displayed. Displays the server type that corresponds with the selected data server as defined in the data server definition (DSDF) files (view-only). The access path used with the read item when attempting to subscribe to the tags value or when performing read operations. This field changes to Read Item Access Path when the associated data server requires separate read and write items. This is disabled if the data server does not require an access path. The name of the item used when subscribing to the tags value or when performing read operations. This field changes to Read Item Name when the associated data server requires separate read and write items. The OPC access path for the write item. This is disabled if the data server does not require separate read and write items. The item name in the write items process-connected device. This is disabled if the data server does not require separate read and write items or does not require an access path.
Item Name
1. Right-click the appropriate unit in the Design View area. The Edit Unit dialog box opens. 2. Select the Attribute Tags tab.
252
12 Configuring Tags
3. Click the Add button in the Unit Attribute Tags area. If a unit attribute exists, the Create Unit Attribute Tag dialog box opens. Otherwise, you are prompted to create a unit attribute; if so, click Yes, and go to Adding a Unit Attribute.
4. Type the unit attribute tag name in the Name box. 5. Select the appropriate unit attribute from the Attribute list. 6. Select the appropriate tag type from the Type list. If the tag type is Enumeration, select the appropriate enumeration name from the Enumeration list. 7. Type the engineering units used for the tag. 8. If Static is selected, type the unit attribute tags value in the Value box.
The value of a dynamic unit attribute tag is held in the PCD. The value of a static unit attribute tag is held in the FactoryTalk Batch Server.
9. If Dynamic is selected, enter the following information: a. Select the appropriate data server from the Data Server list. The corresponding data server type automatically appears in the Server Type box.
Only OPC and RSLinx Enterprise FactoryTalk Live Data (FTD) data servers appear in the selection list. Logix5000 CIP data servers are not displayed.
b. Type the appropriate access path in the Access Path box. c. Type the appropriate item name in the Item Name box.
253
d. If the data server requires separate read and write items, type the write access path in the Write Access Path dialog box. e. If the data server requires separate read and write items, type the write item name in the Write Item Name dialog box. 6. Click OK to return to the Edit Unit Attribute dialog box.
254
12 Configuring Tags
1. From the Edit menu, select Tags, or click the Edit Tags button.
2. Select the appropriate tag class in the Tag Classes area. 3. Select the tag to be edited in the Tags area, and click the Edit Tag button. The Edit [TagType] Tag dialog box opens, where [TagType] represents the type of tag being edited (equipment module or unit).
Instruction-based tags are view-only.
4. Make the required modifications to the tag. 5. Click OK to return to the Edit Tags dialog box.
If the equipment module name is subsequently changed, the tag item names do not automatically change to reflect the new equipment module name. For example, if you change the equipment module name from AGITATE1 to AGITATE_U2, the tag Names will reflect the new name (AGITATE_U2), but the tag Item Names will still reflect the equipment modules original name (AGITATE1). The example request tag for the AGITATE_U2 equipment module would still be AGITATE1.RQ. When an equipment module is created from a phase in the area model, the tag access path is the Default Item Access Path specified for the data server that is assigned to the equipment module. You can change the Access Path for an individual tag on the Edit Equipment Module Tag dialog box.
255
If you want to globally change all the tag Item Names in the area model to reflect the names of their respective equipment modules, and reset the Access Path of each equipment module tag to the Default Item Access Path specified for its data server, complete the following steps.
If you want to change the tag names for only a single equipment module, you can change them on the Tags tab of the equipment module. (See Setting Tag Items to the Default Addresses in the Configuring Equipment Modules chapter for more information.)
1. From the Edit menu, select Set Default Tag Items. A message displays requiring you to verify that you want to set all the tags to their default names and access paths to the default item access path.
This is an irreversible action! Once the Defaults button is clicked, all tag item names and access paths are automatically changed.
2. Click OK to continue. A message displays informing you that all tag items have been set to the tag name and access paths have been reset. 3. Click OK to return to the Design View area.
The default character (tag separator) that separates the phase tag item name from its extension may vary depending on the Tag Separator defined in the batcheqp.ini file. The available characters are the underscore ( _ ), slash ( / ), or dot ( . ). The default character is not overridden if it is changed.
256
12 Configuring Tags
be automatically applied to all unit classes defined within the area model. This saves the area model author the effort of having to manually assign a custom unit attribute to every unit class. 1. From the Edit menu, select Unit Attributes or click the Edit Unit Attributes button. The Edit Unit Attributes dialog box opens.
If you select an attribute in the Attributes list box will repopulate the Attribute Tags list box with the attribute tags associated with the currently selected Attribute. The first attribute tag in the Attribute Tags list box is selected by default. 2. In the Attributes area, click the Add button. The Create Unit Attribute dialog box opens.
3. Type a name for the new unit attribute in the Name box. 4. Select the appropriate tag type from the Type list. 5. If the tag type is Enumeration, select the appropriate enumeration name from the Enumeration list. 6. Type the engineering units used for the tag. 7. Type a description of the tag class.
257
8. If you want this to be a global unit attribute, one that is applied to all new units, check the Global Attribute box.
If the Global Attribute checkbox is selected, all Unit Classes within the area model, both existing and newly created, are associated with that unit attribute. In addition, all Unit instances within the area model, both existing and subsequently created, will contain a unit attribute tag instance.
9. Click OK to return to the Edit Unit Attributes dialog box. The new attribute is listed in the Attributes area. If it is a global unit attribute, it will be associated with all existing unit classes. Attributes and attribute tags are upper-case and in alphabetic order.
258
12 Configuring Tags
259
260
CHAPTER 13
Configuring Phases
A phase is a reusable, process-oriented function. A phase describes a minor processing activity but does not describe the details of how that activity is accomplished. Examples of phases include Heat, Agitate, Add, and Transfer. An instance of a phase is referred to as an equipment module. Every equipment module inherits attributes of the phase from which it is created. Phases and equipment modules link the engineered logic in the process-connected device to the FactoryTalk Batch recipe. A phase describes the FactoryTalk Batch recipe phase, while the equipment module maps to the equipment operation or equipment phase in the engineered logic. Every OPC or RSLinx Enterprise FactoryTalk Live Data equipment module is automatically assigned ten standard tags through which it communicates with the engineered logic in the process-connected device. When you define the phase from which an OPC or RSLinx Enterprise FactoryTalk Live Data equipment module is created, you must also indicate the number of tags required for parameter and report communications as well as additional tags for requests from the process-connected device to the FactoryTalk Batch Server.
For PhaseManager equipment modules assigned to a Logix5000 CIP data server, you do not need to define the number of parameter, report, and request tags. The required tags are automatically configured when you synchronize the area model with the RSLogix 5000 project. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
Creating a Phase
You create and configure phases using the Create Phase dialog box, which contains the following four tabs: General, Parameters, Reports, and Messages. A fifth tab, Control Strategy, displays if Control Strategy is enabled on the General tab. 1. Select a unit icon and click the Go Down button. The Design View area may display the Unit icon, and Phases is displayed as the column header in the Class View area. 2. From the Class menu, select New, or click the Add New Object button. The Create Phase dialog box opens with default values.
The following configuration is also possible through the Edit Phase dialog box. After the phase is created it can be edited in a similar manner.
261
addition, you enable or disable the use of control strategies and material-based recipes for the phase. Tags One of the ten standard tags associated with every OPC or RSLinx Enterprise FactoryTalk Live Data equipment module is a Request tag. The process-connected device uses the Request tag to request service from the FactoryTalk Batch Server. Sometimes, for OPC and RSLinx Enterprise FactoryTalk Live Data equipment modules, the process-connected device needs to communicate more information to the Server than can be accommodated by the single standard Request tag. For this purpose, you may also specify, on the phase, the number of additional request tags needed for the equipment module. (See the PCD Programmers Technical Reference Guide for more information.)
For PhaseManager equipment modules assigned to a Logix5000 CIP data server, you do not configure request tags. The tags are automatically created for Logix5000 CIP equipment modules when you synchronize the area model with the RSLogix 5000 project. The Equipment Editor creates the same number of parameter tags as parameters that exist on the phase, and the same number of report tags as reports that exist on the phase. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
It is possible to configure a different number of parameters and reports for the phase than parameter and report tags for the OPC or RSLinx Enterprise FactoryTalk Live Data equipment module. If you want the number of parameters and reports on the phase to always equal the number of parameter tags and report tags on the associated equipment modules, you can enable Parameter/Tag Locking on the phase. If you do not have Parameter/Tag Locking enabled, you must specify, on the phase, the number of tags for the parameters and reports that will exist on the associated OPC or RSLinx Enterprise FactoryTalk Live Data equipment modules. This number may be different from the number of defined phase parameters and reports for OPC and RSLinx Enterprise FactoryTalk Live Data equipment modules.
For Logix5000 CIP equipment modules, Parameter/Tag Locking is always enabled, regardless of the setting you select. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
Control Strategies Control strategies are user-defined groupings of phase parameters and reports that can be associated with a single phase. Multiple control strategies can be created for a phase, each with its own associated parameters and reports. Organizing parameters and reports into separate control strategies allows phases to assume multiple roles across different units or recipes without generating unnecessary equipment module tags. Message Partners Message partners are two or more phases that need to communicate with each other during the execution of their respective phase logic for synchronization and timing purposes. On the General tab of the Create Phase dialog box, define the number of message partners the phase requires. In the Recipe Editor, message partners are organized into Link Groups that inform the FactoryTalk Batch Server which phases require messaging.
262
13 Configuring Phases
Create Phase - General Tab The General tab contains the following components:
Item Icon area Name Type Control Strategy Definition Displays all of the icons available for selection. Scroll through the icons using the up and down arrows in the vertical scroll bar. The name of the phase. An optional field that can be used to categorize phases for reporting purposes. Enables the use of separate control strategies for the phase.
Material Based Recipes (This is used with Material Manager.) Enables the binding of material references to actual equipment. This makes the phase a material-enabled phase. Parameter/Tag Locking If enabled, you cannot edit the number of equipment module parameter and report tags associated with the phase. Instead, the numbers and type of equipment module tags are maintained by the system on a one-to-one basis with the defined parameters and reports in the phase. Number of Parameter The number of memory registers within the equipment module to which Tags FactoryTalk Batch can write parameter information. This is generally equivalent to the number of parameters defined for the phase. Number of Report Tags The number of memory registers within the equipment module from which FactoryTalk Batch can read report tag information. This is generally equivalent to the number of reports defined for the phase. Number of Request Tags Number of Message Partners The number of memory registers within the equipment module to which the phase logic can write request information. If the phase is to be used in a phase link group for communication or synchronization purposes, this is the number of additional phases with which the phase must be linked in order to operate properly. (See Implementing Phase Link Groups in the FactoryTalk Batch Recipe Editor Users Guide for information.)
You must first define the message partners in the Equipment Editor before you can define corresponding phase link groups in the Recipe Editor. (See the FactoryTalk Batch Recipe Editor Users Guide for more information.)
263
1. With the Create Phase dialog box open, select the General tab.
3. Select an appropriate icon in the Icon area. (If the icon area is empty, see Verifying Icon Paths.) 4. In the Additional Functionality area, select the Control Strategy check box if you want to define control strategies for the phase. 5. In the Additional Functionality area, select the Material Based Recipes check box if you want this phase to be material-enabled. 6. Disable the Parameter/Tag Locking feature if you want to edit the number of parameter and report tags associated with the equipment modules created from this phase. The default is enabled (checked).
This option only applies to OPC and RSLinx Enterprise FactoryTalk Live Data equipment modules that are created from this phase. For Logix5000 CIP equipment modules, Parameter/Tag Locking is always enabled, regardless of the setting you select. (See the FactoryTalk Batch PhaseManager Users Guide for more information.)
7. In the Number of Tags area, if Parameter/Tag Locking is enabled, the Parameter and Report boxes are disabled and display the number currently enforced by the Parameter/Tag Locking feature.
If Parameter/Tag Locking is disabled, you can edit the number of tags in the Parameter and Report fields. Type the appropriate number of tags for Request.
264
13 Configuring Phases
8. In the Message Partners area, type the appropriate number in the Number box.
If the phase is to be used in a phase link group for communication or synchronization purposes, you must first configure the correct number of Message Partners in the area model. (See Implementing Phase Link Groups in the FactoryTalk Batch Recipe Editor Users Guide for information.)
9. Click Apply to save changes, or click OK to save changes and return to the Class View area. The selected icon is displayed in the Class View area.
You can use the keyboard to move around in the grid. Pressing the TAB key moves focus to the grid. Pressing CTRL-ALT-HOME highlights the first editable cell in the grid. Do not use SHIFT+LEFT ARROW to navigate the grid.
265
Add Optional Material Enables the optional material-based recipe parameters (CONTAINER, Parameters MATERIAL_CLASS, LOT, and LABEL). This check box is only visible if Material Based Recipes has been enabled from the General tab. If control strategies are enabled, this check box is only enabled if <All> is selected in the Control Strategy list. Name The name of the phase parameter. You cannot edit the name of the material parameters MATERIAL, AMOUNT, CONTAINER, LOT, or LABEL. The identification number of the phase parameter. If Control Strategy is enabled after parameters have been defined, the IDs are increased by one, as the Control Strategy itself always has the parameter ID of 1. For material-enabled phases, parameter ID fills in the first available integer greater than zero. The MATERIAL parameter is the first of the Material Based Recipe parameters to be assigned an ID (view-only). Type The phase parameter data type: Real, Integer, String, and Enumeration. Note: You cannot modify the data type for material-enabled phase parameters: MATERIAL, MATERIAL_CLASS and CONTAINER = ENUM AMOUNT = REAL LOT and LABEL = STRING Max Min The maximum limit for the phase parameter. Defaults to 100. The minimum limit for the phase parameter. Defaults to zero (0). Addition Both Low = 0, High = positive number Low = negative number, High = positive number Distribution Low = negative number, High = 0 For the material-enabled phase parameter AMOUNT, the Min and Max values specify whether the phase is a material addition, distribution, or both. Default The default value for the phase parameter. Defaults to zero (0). The value must be set between the Min and Max values. If you select a Verification Method of High/Low, High-High/Low-Low, or High-HighHigh/Low-Low-Low, the default value must be within the High and Low values. Note: For material-enabled phases: MATERIAL defaults to NULL_MATERIAL, MATERIAL_CLASS defaults to NULL_CLASS, and CONTAINER defaults to NULL_CONTAINER. You cannot modify the default value for the CONTAINER, LOT, or LABEL parameters.
ID
266
13 Configuring Phases
Item Enum/E.U.
Definition The engineering units for the phase parameter. If the parameter Type is Enumeration, the name of the enumeration set.
You cannot modify the Enum/E.U. for the MATERIAL, CONTAINER, LOT, LABEL, or MATERIAL_CLASS material-enabled phase parameters. Scale DL on Start A check box to indicate if the phase parameter is scalable with a recipe at batch creation time. If selected, the parameter can be downloaded by the FactoryTalk Batch Server in the following situations:
When the proper request is issued in the phase logic. (See the FactoryTalk Batch PCD Programmer's Technical Reference for information on the 1501 and 11501 requests.) Automatically when the recipe phase begins execution and the corresponding Automatic Download option is also selected on the equipment module created from this phase. (See Configuring Equipment Modules for more information.)
DL on TOC
If selected, the parameter can be downloaded by the FactoryTalk Batch Server when a transfer of control takes place on the phase if the proper request is issued in the phase logic. (See the FactoryTalk Batch PCD Programmers Technical Reference for information on the 1502 and 11502 requests.) Material-enabled phases do not support transfer of control. The part of the verification policy that defines the set of acceptable limits for a parameter or report. The phase parameter type must be Real or Integer. No Limits: Allows you to configure a verification policy to enact when the parameter or report value is within the Minimum and Maximum limits. Also select this option if you do not want to use Verification Policies. High/Low: Allows you to configure up to two verification policies. In addition to the No Limits policy, you can specify a High and Low limit and a separate verification policy to use when the parameter or report value exceeds the High limit or falls short of the Low limit. High-High/Low-Low: Allows you to configure up to three verification policies. In addition to the No Limits policy and the High/Low policy, you can also specify a second higher limit, a second lower limit, and a separate verification policy to use when the parameter or report value exceeds this second High limit or falls short of this second Low limit. High-High-High/Low-Low-Low: Allows you to configure up to four verification policies. In addition to the No Limits policy, the High/Low policy, and the High-High/Low-Low policy, you can also specify a third higher limit, a third lower limit, and a separate verification policy to use when the parameter or report value exceeds this third High limit or falls short of this third Low limit.
Verification Method
267
Definition Reporting contexts allow you to define an association between a parameter and a set of context IDs. The defined context IDs are recorded by the Batch Server in the Context ID field of the batch event journal records, whenever a parameter event is logged. The default value for a new parameter is a null string. Click the browse button (...) to open the Reporting Contexts dialog box, where you can select one or more context strings to be used for the particular parameter. Context IDs are members of the REPORTING_CONTEXTS enumeration set.
Add Parameter button Adds a new parameter to the list. Delete Parameter button Removes the selected parameter from the list.
1. With the Create Phase dialog box open, select the Parameters tab.
If Material Based Recipes is enabled from the General tab, the parameters MATERIAL and AMOUNT are automatically created. Enabling Add Optional Material Parameters adds the CONTAINER, LOT, MATERIAL_CLASS and LABEL parameters.
If control strategies are enabled for the phase, the Control Strategy list displays at the top of the Parameters tab. Only phase parameters associated with the control strategy selected in the Control Strategy list display. If <All> is selected, then you are unable to edit the High, Low, Default, or Enum/E.U. fields for the phase parameters. The material parameters, including the optional material parameters (if enabled), are added to each control strategy created. You must edit the values for the MATERIAL, MATERIAL_CLASS and AMOUNT material parameters for each configured control strategy.
2. Click the Add Parameter button to add a new phase parameter. A new parameter is displayed with default values. 3. Type a unique name for the parameter in the Name box. 4. Select the appropriate parameter type from the Type list. 5. If the Type is Real or Integer, add the High value, Low value, and Default value, then type the engineering units in the Enum/E.U. box. If the Type is Enumeration, choose the appropriate enumeration set from the Enum/ E.U. list and select the appropriate default enumeration from the Default list.
268
13 Configuring Phases
If the Type is String, type the engineering units in the Enum/E.U. box and the default string in the Default box. 6. If the parameter must be scaled within a recipe when a batch is scaled, select the Scale check box. (See Scaling Parameters for more information.)
The DL on Start and DL on TOC check boxes are unavailable if there are not enough parameter tags specified in Number of Parameter Tags on the General tab. You must specify as many parameter tags as actual parameters to have these check boxes available for each parameter.
7. Select DL on Start check box if you want to add the parameter to the download on start subset. 8. Select DL on TOC check box if you want to add the parameter to the download on transfer of control subset.
Material-enabled phases do not support transfer of control.
9. If you want to assign a context or descriptor to the recipe phase parameter, select one or more Context IDs from the Reporting Contexts column. (See Selecting Context IDs for more information.) 10. If you want to require electronic signatures or generate deviation events in the FactoryTalk Batch event journal when deviations from the accepted range of parameter values occur, see Configuring the Verification Policy for Parameters and Reports for instructions. 11. To delete a parameter, select the parameter row header and click Delete Parameter. Click Yes to confirm the deletion. 12. Click Apply to save changes, or click OK to save changes and return to the Class View area.
269
If Material Based Recipes is enabled on the General tab, two phase reports (ACTUAL_AMOUNT and FEED_COMPLETE) are created automatically. The Reports tab contains the following fields:
Item Control Strategy Definition A list of configured control strategies used to filter the displayed phase reports. Separate control strategies can be selected from the list or all control strategies can be viewed at the same time. This list is only available if Control Strategy has been enabled on the General tab. The name of the phase reports. Note: You cannot edit the name of the material phase reports ACTUAL_AMOUNT and FEED_COMPLETE. ID The identification number of the phase reports. For material-enabled phases, parameter ID fills in the first available integer greater than zero. The ACTUAL_AMOUNT report is the first of the Material Based Recipe reports to be assigned an ID (view-only). Type The report data type: Real, Integer, String, and Enumeration. Note: You cannot modify the data type for material-enabled phase reports ACTUAL_AMOUNT = REAL and FEED_COMPLETE = ENUM Enum/E.U. The name of the enumeration set if the Type is Enumeration. Otherwise, the engineering units for the report parameter. Note: You cannot modify the Enum/E.U. for the FEED_COMPLETE material-enabled phase report. Accumulate Enables you to define a phases report parameter to add the value of uploaded values to its current value instead of just storing it. Changing the Accumulate setting also changes the Upload on Terminal State setting:
Accumulate Value UL on Terminal State
Name
If selected, the report can be uploaded by the Batch Server in the following situations:
When the proper request is issued in the phase logic. (See the FactoryTalk Batch PCD Programmer's Technical Reference for information on the 2501 and 12501 requests.) Automatically when the recipe phase transitions to a terminal state of COMPLETE, STOPPED, or ABORTED, and the corresponding Automatic Upload option is also selected on the equipment module created from this phase. (See Creating an Equipment Module for more information.)
270
13 Configuring Phases
Item UL on TOC
Definition If selected, the report can be uploaded when a transfer of control takes place on the phase, if the proper phase logic request is issued. (See the FactoryTalk Batch PCD Programmers Technical Reference for information on the 2502 and 12502 requests.) Material-enabled phases do not support transfer of control. The part of the verification policy that defines the set of acceptable limits for a parameter or report. The phase parameter or report type must be Real or Integer. No Limits: Allows you to configure a verification policy to enact when the parameter or report value is within the verification limits. Also select this option if you do not want to use Verification Policies. High/Low: Allows you to configure up to two verification policies. In addition to the No Limits policy, you can specify a High and Low limit and a separate verification policy to use when the parameter or report value exceeds the High limit or falls short of the Low limit. High-High/Low-Low: Allows you to configure up to three verification policies. In addition to the No Limits policy and the High/Low policy, you can also specify a second higher limit, a second lower limit, and a separate verification policy to use when the parameter or report value exceeds this second High limit or falls short of this second Low limit. High-High-High/Low-Low-Low: Allows you to configure up to four verification policies. In addition to the No Limits policy, the High/Low policy, and the High-High/Low-Low policy, you can also specify a third higher limit, a third lower limit, and a separate verification policy to use when the parameter or report value exceeds this third High limit or falls short of this third Low limit.
Verification Method
Reporting Contexts
Reporting context IDs allows you to define an association between a phase report and a set of context IDs. The defined context IDs are recorded by the Batch Server in the Context ID field of the batch event journal records, whenever a report event is logged. Click the browse button (...) to open the Reporting Contexts dialog box, where you can select one or more context strings to be used for the particular report. This feature is used in conjunction with RSBizWare BatchERP only. The ERP alias is the SAP name for that report. The ERP alias maps the report from Batch to SAP. Adds a new report to the phase. Removes the selected report from the phase.
ERP Alias
If control strategies have been configured for the phase, the Control Strategy list is displayed at the top of the Reports tab. Only reports associated with the control strategy selected from the Control Strategy list are displayed. If <All> is selected and Type is Real, String, or Integer, then you cannot edit the Enum/E.U. field. This must be set for each control strategy. The material-enabled phase reports are added to each control strategy created. You must edit the Enum/E.U. value for each configured control strategy.
271
1. With the Create Phase dialog box open, select the Reports tab. If Material Based Recipes is enabled on the General tab, two reports, ACTUAL_AMOUNT and FEED_COMPLETE, are automatically created.
You can use the keyboard to move around in the grid. Pressing the TAB key moves focus to the grid. Pressing CONTROL-ALT-HOME highlights the first editable cell in the grid.
2. Click the Add Report button to add a new phase report. A new report is displayed with default values. 3. Type a unique name for the report parameter in the Name box. 4. Select the appropriate parameter type from the Type list. If the Type is Real, String, or Integer, type the engineering units in the Enum/E.U. box. If control strategies are enabled, you must edit the Enum/E.U. value for each configured control strategy. If the Type is Enumeration, select the appropriate enumeration set from the Enum/ E.U. list.
The UL on Terminal State and UL on TOC check boxes are unavailable if there are not enough report tags specified in Number of Report Tags on the General tab. You must specify as many report tags as actual reports to have these check boxes enabled for each report.
5. Select how you want the Batch Server to handle uploaded report values: None, Phase, or Batch. 6. Select the UL on Terminal State check box if you want to add the report to the upload on terminal state subset. 7. Select the UL on TOC check box if you want to add the report to the upload on transfer of control subset.
Material-enabled phases do not support transfer of control.
8. If you want to assign a context or descriptor to the report parameter, select one or more Context IDs from the Reporting Contexts column. (See Selecting Context IDs for more information.)
272
13 Configuring Phases
9. If you want to require electronic signatures or generate deviation events in the FactoryTalk Batch event journal when deviations from the accepted range of parameter values occur, see Configuring the Verification Policy for Parameters and Reports for instructions. 10. This feature is used in conjunction with RSBizWare BatchERP only. Type the SAP R/3 report name in the ERP Alias field. 11. To delete a report, select the report row header and click Delete Report. Click Yes to confirm the deletion. 12. Click Apply to save changes, or click OK to save changes and return to the Class View area.
1. Click the browse button in the Reporting_Contexts column. The Reporting Contexts dialog box opens.
2. Select one or more context IDs by single-clicking on each, and then click OK. The selected Reporting Contexts are added to the report.
273
1. With the Create Phase dialog box open, select the Messages tab.
2. Click the Add Message button to add a new phase message. A new default message is displayed. 3. Type the appropriate message in the Name box and a message ID in the ID box. 4. To delete a message, select the message row header, and then click Delete Message. Click Yes to confirm the deletion. 5. Click Apply to save changes, or click OK to save changes and return to the Class View area.
274
13 Configuring Phases
Reports
Delete Control Strategy Removes the selected control strategy from the phase.
275
When the control strategy function is enabled, a default control strategy is created. You can edit the default control strategy, create new control strategies, and delete control strategies. If you want to remove all of the control strategies, you must disable the Control Strategy option on the General tab of the Create Phase dialog box. 1. With the Create Phase dialog box open, select the Control Strategy tab.
2. Click the Add Control Strategy button to add a new control strategy. The Create Enumeration dialog box opens. 3. Type a name for the new control strategy in the Enumeration box. Type the ordinal identification value for the control strategy in the Ordinal box, or accept the default value and click OK. The new control strategy is added. 4. For each parameter in the Parameters table, select or deselect the parameters check box within the column for the new control strategy.
If a reports target parameter is removed from the same control strategy as the report, the verification method for the report will be automatically reset to No Limits.
5. For each report in the Reports table, select or clear the corresponding check box in the column for the new control strategy. 6. Select the appropriate control strategy from the Set Default Control Strategy list to configure that control strategy as the default for the phase. 7. To edit or delete a control strategy, select the control strategy column and click Edit Control Strategy or Delete Control Strategy.
276
13 Configuring Phases
8. Click Apply to save changes, or click OK to save changes and return to the Class View area.
If you attempt to disable a phases control strategies, a warning message displays the parameter information that will be lost if control strategies are disabled. Confirmation is required to complete the process.
No Limits: The selected policy is enacted when the parameter or report value is within the deviation limits. High/Low: The options selected in this area describe the actions to be taken when the parameter or report value is outside the calculated high-low deviation limits. High-High/Low-Low: The options selected in this area describe the actions to be taken when the parameter or report value is outside the calculated high-high/low-low deviation limits. High-High-High/Low-Low-Low: The options selected in this area describe the actions to be taken when the parameter or report value is outside the defined highhigh-high/low-low-low limits.
None: A deviation event is written to the FactoryTalk Batch event journal when the parameter or report value is outside the calculated deviation limits, but no signature is required. Signature Template: Requires you to select a pre-configured signature template that describes the number of signoffs required and the user/groups permitted to enter an electronic signature.
If you want to use the Signature Template policy, you must first configure signature templates. (See Creating a Signature Template for more information.)
277
Not Allowed: Stops the batch from continuing its processing if the parameter or report value is outside the calculated range.
The verification method you select, along with the options you select within an area, affect the options available in the subsequently higher verification level areas. For example, if you select the No Limits verification method, you cannot configure any options for the High/Low, High-High/Low-Low, or High-High-High/Low-Low-Low verification methods. You cannot define verification options in a higher verification level that are less stringent than those defined in a lower verification level. For example, if you selected the HighHigh/Low-Low verification method, and then selected the Signature Template option for the policy when value is within limits, the None option is disabled for the policy when value exceeds high/low. The sets of high and low limits must conform to the following relationship: Maximum >= HHH > HH > H = Default = L > LL > LLL >= Minimum
For recipe parameters, the highest and lowest limits must be within the Minimum and Maximum values specified for the parameter on the Parameters tab of the Edit Phase dialog box. This does not apply to reports. The Default parameter value specified on the Parameters tab must be within the range of the Low and High limits.
278
13 Configuring Phases
279
Item
Definition
Calculation (continued) Percentage: The Target Parameter value is multiplied by the percentage specified in the Low and High fields. Only available for reports. For example: At runtime, the Batch Server calculates: High Limit = 120 + (.10)(120) = 132 Low Limit = 120 + (-.10)(120) = 108 Relative: The Target Parameter value plus the value specified in the Low and High fields. Only available for reports. For example: At runtime, the Server calculates: High Limit = 120 + (10) = 130 Low Limit = 120 + (-10) = 110 Scale Enabled only when the Calculation is Absolute. Indicates whether the absolute verification limits are scaled the same percentage as the Batch Scale value specified in the Batch Creation dialog box in the FactoryTalk Batch View.
Percent/Relative Target Enabled when the calculation is Percentage and Relative of report limits. Parameter Select the parameter whose value is to be used in the percentage or relative calculation that determines the report verification limit. The list only displays real or integer recipe parameters assigned to the same control strategy as the report on the phase being edited. None Signature Template A deviation event is recorded in the FactoryTalk Batch event journal, but no other action occurs (default). Indicates that a signature verification is required when parameter or report values fall outside of the specified range. If you select this option you must click the browse button to open the Select Signature Template dialog box. Select the signature template that contains the Signoff groups who have the security privileges to enter signature verifications at this verification level. Indicates the recipe cannot proceed when the values for the parameter or report are outside the defined limits. No event is recorded in the event journal.
Not Allowed
280
13 Configuring Phases
Definition These fields are used in calculating the default parameter deviation limits. These values can be changed in the recipe, but if no values are provided in the recipe parameters, the values entered here are used. The definition of this field differs depending on the Calculation method selected.
For Absolute calculation: The actual values entered are the Low and High deviation limits. Deviation Limit = Absolute value. For Percent calculation: These values define the percentage of the Target Parameter used in calculating the Low and High deviation limits. These values are the Percentage in the following equation: Deviation Limit = Target Parameter + (Target Parameter * Percentage). You can enter positive and negative values. If you want to define the Low limit as lower than the Target Parameter value, you must enter a negative value in the Low field. For Relative calculation: The actual value entered is added to the Target Parameter value to determine the deviation limit. These values are the Relative value in the following equation: Deviation Limit = Target Parameter + (Target Parameter + Relative value). You can enter positive and negative values. If you want to define the Low limit as lower than the Target Parameter value, you must enter a negative value in the Low field.
The selected policy is enacted when the parameter or report values are outside of the calculated deviation limits.
Configuring the Verification Policy for Parameters and Reports Before you configure the Verification Policies for parameters and reports, make sure you have set up electronic signature templates. (See Creating a Signature Template for more information.)
The phase parameter or report type must be Real or Integer. You cannot configure a Verification Method for String or Enumeration parameters or reports.
1. If you have not already done so, open the Edit Phase dialog box, by right-clicking the Phase. Click the Parameters or Reports tab to configure a verification policy for either a parameter or report, respectively.
281
2. Click the Verification Method button. The Verification Policies dialog box opens.
3. From the Verification Method drop-down list, select the verification method you want to use for the parameter or report. The method chosen determines which fields in the dialog box become enabled. 4. If you selected the High/Low, High-High/Low-Low, or the High-High-High/LowLow-Low verification method, you must specify a calculation method. From the Calculation drop-down list, select the calculation method that will be used to determine the deviation limits. (Absolute is the only available selection for parameters. If you selected the No Limits verification method, the Calculation list is disabled. Continue with Step 7.) 5. If you selected the Absolute calculation method, you have the option of selecting the Scale checkbox. The Scale option scales the absolute verification limits the same percentage as the Batch Scale value specified on the Batch Creation dialog box in the Batch View. 6. If you selected the Percent or Relative calculation method, you must select a parameter from the Percent / Relative Target Parameter drop-down list. The parameters value you select will be used in the percentage or relative calculation that determines the report verification limit. The list only displays real or integer recipe parameters assigned to the same control strategy as the report on the phase being edited.
Changes you make to the target parameter could automatically alter the verification policy of all referencing reports. (See How Editing Target Parameters Affects Report Verification Policies for more information.)
282
13 Configuring Phases
7. In the Policy when value is within limits area, select one of the policy options. (See Field Descriptions for Verification Policies Dialog Box for more information.) If you selected Signature Template, you must specify which signature template to use. Click the Browse button next to the Signature Template option. The Select Signature Template dialog box opens.
8. From the Select Template list, select the signature template that defines the signature policy you want to use for this parameter or report verification limit. 9. Click the OK button. The Select Signature dialog box closes, and the signature template you chose is displayed in the box next to the Signature Template option. 10. Repeat steps 7 - 9 for each Policy area that is enabled. In addition to these steps, for each enabled Policy, enter values in each respective set of Low and High fields that will be used in calculating the verification limit. (See Field Descriptions for Verification Policies Dialog Box for more information.)
If you change a parameter or report type from Real to Integer, and the calculation method for the verification policy is Absolute or Relative, the values in each set of Low and High limits are automatically rounded to the nearest integer.
11. Click OK to save changes and return to the Edit Phase dialog box. If you want the Batch Server to download the verification limits to the phase logic, you must enable or define a set of limit tags. After you finish setting up verification policies, you enable or define these limit tags when you are configuring each equipment module for automatic (non-instruction based) phases. (See Creating Parameter Limit Tags and Creating Report Limit Tags for instructions.)
283
If any of the following changes are made to a parameter, the verification method is automatically reset to No Limits for all reports that reference that parameter as the target parameter:
Parameter name is changed Parameter type is changed from Integer or Real to String or Enumeration Parameter is removed from the same control strategy as a report Parameter is deleted
Since material-enabled phases are different from standard phases you should be aware of the following issues when configuring a phase to be material-enabled:
What to do with existing parameters and report parameters What to do about the number of tags configured on the phase
284
13 Configuring Phases
If a standard phase does not have matching parameter and report names that are reserved for materials, making this phase material-enabled is quite simple. Once you enable Material Based Recipes, the two reserved parameters and two reserved report parameters are added. The same applies to the Add Optional Material Parameters feature. If you dont have the Parameter/Tag Locking feature enabled, you must add the appropriate number of tags.
Enabling a phase to support materials could result in issues if the data types of the existing parameters are not exactly what the material-based recipes subsystem expects. The system checks for correct data types and displays a message indicating that you must first correct those with an invalid data type. The parameter and report IDs previously configured remain unchanged, and the other material-based recipe parameters and reports that have not been configured are added and assigned IDs using the first-available integer greater than zero.
Duplicating a Phase
Phases can be cut, copied and/or pasted within the Class View area using the FactoryTalk Batch Equipment Editor toolbar. This feature allows you to duplicate phases within an
285
area model, including all of the phases parameters, reports and messages. You can also use this feature to cut or copy a phase from one area model to another.
Copying a Phase
1. From the Class View area, select the phase to be copied. 2. From the Edit menu, select Copy Phase, or click the Copy button. 3. From the Edit menu, select Paste Phase, or click the Paste button. A new phase is created with the default name PHASE NAME#, where # is an integer (beginning with 1) that increments each time the phase is pasted.
286
CHAPTER 14
When using material-enabled phases, you may add multiple instances of the same phase to a single unit instance. Even though these equipment modules are created from the same phase, they are distinguished from each other by the unique material containers with which they are associated. Equipment modules mapping to the same phase have independent resource IDs. When the same equipment module is required by multiple units, it can be shared between the units. However, an equipment module can only be owned by one unit at a time.
When an equipment module is selected in the Design View, the phase on which it is based is highlighted. Equipment modules are automatically updated if the phase on which they are based is modified. This includes equipment modules created prior to modifying the phase.
287
The Edit Equipment Module dialog box contains the following tabs:
Hyperlink (eProcedure only) Containers (Material Manager only) Parameter Limit Tags Report Limit Tags
When a START command is issued the FactoryTalk Batch Server Automatically Download Parameters downloads the parameters configured with the Download on Start option on the phase. You can enable this function by clicking on the Upon checkbox. If no parameters exist on the phase, this option appears START dimmed. If an OPC or RSLinx Enterprise FactoryTalk Live Data data server is assigned to the equipment module, this option is enabled when the number of parameter tags on the phase is equal or greater than the number of parameters. If a Logix5000 CIP data server is assigned to the equipment module, this option is enabled when DL on Start is selected for at least one parameter on the phase. If the Instruction Based Server is assigned to the equipment module, this function is disabled.
288
Item
Definition
Automatically Upload When the batch transitions to a terminal state (COMPLETE, STOPPED, or ABORTED) the Batch Server uploads the report values configured Parameters Upon with the Upload on Terminal State option on the phase. You can enable COMPLETE this function so that it occurs for any or all of these terminal states by STOPPED clicking on the checkbox. If no reports exist on the phase, these options ABORTED appear dimmed. If an OPC or RSLinx Enterprise FactoryTalk Live Data data server is assigned to the equipment module, this option is enabled when the number of report tags on the phase is equal or greater than the number of reports. If a Logix5000 CIP data server is assigned to the equipment module, this option is enabled when UL on Terminal State is selected for at least one report on the phase. If the Instruction Based Server is assigned to the equipment module, this function is disabled.
1. Select the General tab of the Edit Equipment Module dialog box.
2. Type the equipment module name in the Name box. 3. For use with RSBizWare BatchERP only. Type the SAP R/3 equipment module name in the ERP Alias box. 4. Type the equipment ID in the Equipment ID box, or accept the default value.
289
5. Confirm the correct data server corresponding to the equipment module displays in the Data Server box. If it does not, click the dropdown list to locate the appropriate server.
If the data server does not correspond to the equipment module, a message will display stating that continuing will reset the assignment to <None>.
6. For use with FactoryTalk eProcedure only. Click the browse button next to the Instruction File box. The Instruction Selection dialog box opens.
7. Select the instruction file that applies to the equipment module. The instructions appear in the Instructions area.
You must define an instruction file for each instruction-based equipment module. If an instruction-based equipment module has no instruction file associated with its configuration, the eProcedure Server will not start.
8. Click OK to return to the Edit Equipment Module dialog box. 9. Enable the Automatically Download Parameters Upon START check box if you want the Batch Server to automatically download the appropriate parameters on a START command.
The Automatic Upload/Download features are a configurable option on an equipment module only when the associated phase parameters and reports have at least one member of the upload/download parameter subsets. These features are disabled when an Instruction Based Server is selected.
10. Enable all or individual Automatically Upload Parameters Upon check boxes if you want the Batch Server to automatically upload the appropriate report values when the batch transitions to a terminal state (COMPLETE, STOPPED, or ABORTED). 11. Click Apply to save changes.
290
Name Type
Class Description
On Control Scan Rate Displays the on control scan rate for the OPC or RSLinx Enterprise FactoryTalk Live Data data server associated with the equipment module (view-only). The scan rate can be modified only within specific data server definition (DSDF) files. Typically, these values do not need to be modified. The valid range of the on control scan rate is 250 to 30,000 milliseconds. Off Control Scan Rate Displays the off control scan rate for the OPC or RSLinx Enterprise FactoryTalk Live Data data server associated with the equipment module (view-only). The scan rate can be modified only within specific data server definition (DSDF) files. Typically, these values do not need to be modified. The valid range of the off control scan rate is 250 to 60,000 milliseconds.
Once you have entered the appropriate data under the General tab, you can now configure the tag data for the equipment module. The following instructions only apply to equipment modules that are assigned to an OPC or RSLinx Enterprise FactoryTalk Live Data data server.
For PhaseManager equipment modules that are assigned to a Logix5000 CIP data server, you do not have to configure tags data. See the FactoryTalk Batch PhaseManager Users Guide for more information.
291
1. Select the Tags tab of the Edit Equipment Module dialog box.
2. If the data server associated with the equipment module is an OPC or RSLinx Enterprise FactoryTalk Live Data data server that allows for configurable scan rates, the default scan rates for the equipment module can be modified. If the values are not modifiable, they are disabled. Type the On Control and Off Control scan rates for the equipment module in the On Control and Off Control boxes, respectively. 3. Click Apply to save changes. Configuring an Equipment Module Tag Equipment module tags are automatically named; those names cannot be directly modified. If the equipment module name changes, the tag name changes. There are ten default tags created for each OPC or RSLinx Enterprise FactoryTalk Live Data equipment module. Additional tags are created based on the number of report, parameter, and request tags specified on the General tab of the Edit Phase dialog box. All equipment module tags must be configured after the equipment module is created to include the correct tag item. An item references the addressable location in which the tag data is stored. The data type for the ten default tags is integer and cannot be modified. The default data type for any additional tags that have been configured is real. You can change the data types for parameter and report tags when they are defined for the phase. You can change the data types for the additional request tags when you edit the equipment module.
292
When you add an equipment module to your area model, you are prompted to select the data server for assignment to each tag. You can change the data server assigned to the tags when you edit the equipment module.
The data server for a limit tag must be the same as the data server for its associated parameter tag. If the data server for a parameter tag is changed, the data server for the associated limit tags is automatically changed also. You cannot change the data server for a limit tag only. If you want to change the data server for a limit tag, you must change the data server for its associated parameter tag.
The following is an overview of the naming conventions used for equipment module tags The examples are based on an equipment module called CHARGE1. The ## is a sequentially assigned number for each user-defined parameter, report, and additional request tag, beginning with 01. This example has only a single parameter, report, and additional request configured on the phase, so you would replace the ## with 01.
Equipment Module Tag Naming Conventions
Class Name Parameter Tags PARMTR## Parameter Limit Tags PARMTR##M PARMTR##L PARMTR##H PARMTR##LL PARMTR##HH PARMTR##LLL PARMTR##HHH Report Tags REPORT## Report Limit Tags REPORT##M REPORT##L REPORT##H REPORT##LL REPORT##HH
Tag Name
Example
[Equipment_Module_Name]P##
CHARGE1P01
[Equipment_Module_Name]R##
CHARGE1R01
293
Class Name REPORT##LLL REPORT##HHH Request Tags REQUEST## Default Tags COMMAND FAILURE OWNER PAUSE PAUSED REQUEST SINGLE_STEP STATUS STEP_INDEX UNIT
[Equipment_Module_Name]Q##
CHARGE1Q01
[Equipment_Module_Name]_OC [Equipment_Module_Name]_F [Equipment_Module_Name]_W [Equipment_Module_Name]_P [Equipment_Module_Name]_PD [Equipment_Module_Name]_RQ [Equipment_Module_Name]_SS [Equipment_Module_Name]_ST [Equipment_Module_Name]_SI [Equipment_Module_Name]_UN
CHARGE1_OC CHARGE1_F CHARGE1_W CHARGE1_P CHARGE1_PD CHARGE1_RQ CHARGE1_SS CHARGE1_ST CHARGE1_SI CHARGE1_UN
Equipment module tags are configured using the Edit Equipment Module Tag dialog box which displays the following data:
Item Name Tag Class Type Definition The automatically assigned name of the equipment module tag (view-only). The equipment module tag class (view only). The equipment module tags data type. Parameters and reports defined as enumerations will default to Integer as the tag type. This should never be set to Enumeration, because an OPC or RSLinx Enterprise FactoryTalk Live Data data server does not recognize this tag type. Parameters and reports defined as enumerations should use Integer as the tag type. If the phases Parameter/Tag Locking feature is enabled (checked), you cannot modify the Type. This should not be used. OPC or RSLinx Enterprise FactoryTalk Live Data data servers do not recognize enumeration tag types. Parameters and reports defined as enumerations must use Integer as the tag type. If the phases Parameter/Tag Locking feature is enabled (checked), you cannot modify the Enumeration.
Enumeration
294
Definition The OPC access path used with the read item when the data server attempts to subscribe to the tags value, or when performing read operations. This field changes to Read Item Access Path when the associated OPC data server requires separate read and write items. The name of the item used when subscribing to the tags value or when performing read operations. This field changes to Read Item Name when the associated OPC data server requires separate read and write items.
Item Name
Write Access Path The OPC access path for the write item. This is disabled if the data server does not require separate read and write items. Write Item Name The OPC item name for the write item. This is disabled if the data server does not require separate read and write items or does not require an access path. Data Server Type The user-defined data server name used by the equipment module tag. (This field is disabled for request, control, and limit tags.) The data server as defined in the DSDF file (view-only).
1. From the Tags tab of the Edit Equipment Module dialog box, double-click the desired equipment module tag in the list box. The Edit Equipment Module Tag dialog box opens.
2. Select an appropriate data type from the Type list. OPC or RSLinx Enterprise FactoryTalk Live Data data servers do not accept Enumeration data types. You should use Integer instead. If the phases Parameter/Tag Locking feature is enabled, you cannot modify the Type. 3. Type the appropriate access path in the Access Path box. 4. Type the appropriate item name in the Item Name box. 5. If the data server requires separate read and write items, type the write access path in the Write Access Path box.
295
6. If the data server requires separate read and write items, type the write item name in the Write Item Name box. 7. Select the appropriate data server from the Data Server list if the default is not correct. 8. Click OK to return to the Edit Equipment Module dialog box. 9. Click Apply to save your changes; click OK to close the Edit Equipment Module dialog box. Setting Tag Items to the Default Addresses When an Equipment Module is created from a phase in the area model, the default equipment module name is <phasename>1. For example, if the phase is AGITATE, the equipment module created from this phase takes on a default name of AGITATE1. Likewise, when an equipment module is created its tag items have the following default name: <Equipment Module Name><Tag Separator><Tag Extension> For example, if the tag separator is a dot (.), the Request tag (RQ) for equipment module AGITATE1 would be: AGITATE1.RQ If the equipment module name is subsequently changed, its tag item names do not automatically change to reflect the new equipment module name. For example, if you change the equipment module name from AGITATE1 to AGITATE_U2, the tag Names will reflect the new name (AGITATE_U2), but the tag Item Names will still reflect the equipment modules original name (AGITATE1). The example request tag for the AGITATE_U2 equipment module would still be AGITATE1.RQ. You can re-establish the default address information for an equipment module by using the Defaults button. The Item, Read Access Path, Read Item Name, Write Item Path, and Write Item Name are returned to the appropriate default values specified for the data server assigned to the equipment module. The equipment module tag names will be changed to reflect the equipment modules current name. To make these changes, complete the following steps:
This is an irreversible action! Once the Defaults button is clicked, all tag item names and access paths are automatically changed. (See Setting All Tag Items to Default Name and Access Path for more information.)
1. On the Tags tab of the Edit Equipment Module dialog box, click the Defaults button. The following message displays:
2. Click Yes to set the defaults and return to the Edit Equipment Module dialog box.
296
1. Select the Arbitration tab of the Edit Equipment Module dialog box. 2. Browse the area models equipment hierarchy to specify the equipment that must be acquired by the equipment module. The lack of a plus or minus sign to the left of an equipment type indicates that no equipment of that type has been defined, OR that the equipment type cannot be used as a needed equipment item at this level.
To add equipment, select the equipment needed by the equipment module under the Equipment Allocation by Resource area and click the Add button. The selected equipment is displayed in the right pane. To remove equipment, select the equipment to delete in the right pane and click the Remove button. The selected equipment is removed from the list.
297
Cross Invocation The caption for each additional menu item that will be added to the Batch Configuration View and ActiveX controls shortcut menus. (See the FactoryTalk Batch Administrators Guide for information on how to specify what data should be passed to the specified automation server when the menu item is selected.) The default labels associated with each of the five fields are Cross Invocation Label # (where # is 1 through 5). These labels can be modified in the Server Options dialog box, and are only displayed in the Edit Equipment Module dialog box.
1. Select the Cross Invocation tab of the Edit Equipment Module dialog box.
2. Type the cross invocation string information in the Cross Invocation Configuration boxes. 3. Click Apply to save changes.
298
1. Select the Hyperlink tab of the Edit Equipment Module dialog box.
2. Type a valid URL string in the Hyperlink Configuration boxes. (See the FactoryTalk eProcedure Administrators Guide for more information.) 3. Click Apply to save changes.
299
The following fields display in the Containers tab of the Edit Equipment Module dialog box:
Item Name Phase Container and Storage Location Associations Definition The name of the equipment module (view-only). The phase name from which this equipment module was created (view-only). The icon associated with the phase is displayed next to the Name and Phase. A list of containers and storage locations to which this equipment module is connected. The two columns in the right pane indicate whether the container is a source or a destination for material. Icons are used to represent a material source (container with a plus sign), and a material destination (container with a minus sign). The left pane is a hierarchical display of the set of containers and storage locations currently configured in the material database. The hierarchy has two roots: Containers and Storage Locations. Expand Containers to display all the containers within the material database that are not associated with a storage location. Containers within storage locations are not displayed because the equipment module makes an association only with independent containers or storage locations, never with containers within storage locations. Expand Storage Locations to display a list of all the storage locations configured within the Material Editor. Add Remove Allows you to add a selected container or storage location to the Container/ Storage Location column. Allows you to remove the selected container or storage location from the Container/Storage Location column.
1. Select the Containers tab of the Edit Equipment Module dialog box.
2. Browse the container and storage location trees to specify associations with the equipment module. The lack of a plus or minus sign to the left of Containers or Storage Locations indicates no containers or storage locations have been defined. You
300
define these in the Material Editor. (See the FactoryTalk Batch Material Editor Users Guide for instructions on how to add containers and storage locations.) 3. Select the container or storage location needed by the equipment module under the Container and Storage Location Associations area and click the Add button. The item selected is displayed in the right pane under the Container/Storage Location column. You cannot add a container that already exists in the Container/Storage Location column. To remove a container or storage location, select the item to delete in the right pane and click the Remove button. The selected item is removed from the list. 4. Select the appropriate check box to indicate if the container is a source of material (material will be drawn from this container), a material destination (material enters this container), or both.
At least one check box, addition or distribution, must be selected for the configuration to be accepted, and it must agree with the containers behavior. The High and Low values configured in the phase parameters specify the containers behavior, whether the phase is a material addition, distribution, or both. Addition - Low = 0, High = positive number Distribution - Low = negative number, High = 0 Both - Low = negative number, High = positive number
5. Click Apply to save changes. 6. Click OK to close the Edit Equipment Module dialog box.
Enable Limit Tags Creates the necessary parameter limit tags for the verification policies configured on the phase. This option is only available if the Parameter/Tag Locking option was selected on the General tab of the Edit Phase dialog box. If the Parameter/Tag Locking option was not selected, you must define the limit tag sets and map the parameter tags to the limit tags.
301
Item
Definition
Note: The following areas are enabled only if Parameter/Tag Locking is disabled. Parameter Tag to Limit Tag Mapping Area Parameter Tag Displays the tag name for the user-defined parameter that was created in the phase (view only). (See Configuring an Equipment Module Tag for information on equipment module tag naming conventions.) Displays the parameters data type (view only). Set Creates the necessary set of verification limit tags for the parameter. Select the same verification method that is configured on the Parameters tab of the Edit Phase dialog box.
Limit Tags Area Left Scroll Box Name Type Lists the set of equipment module tag classes created for the selected Limit Tag Set. Displays the equipment module tag defined for the selected tag class (view only). Displays the equipment module tag data type. The area below the Type field describes the equipment module tag (view only).
The Parameter/Tag Locking option is enabled by default on the General tab of the Edit Phase dialog box This feature causes the system to automatically create and maintain the necessary phase parameter tags for the parameters defined in the phase. If the Parameter/ Tag Locking option is enabled on the phase from which the equipment module was created, you can enable the system to automatically create the required verification limit tags for the parameters that have signature verification policies defined. 1. Select the Parameter Limit Tags tab of the Edit Equipment Module dialog box. 2. If the Parameter/Tag Locking option has been enabled, the Enable Limit Tags checkbox is available. Select the Enable Limit Tags checkbox.
302
The limit tags required for all parameters with signature verification policies in this equipment module are automatically created and displayed in the Limit Tags area. 3. Click OK to close the Edit Equipment Module dialog box or Apply to keep the dialog box open. Mapping Parameter Tags to Parameter Limit Tags
Follow this procedure to create parameter limit tags if Parameter/Tag Locking is NOT enabled on the phase from which the equipment module was created and you are creating parameter tags manually. These instructions only apply to OPC or RSLinx Enterprise FactoryTalk Live Data equipment modules.
If the Parameter/Tag Locking option is disabled on the phase from which the equipment module was created, you must manually select the appropriate Limit Tag Set for each Parameter Tag. 1. Select the Parameter Limit Tags tab of the Edit Equipment Module dialog box. 2. Place the cursor in the Limit Tag Set field in same row as the parameter you want to map. The drop-down arrow displays.
Remember to update the Number of Tags fields on the General tab of the Edit Phase dialog box before mapping parameter tags to limit tags. Even if you have added parameters to the phase and configured verification methods for them, parameter tags will not display in the Parameter Tag to Limit Tag mapping area if the Number of Tags entered on the phase is too low.
3. From the Limit Tag Set drop-down list, select the option that matches the verification method defined for the parameter on the phase.
If the phase on which the equipment module is based uses control strategies, select the verification method of the control strategy that has the largest number of limits. For example if a phase has two control strategies, and Strategy 1 has a verification method of H/L, and Strategy 2 has a verification method of HHH/LLL, you should choose the HHH/LLL limit tag set.
303
All limit tags required for the selected Limit Tag Set are created and displayed in the Limit Tags area.
4. Repeat steps 2 - 3 for each parameter that has a verification policy with parameter verification limits specified. 5. Click OK to close the Edit Equipment Module dialog box or Apply to keep the dialog box open.
Definition Name of the equipment module. Name of the phase from which the equipment module was created.
Enable Limit Tags Creates the necessary report limit tags for the verification policies configured on the phase. This option is only available if the Parameter/Tag Locking option was selected on the General tab of the Edit Phase dialog box. If the Parameter/Tag Locking option was not selected, you must define the limit tag sets and map the report tags to the limit tags.
304
Item
Definition
Note: The following areas are enabled only if Parameter/Tag Locking is disabled. Report Tag to Limit Tag Mapping Area Report Tag Displays the tag name for the user-defined report that was created in the phase (view only). (See Configuring an Equipment Module Tag for information on equipment module tag naming conventions.) Displays the reports data type (view only). Creates the necessary set of verification limit tags for the report. Select the same verification method that is configured on the Reports tab of the Edit Phase dialog box.
Limit Tags Area Left Scroll Box Name Type Displays the set of equipment module tag classes created for the selected Limit Tag Set. Displays the equipment module tag name defined for the selected tag class (view only). The equipment module tag data type. The area below the Type field displays a description of the equipment module tag (view only).
The Parameter/Tag Locking option is enabled by default on the General tab of the Edit Phase dialog box This feature causes the system to automatically create and maintain the necessary phase parameter and report tags for the parameters and reports defined in the phase. If the Parameter/Tag Locking option is enabled on the phase from which the equipment module was created, you can enable the system to automatically create the required verification limit tags for the reports that have signature verification policies defined. 1. Select the Report Limit Tags tab of the Edit Equipment Module dialog box. 2. If the Parameter/Tag Locking option has been enabled, the Enable Limit Tags checkbox is available. Select the Enable Limit Tags checkbox.
305
The limit tags required for all reports with signature verification policies in this equipment module are automatically created and displayed in the Limit Tags area. 3. Click OK to close the Edit Equipment Module dialog box or Apply to keep the dialog box open. Mapping Report Tags to Report Limit Tags
Follow this procedure to create parameter limit tags if Parameter/Tag Locking is NOT enabled on the phase from which the equipment module was created and you are creating parameter tags manually. These instructions only apply to OPC or RSLinx Enterprise FactoryTalk Live Data equipment modules.
If the Parameter/Tag Locking option is disabled on the phase from which the equipment module was created, you must manually select the appropriate Limit Tag Set for each Report Tag. 1. Select the Report Limit Tags tab of the Edit Equipment Module dialog box. 2. Place the cursor in the Limit Tag Set field in same row as the parameter you want to map. The drop-down arrow displays.
Remember to update the Number of Tags fields on the General tab of the Edit Phase dialog box before mapping report tags to limit tags. Even if you have added reports to the phase and configured verification methods for them, report tags will not display in the Report Tag to Limit Tag mapping area if the Number of Tags entered on the phase is too low.
3. From the Limit Tag Set drop-down list, select the option that matches the verification method defined for the report on the phase.
If the phase on which the equipment module is based uses control strategies, select the verification method of the control strategy that has the largest number of limits. For example if a phase has two control strategies, and Strategy 1 has a verification method of H/L, and Strategy 2 has a verification method of HHH/LLL, you should choose the HHH/LLL limit tag set.
306
All limit tags required for the selected Limit Tag Set are created and displayed in the Limit Tags area.
4. Click OK to close the Edit Equipment Module dialog box or Apply to keep the dialog box open.
When the phase contains control strategies, the number of limit tags for the parameter is the largest limit set for any of the control strategies to which the parameter is assigned. When you delete a control strategy, the system automatically recalculates the limit tag set required for each parameter and adjusts the number of limit tags accordingly. If you delete the control strategy that defined the largest set of limits for the parameter, the number of limit tags will automatically be decreased.
307
If Parameter/Tag Locking was enabled when you created limit tags for the equipment module, and then you later disable Parameter/Tag Locking, the existing tags will be preserved and will not be modified. If a parameter or report is deleted, the corresponding set of limit tags will be automatically deleted. The parameter tag to limit tag set is maintained for the other remaining parameters or reports, and the item names assigned to each tag remain the same.
If Parameter/Tag Locking is NOT enabled and a parameter or report is deleted from the phase and the Number of Tags on the General tab of the Edit Phase dialog box is decreased, you will need to re-map the remaining parameter tags to limit tag sets. The parameter tag names and limit tag associations are shifted; they are not maintained.
308
1. Navigate to the phase level of the unit in your area model that does not contain the equipment module to be shared. 2. Click the Share button. The Share Equipment Module Between Units dialog box opens. The equipment modules in each unit can be displayed by clicking the plus (+) sign next to the unit names.
3. Select the equipment module you want to share with the current unit, then click OK. The selected equipment modules icon is displayed in the Design View area, with a small hand at the bottom left corner, in both the active unit and the unit in which the equipment module was originally defined.
309
310
APPENDIX A
Resource Classes
Resource classes are created or edited by selecting Resources from the Edit menu. The following tables describe warm restart support for adding resource classes within an area model.
Resource Class Action Create new resource class Warm Restart Supported Yes
The following table describes warm restart support for modifying resource class properties:
Resource Class Property Resource class name Warm Restart Supported Yes
Resources
Resources are created and edited by selecting Resources from the Edit menu.
311
The following table describes warm restart support for adding resources defined within an area model.
Resource Action Creation Warm Restart Support Yes
The following table describes warm restart support for modifying resource properties:
Resource Property Name Max Owners Dependent Resources Cross Invocation Labels Hyperlink Labels Warm Restart Support Yes The value of this property can be increased without affecting warm restart functionality. Resources can be removed from a resources list of dependent resources without affecting warm restart functionality. Yes Yes
Unit Attributes
Unit attributes are created and edited by selecting Tags from the Edit menu. The following table describes warm restart support for adding unit attributes defined within an area model.
Unit Attribute Action Create tag class Warm Restart Supported Yes
The following table describes existing warm restart support for modifying unit attribute properties:
Unit Attribute Property Engineering Unit Description Warm Restart Supported Yes Yes
312
The following table describes existing warm restart support for modifying the properties of a unit attribute tag:
Unit Attribute Tag Property Warm Restart Support Engineering Unit Data Source Access Path Item Name Write Access Path Write Item Name Server Yes Yes Yes Yes Yes Yes Yes
Enumeration Sets
Enumeration sets are created and edited by selecting Enumeration Sets from the Edit menu. The following table describes warm restart support for adding enumeration sets defined within an area model.
Enumeration Set Action Creation Warm Restart Support Yes
Enumerations
Enumerations are created and edited by selecting Enumeration Sets from the Edit menu. The following table describes warm restart functionality for the adding of enumerations within an area model.
Enumeration Action Creation Warm Restart Support Yes
313
Data Servers
Data servers are created and edited by selecting Server from the Edit menu. The following table describes warm restart functionality for adding data servers to an area model.
Server Action Creation Warm Restart Support Yes
The following table describes warm restart support for modifying data server properties:
Server Property Data Server Type Watchdog Protocol Watchdog Item Access Path Watchdog Item Name Watchdog Write Item Access Path Watchdog Write Item Name Server Location On Control Scan Rate Off Control Scan Rate Warm Restart Support Yes Yes Yes Yes Yes Yes Yes Yes Yes
The following table describes warm restart support for modifying the properties of a process cell class:
Process Cell Class Property Warm Restart Support Name Icon Yes Yes
314
Process Cells
Process cells are created and deleted using the main window of the FactoryTalk Batch Equipment Editor. Properties of a process cell can be edited by right-clicking on the icon representing a process cell. The following table describes warm restart support for adding process cells.
Process Cell Action Creation Warm Restart Support Process cells can be added to an area model.
The following table describes warm restart support for modifying the properties of a process cell:
Process Cell Property ERP Alias Max Owners Dependent Resources Cross Invocation Labels Hyperlink Labels Warm Restart Support Yes The value of this property can be increased without affecting warm restart functionality. Resources can be removed from a process cell's list of dependent resources without affecting warm restart functionality. Yes Yes
Unit Classes
Unit classes are created within the main window of the FactoryTalk Batch Equipment Editor. Properties of a unit class can be edited by right-clicking on the icon representing a unit class. The following table describes warm restart support for adding unit classes.
Unit Class Action Creation Warm Restart Support Unit classes can be added to an area model
The following table describes warm restart support for modifying the properties of a unit class:
Unit Class Property Icon Assigned Unit Attributes Warm Restart Support Yes Unit attributes can be added to the unit classs assigned set
315
Units
Units are created within the main window of the FactoryTalk Batch Equipment Editor. Unit properties can be edited by right-clicking on the icon representing a unit. The following table describes warm restart support for adding units.
Unit Action Creation Warm Restart Support Yes
The following table describes warm restart support for modifying unit properties:
Unit Property ERP Alias Unit Attribute Tags Dependent Resources Cross Invocation Labels Hyperlink Labels Warm Restart Support Yes (See Unit Attribute Tags for information on which properties can be modified.) Removing resources from a unit's list of dependent resources can be done without affecting warm restart functionality Yes Yes
Parameters
A phases parameters are created on the Parameters tab of the Edit Phase dialog box. This dialog box can be opened by right-clicking on a Phase icon. The following table describes warm restart support for adding parameters to a phase.
Parameter Action Creation Warm Restart Support Parameters can be added to a recipe phase without affecting warm restart functionality, with the exception of material parameters.
When you select the Material Based Recipes option on the General tab of the Edit Phase dialog box, the optional material parameters, MATERIAL and AMOUNT, are added to the Parameters tab. The warm restart functionality does NOT support these material parameters. Adding these material parameters and then performing a warm restart causes running batches to be removed from the Batch List.
The following table describes warm restart support for modifying the properties of a parameter associated with a phase:
Parameter Property High Low Warm Restart Support You can raise the value of this property You can lower the value of this property without affecting warm restart functionality
316
Warm Restart Handling of Added Parameters When a unit operation level recipe is built in the FactoryTalk Batch Recipe Editor, you must specify a value for each parameter in the recipe phases that are added as steps to the unit operation. The value can be one of the following:
If the FactoryTalk Batch Server detects that a new parameter has been added to the recipe phase (during the restoration of batches to the batch list during a warm restart), then there is no value for the parameter that can be found in the loaded recipe structure. When this situation occurs, the Server will set the value on the parameter for the step to Operator Prompt.
Reports
A phases reports are created on the Reports tab of the Edit Phase dialog box. This dialog box can be opened by right-clicking on a Recipe Phase icon. The following table describes warm restart support for adding reports to a phase.
Report Action Creation Warm Restart Support Reports can be added to a recipe phase without affecting warm restart functionality, with the exception of material reports.
When you select the Material Based Recipes option on the General tab of the Edit Phase dialog box, the optional material reports, ACTUAL_AMOUNT and FEED_COMPLETE, are added to the Reports tab. The warm restart functionality does NOT support these material reports. Adding these material reports and then performing a warm restart causes running batches to be removed from the Batch List.
The following table describes warm restart support for modifying the properties of a report associated with a phase:
Report Property Engineering Units Verification Method ERP Alias Warm Restart Support Yes Yes Yes
317
Warm Restart Handling of Added Reports When a unit operation level recipe is loaded into the Batch Server, the value of each report for each recipe phase step is set to Bad Value. As the phase logic uploads report values, the Bad Value is replaced with the actual value reported by the phase logic. If the FactoryTalk Batch Server detects that a new report has been added to the recipe phase (while restoring batches to the batch list during a warm restart), then the report is treated as if it was never uploaded and assigned a current value of Bad Value.
Configured Messages
A recipe phases messages are created on the Messages tab of the Edit Recipe Phase dialog box. This dialog box can be opened by right-clicking on a Recipe Phase icon. The following table describes existing warm restart support for adding configured messages to a recipe phase.
Message Action Creation Warm Restart Support Messages can be added to a Recipe Phase without affecting warm restart functionality.
Recipe Phases
Recipe phases are created and deleted using the main window of the FactoryTalk Batch Equipment Editor. Properties of a recipe phase can be edited by right-clicking on a Recipe Phase icon. The following table describes existing warm restart support for the adding of recipe phases.
Recipe Phase Action Creation Warm Restart Support Recipe Phases can be added to an area model without affecting warm restart functionality.
The following table describes existing warm restart support for modifying a recipe phases properties:
Recipe Phase Property Number of Parameter Tags Number of Report Tags Parameters Reports Messages Warm Restart Support An increase in this value is considered safe for warm restart functionality. An increase in this value is considered safe for warm restart functionality. (See Parameters for information on which properties can be modified.) (See Reports for information on which properties can be modified.) (See Configured Messages for information on which properties can be modified.)
318
Equipment Phases
Equipment phases are created using the Equipment Editors main window. Equipment phase properties can be edited by right-clicking on an Equipment Phase icon. The following table describes existing warm restart support for adding equipment phases:
Equipment Phase Action Creation Warm Restart Support Equipment phases can be added to an area model without affecting warm restart functionality.
The following table describes existing warm restart support for modifying an equipment phases properties:
Equipment Phase Property ERP Alias Automatic Download on Start Warm Restart Support This property can be changed without affecting warm restart functionality. Yes
Automatic Upload on Complete Yes Automatic Upload on Stopped Automatic Upload on Aborted Server Tags Dependent Resources Yes Yes Yes (See Equipment Phase Tags for information on which properties can be modified.) Removing resources from an equipment phases list of dependent resources can be done without affecting warm restart functionality. Yes Yes
319
320
APPENDIX B
Troubleshooting
Import/Export Area Model Errors
The following sections describe possible errors that can be encountered when importing or exporting an area model to an XML file.
321
If this is encountered, the following error message displays and the export does not occur.
XML Parser Error Messages The Microsoft XML parser returns different error messages for different error conditions. Examples of error conditions and error messages:
Error Condition Invalid Data Invalid Element Content Undefined Key Reference Uniqueness Violation Error Message The element: Element Name has an invalid value according its data type. The element content is invalid according to its Schema. Expecting: Element Name. Undefined values for KeyRef identity constraint: Reference Constraint Name. Duplicated values for unique/key identity constraint: Uniqueness Constraint Name.
322
B Troubleshooting
Material-Specific Errors When the referenced material, material class or container does not exist in the material database, a dialog box similar to the one shown here opens with a list of the missing phase parameter values:
Continue Change the missing material, material class or container with NULL_MATERIAL, NULL_CLASS or NULL_CONTAINER, respectively, and continue the process. Ignore Continue the process without any changes. You will be prompted to fix the problem. Cancel Quit the process.
If the Material Server is installed, but not accessible, or if the material system enumeration sets (MATERIALS, MATERIAL_CLASSES and CONTAINERS) are included in a material-enabled recipe phase and are not configured as NULL, the import occurs without generating an error message. A material-enabled recipe phase must contain the following two recipe parameters:
A material-enabled recipe phase must contain the following two report parameters:
A material-enabled recipe phase may optionally contain the following four recipe parameters. They must be included together or not at all:
324
Batch
325
CHAPTER 1
All recipes are configured and displayed using the ISA S88.01 Batch Control Standards, which define the following levels for the procedural model:
Procedure: The strategy for carrying out a process. In general, it refers to the strategy for making a batch within a process cell. It may refer to a process that does not result in the production of a product.
Examples: Make Product A Make Product B
Unit Procedure: A strategy for carrying out a contiguous process within a unit. It consists of contiguous operations and the algorithm necessary for the initiation, organization and control of those operations.
Examples: Emulsification Dehydrogenation
Operation: A procedural element defining an independent processing activity consisting of the algorithm necessary for the initiation, organization and control of phases.
Examples: Filtration Reaction
Phase: The lowest level of the procedural element in the procedural control model. A phase consists of the control steps and the algorithm necessary for the initiation, organization and control of those steps.
Examples: Agitate Heat
The recipe phase is the lowest level within a recipe. The recipe phase is mapped directly to the engineered logic on your plant floor. When a phase is added to a recipe in the Recipe Editor, it is based on a phase that has already been defined in your area model using the FactoryTalk Batch Equipment Editor. Based on the unit requirements specified in your recipe, the Equipment Editor phase maps to a specific equipment module (an instance of a phase). This equipment module is mapped (using tags) to an equipment operation or equipment phase that has been defined in the engineered logic. An operation consists of one or more recipe phases, and it must run within a single unit in your area model. You can combine multiple operations into a single unit procedure, as long as each operation runs in the same unit in your area model. Unit procedures are then
327
combined to create a procedure, the highest recipe level. Procedures can run across multiple units, allowing for unit-to-unit transfers.
Procedure
Unit Procedure
Operation Operation
Unit Procedure
Operation Operation
Phase
Phase
Phase
Phase
Phase
Phase
Phase
Phase
Recipe Levels
3. If you enter a FactoryTalk user name and password that is not configured to run the Recipe Editor, the Batch Recipe Editor dialog box opens.
4. If the user you enter is not found in the FactoryTalk Directory then the Logon Message dialog box opens. Click OK to close the dialog box. 5. The Recipes Requiring Verification dialog box may display the first time you open the Recipe Editor. Click Verify All to verify any unverified recipes, click Verify and
328
Validate All to verify and validate the SFCs of any unverified recipes, or click Cancel to close the dialog box and verify the recipes at a later time.
If the recipe directory defined in the area model contains binary recipes from a previous version of FactoryTalk Batch a dialog box may open prompting you to translate the recipes to the new schema. Once the recipes are translated you are prompted to verify the recipes.
The Recipe Editor displays the Procedure View and Recipe Construction panes. Before you begin using the Recipe Editor, configure the properties specific to the Procedure View, such as:
Supporting dynamic unit allocation in procedures. Allowing parallel operations in unit procedures. Determining the number of decimal places displayed in formula parameters. Determining the SFC Validation tools maximum number of allowable permutations (OR Divergences).
These options are configured by selecting Options from the View menu. (See Setting the Recipe Editor options for more information.) Since you need an understanding of the area model, you may want to open the FactoryTalk Batch Equipment Editor. The Recipe Editor toolbar contains a button that opens the Equipment Editor.
329
FactoryTalk Batch procedures can have parallel unit procedures and operations can have parallel equipment phases, regardless of this options setting.
330
the process-connected device (PCD). The interface to the PCD must be configured in the FactoryTalk Batch Equipment Editor.
Menu Bar Toolbar Recipe Constructi on Toolbox Procedure View Pane Recipe Constructi on Pane
Status Bar
Edit
331
Item View
Description Allows you to switch between the SFC View, Table View, or to tile the Recipe Construction Pane for displaying both views. Also, you can customize the Recipe Editor by hiding/showing the Toolbar, Status Bar and Recipe Construction Toolbox. Additionally, it allows you to show/ hide the page boundaries and set the Recipe Editors Options, which includes supporting dynamic unit allocation, parallel operations, formula parameter decimal places, and maximum number of SFC validation OR permutations. Provides you with online help and information about FactoryTalk Batch.
Help
The following table describes the Recipe Editor toolbar buttons and their corresponding keyboard shortcuts:
Description New Top Level: Creates a new procedure, unit procedure or operation. Open Top Level: Opens an existing recipe file. Save: Saves the current recipe. Generate Reports: Opens the Generate Reports dialog box for printing and reporting options. Shortcut
CTRL+N
CTRL+O
CTRL+S
CTRL+T
Delete Selection: Deletes the currently selected step(s), transition(s), or text DELETE box(es). Go Down: Moves down through the recipe levels and displays the related recipe structure for the step. --
Go Up: Moves up through the recipe levels and displays the related recipe -structure for the step. Header Data: Allows you to enter or change header data for the recipe level being viewed, including the name.
CTRL+H
332
Description
Shortcut
Recipe Formula Parameters: Allows you to create, edit, and delete recipe CTRL+R formula parameters. Verify: Verifies recipes for proper construction and displays a list of unresolved problems with a recipe. Also saves the recipe in the process. Verify and Validate: Verifies recipes based on the current unit requirements and validates the SFC structure. Also saves the recipe in the process. Bind Requirements: Allows you to add or delete binding requirements assigned to a unit requirement. Available only when Dynamic Unit Allocation is enabled. Bind Preferences: Allows you to add, delete and prioritize unit requirement binding requirements. Available only when Dynamic Unit Allocation is enabled. Redefine Step: Allows you to change the unit procedure, operation, or phase for the selected step. Value Entry: Allows you to enter formula values and modify the phase report limits for the selected step.
CTRL+L
--
CTRL+M
CTRL+B
CTRL+I
CTRL+A
Zoom: Allows you to specify the magnification of the current SFC display. -Grid Snap: Displays a grid in the Recipe Construction pane, and aligns elements of the SFC to the grid as they are moved or placed in the Recipe Construction pane. Invoke Equipment Editor: Opens the FactoryTalk Batch Equipment Editor. View as Table: Displays the Table View within the Recipe Construction pane.
CTRL+G
-SHIFT+Q
View as SFC: Displays the SFC View within the Recipe Construction pane. SHIFT+C Tile Views: Displays both the Table View and the SFC View within the Recipe Construction pane. Show/Hide Page Boundaries: Displays the recipe print layout in the SFC view.
SHIFT+Z
--
333
desired position. When the toolbox is detached from the window, you can move and/or hide it by right-clicking the toolbox and selecting the appropriate option from the shortcut menu. Press CTRL + Q to add or remove the toolbox from the Recipe Editor window. The toolbox command buttons and the keyboard shortcut keys that can be used to access them are:
Keyboard Shortcut
Description
Selection Tool: Selects a step in the Procedure View pane, Table View, or SHIFT+P SFC View. You can also select transitions in the SFC View. Click and drag the selection pointer over several SFC elements to select a group of elements. Step Tool: Adds a new step to the SFC. Transition Tool: Adds a new transition to the SFC. Link Tool: Links recipe components in the SFC View. Select a step and drag the cursor from the step to a transition linking the two components.
SHIFT+S
SHIFT+T
SHIFT+L
Remove Link Tool: Unlinks recipe components in the SFC View. Select a SHIFT+R step and drag the cursor from the step to a transition unlinking the two components. Text Box Tool: Adds a text box for recipe comments.
SHIFT+D
Add Step Tool: Adds a step and transition after the selected recipe element. SHIFT+A The Add Step tool is valid for initial, sequential, and parallel steps as well as transitions. Insert Step Tool: Inserts a step and transition before the selected recipe element. The Insert Step tool is valid for sequential, parallel and terminal steps as well as transitions.
SHIFT+I
or INSERT
Add Parallel Tool: Adds a step in parallel with the selected step. The Add SHIFT+E Parallel tool is valid for sequential and parallel steps only. Add Branch Tool: Adds a step and additional transitions to form a branch SHIFT+B structure. The Add Branch tool is valid for regular steps only. Remove Step Tool: Removes a step from the SFC structure, automatically SHIFT+M removing the transitions and rearranging the SFC. The Remove Step tool is valid for sequential and parallel steps only. Insert Step Before Parallel Tool: Inserts a step before a parallel structure. SHIFT+O A step within the parallel structure must first be selected to enable the tool. Add Step After Parallel Tool: Adds a step after a parallel structure. A step SHIFT+F within the parallel structure must first be selected to enable the tool.
334
Description
Keyboard Shortcut
Create Material Loop Tool: Creates a material loop for the selected SHIFT+N material enabled step. The step must have both the preceding and following elements attached before the material loop can be created. Undo Material Loop Tool: Removes a material loop that was just created. SHIFT+X To undo a material loop, this tool removes it immediately after it was created, before any other editing takes place.
Status bar
The status bar at the bottom of the FactoryTalk Batch Recipe Editor window displays (from left to right) the following items:
Recipe Editor Toolbar/Recipe Construction Toolbox button descriptions SFCs current scale size in the Recipe Construction Pane Active view (SFC or Table) Area model name Selected units name Current recipe level (BPC for Procedure, UPC for Unit Procedure, or UOP for Operation) Insert/Overwrite status Num-Lock on/off Logged on user name
335
Determine the process level Specify unit requirements Enter recipe header data Define recipe parameters Save the recipe Create a sequential function chart or table Define the steps Configure the step parameters Define the transitions (SFC only) Create phase link groups Verify the recipe and correct errors Release the recipe to production Print the recipe documentation Remove a recipe file Translate recipes
Recipe Completion
Recipe Maintenance
336
CHAPTER 2
Unambiguous representation of logic Support for all important logic structures: decisions, loops and parallelism Standardized in IEC 61131-3 specification
SFC components
Sequential function charts are composed of six graphical structures that are linked to form a chart. Each of the graphical structures represents an element in the recipe. The rules for execution of an SFC describe how the procedure executes. The following describes each recipe element and its graphical structure used in the SFC.
Initial Step: The logical start of the SFC.
OR Divergence: Represents a decision, where recipe control will be passed to only one of the subsequent steps. AND Divergence: Represents multiple procedures which are processed concurrently. OR Convergence: Indicates where two optional execution paths converge back into one execution path. AND Convergence: Indicates where two simultaneous execution paths converge back into one execution path.
337
Steps
A recipe can contain up to four procedure levels procedure, unit procedure, operation and phase. Each of the first three procedure levels can contain one or more steps, each referencing a lower level procedure. A step in a procedure references a unit procedure, a step in a unit procedure references an operation, and a step in an operation references a phase. Phases are defined in the area model using the FactoryTalk Batch Equipment Editor. An equipment module is a specific instance of a phase and maps to the equipment phase, which is the engineered logic residing in the process-connected device (PCD). The following diagram depicts the relationships between the recipe procedure levels and the phase logic in the PCD. Phases and equipment modules are the links between the recipe and the engineered logic.
ProcessConnected Device
Transition expressions
Transitions are the criteria that must be met before the recipe continues to the next logical step. Transition expressions are evaluated for syntax at the time they are created and are designated in the SFC with the name Tn, where n represents a unique number. The expression associated with each transition follows the traditional expression evaluation for the arithmetic operators (+, -, *, and /), the logical operators (AND, OR, and NOT), and the functions (ABS, MOD, TRUN, RND, and RDUP). The expression must always evaluate to either TRUE or FALSE.
The maximum length of a transition expression is 1023 characters.
338
Transition Identifiers TRUE Evaluates to non-zero FALSE Evaluates to zero (0) <unit>.<unit tag> <unit> represents one of the pre-configured units, and <unit tag> is a legal tag for the <unit>. <unit class>.<tag class> For class-based recipes, specify the name of the <unit class> and an associated <tag class>. <step name>.<step attribute> <step name> is the name of one of the steps in the same level of the recipe. <step attribute> is one of the following: FAILURE The FAILURE attribute is zero if no error has been encountered. Otherwise, its value is greater than zero. OWNERID The OWNERID attribute can be either PROGRAM or EXTERNAL, where PROGRAM signifies the batch is controlling the step and EXTERNAL means that the batch is not controlling the step. PAUSE Set by the batch server. Used to command the phase to pause at the next programmed pause transition. Can have the value of TRUE or FALSE. PAUSED Set by phase logic when the phase reaches a pause location. Can have the value of TRUE or FALSE. SINGLESTEP Set by the batch server. Allows the phase to pause at each location. Can have the value of TRUE or FALSE.
Example
PREMIX_A.L101
PREMIX.LEVEL
XFR_OUT_1:1.FAILURE = 0
XFR_OUT_1:1.OWNERID = PROGRAM
XFR_OUT_1:1.PAUSE = TRUE
XFR_OUT_1:1.PAUSED = FALSE
XFR_OUT_1:1.SINGLESTEP= TRUE
339
Transition Identifiers STATE Legal STATE identifiers are: ABORTING, HOLDING, STOPPING, STARTING, RESTARTING, RUNNING, HELD, COMPLETE, STOPPED, ABORTED, IDLE, and READY. STEPINDEX An integer which represents the current step index of the active phase. <step name>.<report parameter> If the step represents a phase, it may have report parameters. Report parameters contain values of tags written from a PCD/phase to FactoryTalk Batch. <step name>.<recipe formula parameter> Recipe formula parameters for a step contain the values for the recipe level or phase represented by the step. <recipe formula parameters> Each level of the recipe may have recipe formula parameters. The values for these parameters may be found in higher levels of the recipe.
Example
XFR_OUT_1:1.STATE = COMPLETE
XFR_OUT_1:1.STEPINDEX= 10
XFR_OUT_1:1.AMOUNT_TRANSFERRED
XFR_OUT_1:1.AMOUNT_TO_TRANSFER
AMOUNT_TO_TRANSFER
Transition operators
Transition expressions support the following operators. The precedence of the execution is depicted from highest to lowest. An operator with a higher precedence will be executed before an operator of lower precedence.
Transition Operator () NOT, unary minus *, /, AND +, -, OR <, <=, >, >= =, < > Description Expressions within parentheses are evaluated before expressions outside of parentheses. Logical NOT user, and -. Multiplication, division, and logical AND. Addition, subtraction, and logical OR. Less than, less than or equal to, greater than, and greater than or equal to. Equal to, and not equal to.
340
Functions are used to determine how the expression parser handles Real and Integer data types used in a parameter expression. The following tables lists available functions and their behavior on positive and negative values:
Function RND( ) Description Behavior Result 7 7 6 -7 -6 -6 Result 7 7 7 -6 -6 -6 Result 6 6 6 -6 -6 -6 Result 6 6.7 6 6.7 Result 1 Round Numeric values will be rounded to the nearest Value integer. 6.7 6.5 6.3 -6.7 -6.5 -6.3 RDUP( ) Round up Numeric values will be rounded to the next Value larger integer. 6.7 6.5 6.3 -6.7 -6.5 -6.3 TRNC( ) Truncate Retains only the integer portion of the numeric value. Value 6.7 6.5 6.3 -6.7 -6.5 -6.3 ABS( ) Absolute Numeric values will be expressed as positive values. For example, if the Real or Integer is 6.7, there is no effect. If the Real or Integer is -6.7, it is multiplied by -1 and will be expressed as 6.7. Value 6 6.7 -6 -6.7 MOD( ) Modulo Returns the modulo, or remainder, of a division. (Integers only) Value 7 MOD 6
Data types
The data types supported are integer, real, string and enumeration. The following are data type examples: Integer: 423 Real: 423.123456789012
341
String: The string constant is in quotes: OKAY. Enumeration: As a string, the enumeration constant is in quotes: Butter Pecan. As an integer, the ordinal for the enumeration may be: 4.
If you want the result of the expression to be an Integer, the values used to build the expression must be Integers a Real is not compatible with an Integer. However, using division in an expression always results in the resulting value being presented as Real number.
Element linking
Sequential function charts must follow a step-transition-step pattern to be valid; a step must be linked to a transition and a transition linked to a step. Recipe elements can be linked to form a simple sequence (step-transition-step), or take any of the following paths:
SFC Example Description Decision logic (OR path) allows an SFC to flow in one direction or another depending on the choice made by the transition statement. A single horizontal line connects the two statements. The decision construct of an SFC is created by selecting two parallel steps and connecting them to the step above them with two separate transitions. If parallel steps require the same dedicated resource, the FactoryTalk Batch Server automatically determines how the resources are allocated among steps when the batch is run. This is called subarbitration. If parallel steps occur just after an AND divergence or just before an AND convergence, you must add null procedures to the recipe in order for batches to run successfully. (See Subarbitration for more information.)
342
Parallel logic (AND path) allows more than one step to be active concurrently. A double horizontal line connects the two statements. The parallel construct of an SFC is created by selecting one transition and connecting it to two parallel steps. The double lines of a parallel structure do not count as either a step or a transition. SFC Example Description Loop logic (REPEAT path) allows a process to flow from beginning to end and back again to a previous step where it repeats the loop. The loop construct of an SFC is created by joining a transition to a previous step. The single lines of a decision branch do not count as either a step or a transition.
To create a material rebinding loop, select a material-enabled step and then click the Create Material Loop tool on the toolbar. The system automatically includes a null procedure in the material loop for rebinding. (See Creating material loops for more information.)
SFC limitations
The FactoryTalk Batch Recipe Editor is designed to build SFCs of any size. However, for ease in working with very large procedures, it is recommended that you divide them into multiple procedures, each with fewer steps.
Transition expressions
The maximum length of a transition expression is 1023 characters. You may need to reorganize the parallel steps in your recipe if your transition expression exceeds this limit. (See Transition expressions for more information.)
343
SFC execution
Step 1 Upon activation of this recipe, the initial step is active (as indicated by the color of the step). Step 2 Control is passed to Step A after Transition 1 becomes true.
Step 3 After Transition 2 becomes true, Step A is deactivated and Steps B and C become active.
Step 4 After Transition 3 becomes true, Step B is deactivated and Step D is activated.
Step 5
Step 6
344
When Transition 4 becomes true, Steps C and D are deactivated and Step E is activated.
When Transition 5 becomes true, Step E is deactivated and the final step is activated. This indicates that the entire recipe is complete.
Null procedures
When building complex recipes, it is sometimes necessary to use null procedures. A null procedure contains no parameters and is not associated with an equipment module on the plant floor. Using null procedures allows you to follow the step-transition-step pattern in a sequential function chart and enables the SFC to do more flexible arbitration. This enables you to create otherwise impossible SFC structures, such as separating consecutive transitions. You can add null procedures at the unit procedure, operation, and phase levels. Null procedures are automatically provided in the Unit Procedure Select, Operation Select, and Select Phase dialog boxes; you do not need to create null phases in the FactoryTalk Batch Equipment Editor.
345
transition condition that allows the CHARGE_B_CLS:1 step to execute only after the CHARGE_A_CLS:1 step has charged 1500 liters.
Arbitration
Null procedures can be used to regulate the arbitration of resources. A step cannot release any allocated resources it owns until the transition following the step becomes true. When this step is part of a parallel structure, a delay in releasing allocated resources may occur while the step waits for the other steps within the parallel structure to complete. Similarly, if the step is a shared phase, the phase will not be released until the other parallel steps have completed. The following picture illustrates the arbitration problem that can occur in a parallel SFC structure. If the AGITATE_PM_CLS:1 step is a shared phase, it will not be released until both CHARGE_B_CLS:1 and HEAT_CLS:1 have completed. Similarly, if AGITATE_PM_CLS:1 has acquired any shared resources, those resources are not released until all steps within the parallel structure are complete. Any other procedures waiting for
346
resources owned by AGITATE_PM_CLS:1 are forced to wait for those resources, even though the resources may be available.
The following picture illustrates the same parallel structure, using a null procedure to correct the delay. The null phase is inserted below the AGITATE_PM_CLS:1 step, allowing a transition above the null phase. This transition allows the AGITATE_PM_ CLS:1 step to complete, even if other phases within the parallel structure have not, thereby releasing the phase if it is shared, and/or releasing any shared resources.
Subarbitration
Through the process of subarbitration, the FactoryTalk Batch Server determines how dedicated resources within a recipe procedure should be allocated when there are common resources being requested at the same time. This can occur when you have a recipe with a parallel structure, in which the parallel steps require the same dedicated resource. If the
347
parallel steps occur just after an AND Divergence or just before an AND Convergence, you must add null procedures in order to run batches successfully. The following picture shows an AND Divergence of two parallel steps requesting the same resource. This structure will result in the batch being HELD until the conflict is resolved and the errors are cleared. Since both steps are requesting the same dedicated resource at exactly the same time, it cannot be released to either one of them.
The following picture shows the same parallel structure with the addition of two null phases after the AND Divergence. This changes the timing just enough to allow one side to process before the other. The batch server can then sub-arbitrate the resources required for ADD_CREAM:1 and ADD_CREAM:2.
The following picture shows an AND Convergence of two parallel steps requesting the same dedicated resource. In this case, the recipe appears to continue running, but the
348
AGITATE:1 step will not release its resource, preventing the AGITATE:2 step from acquiring the resource. The batch will not progress to the convergence transition.
The following picture shows the same parallel structure with the addition of two null procedures before the AND Convergence. The Server can then release the resources and transition past the convergence.
349
and is always available in the Unit Procedure Select, Operation Select, and Select Phase dialog boxes. (See Defining a step for more information.)
Timer steps
Timer steps can be used to create a step that causes a branch in a recipe to pause for a specified period of time, or to create a step that monitors the amount of time a parallel step executes. The $TIMER option is provided by the system and is always available in the Unit Procedure Select, Operation Select, and Select Phase dialog boxes. (See Inserting timer steps for more information.) There are two TIMER types have the following parameters and reports (see Configuring Parameters for more information):
Timer Type COUNT_DOWN Parameters
Reports
TIMER_TYPE HOLD_BEHAVIOR (CONTINUE, RETENTIVE, and RESET) SETPOINT TIMER_TYPE HOLD_BEHAVIOR (CONTINUE, RETENTIVE, and RESET)
ELAPSED_TIME REMAINING_TIME
COUNT_UP
ELAPSED_TIME
If the Timer is configured as CONTINUE, the Timer step will continue timing using the initial start time while in the HELD state. The Timer procedure accumulates time in both the RUNNING and HELD states based on the time it was initially started. If the Timer is configured as RESET, the Timer step is set to restart timing from 0. If the Timer is configured as RETENTIVE, upon entering the RUNNING state the timer will continue timing from the last known ELAPSED_TIME value from when the timer went into HELD.
350
Once completing these actions the Timer procedure will transition to the RUNNING state. If the Timer procedure cannot determine what type of hold behavior has been configured an error will be generated, causing the recipe to hold based on the configured hold propagation
Recipe comments
Recipe comments provide an additional communication method that ties directly to a step, transition, or entire recipe. Comments generated are viewable during both the recipe design phase and run time enabling the recipe author to enter notes and/or necessary information for other recipe users. (See Building a Sequential Function Chart for more information.)
351
352
CHAPTER 3
Step sequence
The rows of the Table view are numbered sequentially, starting with one, from top to bottom. Steps are executed starting with row one, and proceeding downward until the end of the recipe. Steps located within a single parallel structure are executed at the same time.
353
Recipe structure
The Table view provides a graphical representation of the recipes structure in the form of a structure icon located to the left of the steps name. The Table view is only capable of displaying the graphical recipe structure for simple recipes. Simple recipes are recipes that do not have complex recipe structures such as loops and branches, and only have simple parallel structures. When complex recipe structures are viewed in the Table view, no structure icon is provided. The Table view can contain any of the following recipe structure icons:
Description Simple Step: Represents a single step within the recipe path. Begin Parallel Step: Represents the first step in a parallel structure containing multiple steps. Parallel Step: Represents the step located within a parallel structure containing multiple steps. End Parallel Step: Represents the final step in a parallel structure containing multiple steps.
Step name
Every step within the Table view displays the name of the Procedure, Unit Procedure, Operation, or Phase represented by the step.
Step parameters
All parameters associated with the step are displayed as the column header when the step is selected. A parameter's value is displayed below the parameter name and to the right of the step name. To edit parameter values, select the table cell where the parameter is displayed and enter a new value (if enumerations have been created for the selected parameter, a list containing the enumerations will be provided).
354
If parallel steps require the same dedicated resource, the batch server automatically determines how the resources are allocated among steps when the batch is run. This is called subarbitration. If parallel steps occur just after an AND divergence or just before an AND convergence, you must add null procedures to the recipe in order for batches to run successfully. (See Subarbitration for more information.)
355
356
CHAPTER 4
Creating a Recipe
Before building an SFC or Table structure to define the logical flow of a recipe, you must first create the recipe. The recipe creation process includes determining the recipe level, specifying unit requirements, defining recipe formula parameters, and entering recipe header data.
Procedure levels
The first step in creating a new recipe is determining the level of the procedure. A batch recipe may consist of up to four procedure levels. These levels follow the S88.01 Procedural Model: Procedure Unit Procedure Operation Phase
Procedure Unit Procedure (UP_B) Operation (OP_B) PHASE_A UP_A UP_B OP_B PHASE_B
Procedure-level recipes contain steps called unit procedures. Unit procedure-level recipes contain steps called operations. Operation-level recipes contain steps called phases. Because of this hierarchical structure of the S88.01 Procedural Model, you must plan recipes from the top down, but build recipes from the bottom up. First you create the operation, then you create the unit procedure, and lastly you create the procedure. If a recipe is run as a single unit (no unit-to-unit transfers are involved), then building a recipe as an operation may be adequate. However, if the recipe is intended to operate across multiple units, a procedure must be created containing a unit procedure for each unit involved. Each unit procedure may consist of one or more operations. To begin, you must have a good definition of what the recipe needs to do, then decide what process levels are needed. Start by building the operations and configuring the phases. Add the operations to the unit procedures, then add the unit procedures to the top-level procedure.
Every unit procedure must have at least one operation, and every procedure must have at least one unit procedure.
357
Unit requirements
When initially building a recipe, you define two things:
The procedure level: procedure, unit procedure, or operation. The recipes unit requirements.
To properly define the recipe's requirements, you need a good understanding of the area model, the equipment classes, and the actual equipment required for the recipes execution. If your phases are material-enabled, you also need to know what materials and containers are needed for your recipe. Prior to creating a recipe, you need to decide if the recipe is unit-based, class-based, or a combination of the two. If Dynamic Unit Allocation is enabled and the recipe is a procedure containing some or all class-based unit procedure and operation level recipes, you also need to choose a unit allocation method. (See Dynamic unit allocation for more information.)
Unit-based recipes
A unit-based recipe includes information regarding the specific unit(s) to be used for the recipe, and is required at the time the recipe is authored. Unit-based recipes use static binding and are bound to a specific unit instance defined in the area model. Unit-based recipes include information regarding the specific unit instance(s) to be used for the recipe. Unit instances are defined in the area model. When the recipe is created in the Recipe Editor, the recipe author specifies which specific unit instance the recipe requires. As a result, unit-based recipes use a binding method called static binding. Static binding means that the recipe can run in only one specific unit instance. At batch creation time, unit-based recipes are automatically bound by the batch server to the specified unit instance.
4 Creating a Recipe
started, depending on the selected unit allocation method. (See Dynamic unit allocation for more information.)
Material-based recipes
Material-based recipes contain steps that specify the materials needed to run the recipe without requiring a definition of the equipment that will be required to supply those materials. Material additions and distributions are configured on each equipment module in the FactoryTalk Batch Equipment Editor. By using material-based recipes, unit classes, and the FactoryTalk Batch Material Editor, you can drastically reduce the number of different recipes you need to create.
359
sections refer to the example procedure-level PREMIX recipe shown below to explain how Dynamic Unit Allocation works:
Binding methods
The following four binding methods are options for class-based unit procedures:
At Batch Creation - The operator defines the units when the batch is created. This is similar to what would occur if Dynamic Unit Allocation was not enabled.
360
4 Creating a Recipe
First Available - The batch server assigns the unit for binding when the unit procedure is ready to run (batch server-defined late binding).
Once the unit has been bound using the First Available binding method, the batch server performs an ascending sort based on the Equipment ID number and selects equipment meeting the criteria with the smallest ID number. For further information see Configuring General Information in the FactoryTalk Batch Equipment Editor Users Guide.
Prompt - The operator is prompted to assign the unit for binding when the unit procedure is ready to run (operator-defined late binding). Operator Choice - When the batch is created, the operator can choose the unit binding methods: At Batch Creation, First Available, or Prompt.
PREMIX_A XFR_UP1_PREMIX
Additionally, there are five unit instances of the PREMIX_A_CLS unit class and both unit procedures, PREMIX_A and XFR_UP1_PREMIX, that can bind to any of the five unit instances, but they must both bind to the same unit instance. If the selected binding method is First Available, you must define a unit requirement name for both unit procedures, so the Batch Server can bind both unit procedures to the same unit instance. For example, in the sample recipe, the recipe author must assign the same unit requirement name to both unit procedures PREMIX_A and XFR_UP1_PREMIX. This same unit requirement identifies to the batch server that whatever unit instance it binds to unit procedure PREMIX_A, it must also bind to unit procedure XFR_UP1_PREMIX. If implementing Unit Attribute Binding, the recipe author can further define the binding requirements and preferences by configuring binding to units meeting specific criteria, such as warmest available unit, capacity restrictions, non-agitator units, etc. A procedure-level recipe can contain a mix of class-based unit procedures and unitspecific unit procedures. If Dynamic Unit Allocation is enabled, all unit procedures use a unit requirement name, even those that are unit-specific. Therefore, you must also assign a unit requirement name to a unit instance (rather than to a unit class) and define the binding method as Static. Static binding means that any unit procedure steps must always be bound to the specific unit identified for this unit requirement name.
361
Link the units in the area model (using FactoryTalk Batch Equipment Editor) Define downstream unit requirements in the recipe (using FactoryTalk Batch Recipe Editor)
When these configurations are in place, the batch server will then enforce these flow paths when binding units to a class-based unit procedure or when displaying a unit selection list to the operator for unit binding.
Opening a recipe
You can open existing recipes for viewing and editing from within the Recipe Editor. You can open entire recipe procedures, as well as individual operations or unit procedures. 1. From the File menu, select Open Top Level or click the Open button.
2. From the List Recipes of Type list, select All Procedures, Operation, Unit Procedure, or Procedure.
362
4 Creating a Recipe
You can use the List Recipes of Type selection to filter available recipes by Operation, Unit Procedure, Procedure, or All Procedures. You can also filter available recipes according to unit requirements by selecting All, Unit Class, or Unit from the Equipment area, or by selecting a specific unit from the equipment list. 3. From the Equipment area, select All to view all equipment classes, or select Unit Class or Unit, and then select the appropriate unit class or unit from the list. 4. From the Recipe Name list, double-click the recipe to open, or select the appropriate recipe and click Open.
3. Select either the Class Based or Instance Based unit requirement, and the corresponding group box is enabled. The Class Based group box displays the unit classes defined in the area model as class-based. The Instance Based group box displays the unit instances defined in the area model as unit-based. If Dynamic Unit Allocation is supported, the Bind Requirements and Bind Preferences buttons are enabled. (For further information regarding Binding Requirements and Binding Preferences, see Creating binding requirements on page 368.) 4. Choose either a Unit Class or Unit from the appropriate drop-down box. 5. Click OK to return to the Procedure View pane, which shows the default procedure name (UNIT_PROCEDURE# or OPERATION#) on the title bar. The SFC view contains the initial and final steps of the sequential function chart, and the Table view
363
contains a blank table header. (See Inserting steps into an SFC for more information.)
Creating a procedure
At the time a procedure is created, you must indicate all unit instances and/or unit classes that will be used within the procedure. If the Support Dynamic Unit Allocation option is enabled in the Options dialog box, each unit/unit class must have a unit requirement name assigned when used in a procedure. Selecting Dynamic Unit Allocation allows you to use
364
4 Creating a Recipe
different unit procedures with the same unit requirements within the procedure. Finally, you can define any downstream units required by units and/or unit classes. (See Dynamic unit allocation for more information.) The unit requirement name is simply a label and acts as a lookup table for the Batch Server. When a recipe is put on the Batch List and the server encounters the unit requirement name, it will look up all the unit classes (or unit instances) that are mapped to the unit requirement name. For example, your plant has two mixers that can be used to run one recipe. When you run the recipe, the operator or the Batch Server (depending on the binding method) must pick which mixer to use. In your area model, these mixers are each assigned a unit instance (MIXER_1 and MIXER_2) from the same unit class (MIXER). In the recipe, you create an unit requirement name (MIXERS) that is configured to the MIXER unit class, with the binding method at batch creation. When the recipe is put on the Batch List, the Batch Server encounters the label MIXERS, which tells it that piece of equipment is required for this recipe. The server looks for all the unit instances of the unit class defined with this unit requirement name and prompts the operator to select either MIXER_1 or MIXER_2. Any unit procedure, including its subordinate operation(s), mapped to this unit requirement name will use the specified unit class and the associated binding method. Because recipes using dynamic unit allocation require that all unit procedures use a unit requirement name, you must also assign a unit requirement name to all instance-based unit procedures and define the binding method used as Static. 1. From the File menu, select New Top Level, or click the New button. 2. Select Procedure and click OK. The Procedure-Unit Requirements dialog box opens. (This dialog box opens only if Support Dynamic Unit Allocation is enabled.)
365
3. Click the Add Unit Requirement button. The Add Unit Requirement dialog box opens.
4. Type a unique name in the Name box. The name can contain alphanumeric characters (A-Z, 0-9), an underscore (_), or a colon ( ; ), but it must begin with an alphanumeric character. Any unit procedure mapped to this unit requirement name will use the same unit to which this unit requirement name is bound. You can bind the unit requirement name to the unit class or to a unit instance. 5. Select the Class Based or Instance Based radio button to enable the corresponding group box. 6. Select the required unit class or unit from the appropriate dropdown list. 7. If you are adding Class Based requirements, select the appropriate binding method from the Binding Method list. 8. If needed, add applicable Bind Requirements and/or Bind Preferences. (See Creating binding requirements and Creating binding preferences for further information.) 9. In the Available Downstream Unit Requirements list, select the unit requirement name for the unit that is downstream from the unit requirement being defined and click the right arrow button. The unit requirement is added to the Selected Downstream Unit Requirements list.
Downstream Unit Requirements can be specified only after all additional unit requirements have been specified. The list box contains the unit requirement names for all available units that have been defined in the Procedure-Unit Requirements dialog box (except the one currently being defined). To return all selected downstream units to the available downstream units, click the Remove All button.
366
4 Creating a Recipe
10. Click OK to return to the Procedure-Unit Requirements dialog box. 11. Repeat steps 3 through 9 to define additional unit requirements for this procedure. 12. Click Close in the Procedure-Unit Requirements dialog box to return to the Procedure View pane which now shows the default procedure name on the Recipe Editor title bar. The SFC view contains the initial and the final steps of the sequential function chart, and the Table view contains a blank table header.
6. To delete an existing unit requirement, select the row containing the unit requirement and click the Delete Unit Requirement button. If the procedure has any steps that are defined using this unit requirement, a message displays stating that the requirement cannot be deleted. In this case, all steps defined against the unit requirement need to be deleted first. Deletion of a unit requirement removes the unit from any downstream lists in which it was referenced.
367
Smart binding
In addition to late binding, smart binding, also referred to as unit attribute binding, further enhances Dynamic Unit Allocation by allowing custom, user-defined binding requirements and binding preferences. With smart binding, you can specify a binding requirement like The unit must be in service, and a binding preference like I want the mixer to have been cleaned less than 3 days ago. Custom unit attributes like VESSEL_STATUS are configured in the FactoryTalk Batch Equipment Editor. The recipe author then configures binding requirements and binding preferences based on those custom attributes in the Recipe Editor.
Expression Used to reference Unit Attributes assigned to the Unit Class associated with the Unit Requirement. Expression objects can also reference Recipe Header values such as BATCH_SIZE, output parameters on the parent recipe, and report and formula parameters on the peer steps within the recipe. Require Phase Used when a Unit Requirement must be bound to a Unit that supports a specified recipe phase. Reject Phase Used when a Unit Requirement must be bound to a Unit that does not support a specified recipe phase. This requirement prevents recipes from using units with unneeded capabilities. Require Attribute Used when a Unit Requirement must be bound to a Unit that supports a specified Unit Attribute. It is a demand for a Unit that provides an attribute tag for support of the specified unit attribute. Reject Attribute Used when a Unit Requirement must be bound to a unit that does not support a specified Unit Attribute. This requirement prevents recipes from using units with unneeded attributes.
Configuring binding requirements Once the appropriate custom Unit Attribute definitions, assignments, and configurations have been completed in the FactoryTalk Batch Equipment Editor (see Adding a Unit Attribute in the FactoryTalk Batch Equipment Editor Users Guide for further information) the bind requirements are defined in the FactoryTalk Batch Recipe Editor. 1. Open a new or existing unit procedure or operation recipe.
368
4 Creating a Recipe
2. From the Recipe menu, select Unit Requirements. The Unit Requirement dialog box opens. 3. Click the Bind Requirements button. The Bind Requirements for Unit Requirement:[CLASS_NAME] dialog box opens.
Any global unit attributes are listed automatically and are view-only. Global unit attributes are configured in the FactoryTalk Batch Equipment Editor.
4. Click the Add Requirement button. A row is added containing the unit procedure/ operation name and drop-down boxes for the bind Type and Description. 5. Configure the Type and Description columns with the applicable bind requirements.
The Description field changes based on the Type selected. If the Type is an Expression, click the browse button to open the Unit Binding Expression Builder. (See Creating binding expressions for more information.)
unit class associated with the Unit Requirement. Expression objects can also reference Recipe Header values such as BATCH_SIZE.
Legal bind targets for which the expression evaluates to a lower value will be considered more preferred bind targets than those for which the expression evaluates to a higher value.
Legal bind targets for which the expression evaluates to a higher value will be
369
considered more preferred bind targets than those for which the expression evaluates to a lower value.
Prefer Phase Used as a recipe phase inclusion for bind preferences. The preferred unit supports the specified phase. Avoid Phase Used as a recipe phase exclusion for bind preferences. The preferred unit does not support the specified phase. Prefer Attribute Used as a recipe phase inclusion, it is a request for a Unit that provides an attribute tag for support of the specified unit attribute. Avoid Attribute Used as a recipe phase exclusion, it is a request for a Unit that lacks support for the specified recipe phase.
Configuring binding preferences 1. Open a new or existing unit procedure or operation recipe. 2. From the Recipe menu, select Unit Requirements. The Unit Requirement dialog box opens. 3. Click the Bind Preferences button. The Bind Preferences for Unit Requirement:[CLASS_NAME] dialog box opens. 4. Click the Add Preference button. A row is added containing the unit procedure/ operation name and drop-down boxes for the Bind Type and Description. 5. Configure the Type and Description columns with the applicable bind requirements.
The Description field changes based on the Type selected. If the Type is an Expression, click the browse button to open the Unit Binding Expression Builder. (See Creating binding expressions for more information.)
370
4 Creating a Recipe
2. From the Type list, select the type of expression, and then click the browse button to the right of the Description field. The Unit Binding Expression Builder dialog box opens.
Bind requirement and preference expressions can reference items that are unit class attributes or a recipe procedures recipe header fields and step parameters.
3. From the tree view in the left pane, select the value type on which you will be building the expression, unit attributes or recipe header or step parameters. The example shown is based on unit attributes. 4. From the middle pane, select the operand to be used for the expression. The example shown lists operands like CAPACITY and GLASS_LINED. 5. Click an operator button to enter the desired operation into the expression. You can also type this directly into the Expression text box. The example uses the greater than or equal to operator. 6. If the operand is an Enumeration, double-click the value in the right pane to add it to the expression in the text box, otherwise type the desired value directly into the expression.
For a detailed description of the available expression types, operators, and operands, please see Using Bind Expressions.
371
7. Click OK to save and validate the expression, and then return to the dialog box from which the Expression Builder was opened. The new bind requirement or preference is listed, as shown here.
372
4 Creating a Recipe
Description Product or process description at the procedure level. You may want to indicate whether this is a class-based recipe, or any other distinguishing information about the procedure, according to your facilitys methodologies. A summary or outline of the procedures steps. When a final version of the recipe is complete and you are ready to produce batches from it, check this box. This option must be selected in order to place a batch on the batch list using this recipe. Displays the location and filename of the area model file against which the recipe was last verified. If you cannot see the entire path and filename, place the cursor in the field and use the right arrow key to scroll to the right. Displays the date and time the area model was last saved.
Displays the date and time the recipe was verified. If the recipe was never verified, this information is also displayed. The recipes filename.
2. Type the required data (Procedure Identifier, Version Number, and Author) in the Header Data dialog box. Information entered in the remaining fields is optional.
373
3. If you want to make this recipe available to batch operators, select the Released To Production check box. If this box is not selected, the recipe is not included in the clients recipe list. 4. Click OK to return to the Recipe Editor window.
After creating a new blank recipe, the recipe structure must be built by adding and configuring recipe steps and transitions. The recipe structure can be represented using either an SFC (sequential function chart), a table, or both. (See Building a Sequential Function Chart or Building a Table for more information.)
Saving recipes
After you have built the recipe and given it a unique name in the Recipe Header Data, save the recipe by clicking the Save button or selecting Save from the File menu. The recipe is saved in the location and format defined in the FactoryTalk Batch Equipment Editor Server Options dialog box. (See the FactoryTalk Batch Administrators Guide for more information.)
If you are storing recipes using binary files, the recipes are saved in separate files according to the recipe level:
Procedures are stored as .bpc files Unit Procedures are stored as .upc files Operations are stored as .uop files
If you are storing recipes using XML, the recipes are saved in separate files according to the recipe level:
Procedures are stored as .pxml files Unit Procedures are stored as .uxml files Operations are stored as .oxml files
If you are storing recipes using the SQL Server database format, recipes are stored in a single Microsoft SQL Server database (masterrecipes is the default database).
Copying recipes
You can copy recipes by using the Save As function. When a procedure level or unit procedure level recipe is selected and you use the Save As function, only the selected recipe level (procedure or unit procedure) is saved with a new name.
The lower levels (unit procedure, operation or phase) are not copied. Any changes you make to those lower levels are being made to the original version. You must perform a Save As on each of the lower level recipes if you do not want to modify the original versions.
In the following example, performing a Save As on the procedure level saves a new copy of that procedure only. The new procedure still points to the original unit procedures, operations and phases. If you change a parameter value on a phase in the copied recipe,
374
4 Creating a Recipe
that parameter value is also changed in the original recipe. The same applies to the operations and unit procedures; all changes affect the original recipe.
375
13. Export the renamed recipe back to the original recipe directory. 14. In the Equipment Editor, open the Server Options dialog box and change the Recipe Directory to point back to the original recipe directory. 15. Open the Recipe Editor. Your newly created recipe copies now appear.
376
CHAPTER 5
1. Using the Selection tool, select a step or transition that either precedes or follows the new step. 2. Click the Insert Step tool to insert a new step before the selected element, or click the Add Step tool to insert a new step after the selected element. A new UNDEFINED step is created on the SFC with a blue box outlined in a black dashed line. Additionally, the SFC structure is automatically rearranged to make room for the new elements. One of the following dialog boxes opens, based on the recipe level: Select Phase, Operation Select or Unit Procedure Select.
377
3. Make the appropriate selection and click OK, or click Cancel to close the Select dialog box and leave the step undefined. (See Defining a step for more information.)
4. Repeat Steps 1 through 3 until all of the required steps are placed on the SFC.
The word UNDEFINED displays inside the step until it is configured.
378
3. Select $TIMER from the dialog box and click OK. The Select Timer - TIMER dialog box opens.
4. Type a new name for the Timer step, select the Timer type (COUNT_DOWN or COUNT_UP), and then select the units of measure (seconds, minutes, hours, or days). Click OK. The new Timer step is inserted in the SFC.
If you added a COUNT_UP timer in parallel with existing steps, nothing new is added to the transition expression. However, if it is the only step then the transition defaults to TRUE.
5. You can now set parameter values for the Timer step. (See Assigning formula values to Timer steps for more information.)
2. Place the cursor in the desired location in the SFC view and click. The step is placed on the sequential function chart and is outlined in blue (indicated by the dashed lines) until another step is placed or another tool is selected. The step is then displayed in red until it has been configured. UNDEFINED is displayed inside the step until it is defined. (See Defining a step for further information.) 3. Repeat Step 2 until all of the required steps for the process are placed on the sequential function chart.
Procedure Select. Make the appropriate selection and click OK, or click Cancel to close the Select dialog box and leave the step undefined. (See Defining a step for more information.) The existing transition is modified to reflect the new step and the parallel structure.
380
The first set of steps after the AND Divergence, ADD_CREAM:1 and ADD_CREAM:2, require a set of null procedures before them so subarbitration can work. Without the null procedures, the batch would go into a HELD state before it reaches these steps. The batch server automatically subarbitrates for the second set, ADD_EGG:1 and ADD_EGG:2. The third set, AGITATE:1 and AGITATE:2, requires a set of null procedures before the AND Convergence so subarbitration can work. Without the null phases, the batch will appear as though it is still running, but it will never be able to transition past these steps to the Convergence.
1. Using the Selection tool, select the step on which the new branch structure is to border. 2. Click the Add Branch tool. A new step is created on the SFC and is outlined in blue (indicated by the dashed lines). A new transition is added preceding the new step, and a new transition is added following the new step. Additionally, the SFC structure is automatically rearranged to make room for the new elements. One of the following dialog boxes opens, based on the recipe level: Select Phase, Operation Select or Unit Procedure Select. Make the appropriate selection and click OK, or click Cancel to close the Select dialog box and leave the step undefined.
3. Once the step(s) have been added to the branch structure, define the new preceding and following transition expressions, if necessary. (See Assigning a transition expression for more information.)
381
Defining a step
When a step is added to an SFC, it is marked as UNDEFINED. Only valid lower level recipes may be used in the step definition. When a process for a step is selected, that process is assigned to that particular step in the recipe, and the step is marked with the name of the process. A step may be redefined at any time. However, you should be sure to update the steps transition accordingly. 1. Double-click an UNDEFINED step in the SFC. One of the following dialog boxes opens, based on the recipe level: Select Phase (step 2) for an operation-level recipe, Operation Select (step 3) for a unit procedure-level recipe, or Unit Procedure Select (step 4) for a procedure-level recipe. Go to the step noted to continue the step definition process.
Defining a phase
2. Select the phase to be represented by the step, and then click OK. The name of the selected phase is displayed with a number following the phase name. The number specifies the instance of this particular phase within the selected operation and is separated from the phase name by a colon.
Defining an operation
3. Select the operation name representing by step, and click OK. Or, select New Operation to create a new operation. (See Creating operations and unit procedures for instructions on creating a new operation.) The operation name displays with a number following it. The number specifies this particular operations instance within the selected unit procedure and is separated from the operation name by a colon.
382
383
2. Enter the expression for the transition condition or build an expression by selecting options from the three different sections. Press ENTER to continue the expression on the next line. 3. Click OK to return to the SFC View. 4. Repeat steps 1 through 3 as needed, until you have assigned conditions to each of the transitions on the SFC. (See Transition expressions for transition criteria information.)
384
set up your SFC with AND and OR convergences and divergences. For example, if you want three material equipment phases in parallel, you must create the three parallel recipe phases first, and add the material loop. 1. Using the Selection tool, select the material enabled step to which you want to add the loop. 2. Click the Create Material Loop tool. The material loop is added, including the two required null procedures. You can remove a material loop immediately after you add it, by clicking the Undo Material Loop button. The following example shows how a material loop appears when the material-enabled step is preceded and followed by a transition. Your material loop may look different and contain more than one null procedure if it is preceded and/or followed by a convergence and/or a divergence.
SFC after a material rebinding loop was added around the material-enabled step MBR_ADD:1
Recipe comments
You may find situations when giving written instructions to operators, sharing notes with other engineers, or easily accessing a reference when developing a recipe is necessary. Recipe commenting enables you to associate data with a step, transition, or the entire recipe and is viewable at design and run time. The comment and its associated information are called a text box. Above each text box the assigned reference name appears as a C followed by a number. Once a text box is added to an SFC, it can also be viewed in the SFC views of FactoryTalk Batch View, FactoryTalk eProcedure, and ActiveX Control.
385
3. Choose the Selection Tool, double-click inside the text box, and type the required information. When you finish entering the text, click outside the box. The text box resizes to accommodate the comment. Editing existing text is accomplished in the same manner.
The maximum number of characters contained in a text box is 1024. If more capacity is required for a recipe comment, additional text boxes can be added and associated with the step or transition.
386
1. Select the Link Tool, click inside the text box, and drag to the desired step/transition. Completing this step in reverse order is also an option.
2. Release the button, and the bottom portion of the text box displays the associated step or transition name.
A text box can only be associated with one step or transition. Linking a text box to a step or transition that is already associated to another element will result in assigning the most recently associated step/transition name.
To disassociate a recipe comment from a step or transition: 1. Select the Remove Link Tool, click inside the text box, and drag to the associated step or transition. This step can also be performed in reverse order with the same result. 2. The associated step name is removed from the text box and now associated with the entire recipe.
If a step or transition associated with a text box is deleted, the text box becomes associated with the entire recipe procedure and the association label will be blank.
387
388
CHAPTER 6
Building a Table
The creation of a table involves the addition and configuration of steps to the table structure. You add steps to the table, and then define the steps appropriately.
While in the Table view, the active step is highlighted in dark blue and Table is displayed on the status bar at the bottom of the screen when the Table view has focus. You may delete a selected step in the table by pressing the DELETE key.
1. Select the table row that either precedes or follows the new step. 2. Click the Insert Step tool to insert a new step before the selected row, or click the Add Step tool to insert a new step after the selected row. A new UNDEFINED step is created in the table and highlighted in dark blue. One of the following dialog boxes opens, based on the recipe level: Select Phase, Operation Select or Unit Procedure Select. 3. Make the appropriate selection and click OK, or click Cancel to close the Select dialog box and leave the step undefined. 4. Repeat steps 1 through 3 until all of the required process steps are placed in the table.
389
3. Make the appropriate selection and click OK, or click Cancel to close the Select dialog box and leave the step undefined.
For parallel steps that request the same resource, the FactoryTalk Batch Server determines how the resources are allocated through the subarbitration process. If parallel steps requiring the same resource occur just after an AND divergence or just before an AND convergence, you must add null procedures to the recipe in order for batches to run successfully. (See When parallel steps require the same dedicated resource for more information.)
4. Select the parallel step that will run after the new step. 5. Click the Add Step After Parallel tool. A new UNDEFINED step is created after the selected parallel step and highlighted in blue. One of the following dialog boxes opens, based on the recipe level: Select Phase, Operation Select or Unit Procedure Select. 6. Make the appropriate selection and click OK, or click Cancel to close the Select dialog box and leave the step undefined.
390
6 Building a Table
Defining a step
When a step is added to a table, it is marked as UNDEFINED. Only valid lower level recipes can be used in the step definition. When a process for a step is selected, that process is assigned to that particular step in the recipe, and the step is marked with the process name. A step can be redefined at any time. 1. Double-click a step marked as UNDEFINED in the table. One of the following dialog boxes opens, based on the recipe level: Select Phase (step 2), Operation Select (step 3), or Unit Procedure Select (step 4). Go to the step noted to continue the step definition process.
Defining a phase
2. Select the phase to be represented by the step, then click OK. The selected phase name, followed by a number, displays. The number specifies this particular phase instance within the selected operation and is separated from the phase name by a colon.
Defining an operation
3. Select the name of the operation that represents the step, then click OK. Or, select New Operation to create a new operation. (See Creating operations and unit procedures for more information.) The name of the operation, followed by a number, is displayed. The number specifies the instance of this particular operation within the selected unit procedure and is separated from the operation name by a colon.
391
392
CHAPTER 7
When you select Recipe Header, a list of recipe header parameters displays in the list view (in the middle), as shown below. The Recipe Header field names map to the same fields defined within a Recipe Header. When you select Unit Attributes, an alphabetic list of all global unit attributes existing within the area model displays in the list view. (See Creating a Global Unit Attribute in the Equipment Editor Users Guide for more information on global unit attributes.) You create or edit an expression by typing directly in the Expression Builder text box, selecting items in the list view and enumerations view, and/or selecting various operators. The Operator buttons of the Expression Builder are always enabled. When you click an Operator button the corresponding operator is inserted into the expression at the current cursor position and displayed in the Expression Builder text box. When the expression is complete, clicking the OK button validates and saves the expression and returns you to the Bind Requirements or Bind Preferences dialog box. There are three types of Bind Expressions: Boolean, Minimize, Maximize. Boolean expressions must evaluate to true or false. Minimize and maximize expressions evaluate to real or integer values.
393
Expression operators
Binding expressions support the following operators. The precedence of the execution is depicted from highest to lowest. An operator with a higher precedence will be executed before an operator of lower precedence.
Expression Operator () NOT, *, /, AND +, -, OR <, <=, >, >= =, < > Description Expressions within parentheses are evaluated before expressions outside of parentheses. Logical NOT, subtraction. Multiplication, division, and logical AND. Addition, subtraction, and logical OR. Less than, less than or equal to, greater than, and greater than or equal to. Equal to, and not equal to.
Functions are used to determine how the expression parser handles Real and Integer data types used in a parameter expression. The following tables lists available functions and their behavior on positive and negative values:
Function RND( ) Description Behavior Result 7 7 6 -7 -6 -6 Result 7 7 7 -6 -6 -6 Round Numeric values will be rounded to the nearest Value integer. 6.7 6.5 6.3 -6.7 -6.5 -6.3 RDUP( ) Round up Numeric values will be rounded to the next Value larger integer. 6.7 6.5 6.3 -6.7 -6.5 -6.3
394
Function TRNC( )
Description Truncate Retains only the integer portion of the numeric value.
Behavior Value 6.7 6.5 6.3 -6.7 -6.5 -6.3 Result 6 6 6 -6 -6 -6 Result 6 6.7 6 6.7 Result 1
ABS( )
Absolute Numeric values will be expressed as positive values. For example, if the Real or Integer is 6.7, there is no effect. If the Real or Integer is -6.7, it is multiplied by -1 and will be expressed as 6.7.
MOD( )
Data types
The data types supported are integer, real, string and enumeration. The following are data type examples: Integer: 423 Real: 423.123456789012 String: The string constant must be in quotes: READY. Enumeration: As a string, the enumeration constant must be in quotes: BUTTER_PECAN. As an integer, the ordinal for the enumeration may be: 4.
If you want the result of the expression to be an Integer, the values used to build the expression must be Integers a Real is not compatible with an Integer. However, using division in an expression always results in the resulting value being presented as Real number.
Operands
Operands used within a binding expression can reference Recipe Header data, Unit Attributes, and constants. The following table illustrates examples of allowable expression entities and the required syntax.
Expression Entity Recipe Header data Global Unit Attribute Constant Expression Syntax [Recipe Header item] Unit Attribute Name Example [VERSION_NUMBER] CAPACITY 100
395
Expression Validation
When you click OK, the expression is validated for consistency and syntactical correctness. If the defined expression validates successfully, the Expression Builder closes. If the expression is invalid then the location of where the first error was encountered is highlighted, and you will see a description of the error displayed in a message box, and the Expression Builder does not close. The following validation rules must be met:
An Expression must resolve to either TRUE or FALSE and meet the following criteria: An Expression must contain at least one operator (+ (addition), - (subtraction), * (multiplication), / (division), = (equals), > (greater than), < (less than), <= (less than, or equal to), >= (greater than, or equal to), <> (not equal to), Not, And, and Or.
Each entity (Recipe Header field, Global Unit Attribute, or constant) must be separated by an operator. The entities being operated on must evaluate to acceptable data types (String with a String; Integer with Integer or Real; Real with Integer or Real).
Maximum expression length must not exceed 1023characters. Duplicate expressions are allowed.
396
CHAPTER 8
Configuring Parameters
Within a recipe, there are two kinds of parameters:
Phase parameters
When recipe phases are added to an operation-level recipe, you must specify the formula values for its associated phase parameters. Recall that a recipe phase is linked to an equipment phase configured in the area model. The recipe phase parameters originate from the parameters defined in the FactoryTalk Batch Equipment Editor for the associated equipment phase. Therefore, the recipe phase formula value parameters are the phase parameters defined for the associated equipment phase in the area model. These parameters are used to pass data directly to the process connected device (PCD). You configure the phase parameter values in one of four ways:
Specified in the FactoryTalk Batch Recipe Editor for the recipe phase at recipecreation time Specified prior to the execution of the recipe phase in a running recipe after batch creation. (This is most often done with an operator prompt.) Specified as a parameter expression. Deferred to a recipe parameter allowing them to be defined at batch creation time. (See Recipe parameters for more information.)
Recipe parameters
Recipe parameters are parameters associated with the recipe as a whole, not a particular phase. They are created and defined in the FactoryTalk Batch Recipe Editor, are specific to the recipe, and may be defined for any recipe level: operation, unit procedure or procedure. The values of the highest level recipe parameters within a batch are defined at batch creation time. Recipe parameters serve two purposes:
They may be used in transition conditions They may be used to assign parameter values to lower level steps in a process called deferring.
Phase formula value parameter values may be deferred to the value of Operationlevel recipe parameters.
397
Operation-level recipe parameters may be deferred to the value of Unit Procedurelevel recipe parameters. Unit Procedure-level recipe parameters may be deferred to the value of Procedure-level recipe parameters.
Recipe parameters of unit procedures and operation steps can also use expressions to reference parent and peer step data (to calculate a value that other parameter expressions reference, for example).
Note: The grayed cells indicate that the function cannot be performed within the Recipe Editor.
The values of the highest level recipe parameters within a batch are defined at batch creation time. For example, assume the following:
A phase parameters value is deferred to an operation-level recipe parameter defined for its containing operation-level recipe The operation-level recipe parameters value is deferred to a unit-procedure-level recipe parameter defined for its containing unit procedure-level recipe
When a unit procedure-level recipe instance is created, the operator must define the value for the unit-procedure's recipe parameter at batch creation time since this is the batchs highest level recipe. The value the operator defines for the unit-procedures recipe parameter passes down to the operation-level recipe parameters value which then passes down to the phase parameters value at batch creation time. When the FactoryTalk Batch Server downloads parameters to the process-connected-device prior to starting the recipe phase, the phase parameters value is sent to the process-connected device. Deferring phase parameter values to recipe parameters allows the operator to define the recipe parameter value at batch creation time rather than waiting for the Server to initiate the phase within the recipe after batch creation time. This frees the operator from closely monitoring the running recipe for phase parameter value prompts that would not occur until the Server initiates the phase. Deferring phase parameters also allows third-party scheduling packages or other applications working through the Server API (such as the ActiveX Controls) to create batches and define the values of the corresponding recipe parameters for those batches at batch creation time.
398
8 Configuring Parameters
If control strategies are configured for the phase, the first item in the Parameter Values area is named CONTROL_STRATEGY and the Value column for this item will contain a list of configured control strategies. Because only the parameters and reports associated with the selected control strategy will be displayed, the appropriate control strategy should be selected before configuring parameters and report limits. When configuring parameters, the parameter values may be assigned as literal values or deferred to another parameter at a higher level in the recipe. If the step selected is a material-enabled phase, the Parameter Value Entry/Report Limit Entry dialog box will also contain the recipe parameters (MATERIAL and AMOUNT) and the report parameters (ACTUAL_ AMOUNT and FEED_COMPLETE) associated with material phases. It may also contain the optional material recipe parameters CONTAINER, LOT, LABEL, and MATERIAL_CLASS if the optional parameters were enabled in the FactoryTalk Batch Equipment Editor.
To enable the optional parameters in the FactoryTalk Batch Equipment Editor, doubleclick the phase to open the Edit Phase dialog box. On the Parameters tab, make sure the Add Optional Material Parameters box is checked.
399
The values of the MATERIAL, LOT and LABEL parameters are combined to create the material specification. The material specification is used to determine the container from which a material is drawn, or into which a material is distributed, when a batch is run. The material specification always contains a material name. Optionally, the specification can include a lot and/or a label.
400
8 Configuring Parameters
Origin
401
Item Value
Description The value that is to be assigned to this parameter. This is dependent on the selected Origin. For material-enabled phases: MATERIAL contains a list of materials retrieved from the material database. AMOUNT dependent on the selected Origin. May be set to a material amount if the Origin box is Value. The sign of this value specifies whether the phase is a material distribution (amount is negative) or a material addition (amount is positive or zero). The default value is zero.
Max
The maximum value for this parameter. This is determined when the phase parameter is defined in the area model or the recipe parameter is defined in the Recipe Editor. (view-only) Enumeration/Engineering Units. The engineering units associated with the parameter value. This is assigned when the phase parameter is defined in the area model or the recipe parameter is defined in the Recipe Editor. (viewonly) A check box that indicates if you want this parameter value displayed in the step in the SFC. Only one parameter may be displayed per step. The algorithm that specifies which policy and set of limits are used to verify the parameter value validity. There are four possible Verification Methods: High-High-High/Low-Low-Low, High-High, Low-Low, High-Low, and No Limits.The Verification Method is set in the Equipment Editor. (view-only) The Low-Low-Low limit value for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low/Low/ Low.) The Low-Low limit value for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low-Low-Low or High-High/Low-Low.) The Low limit value for the parameter (Real, Integer). (This field is disabled if the Verification Method is No Limits.) The High limit value for the parameter (Real, Integer). (This field is disabled if the Verification Method is No Limits.) The High-High limit value for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low-Low-Low or High-High/Low-Low.) The High-High-High limit value for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low/Low/ Low.) Specifies the method used to bind the material-enabled phase to a container. Automatic: The batch server will select the appropriate container based upon the container associations configured in the area model and the material specification. Prompt: The operator is prompted to choose the container and equipment module to which the phase is to be bound.
Enum/EU
LLL
LL
L H HH
HHH
402
8 Configuring Parameters
Description The selection available is dependent upon the phases parameter values defined in the area model. If the phase is an addition (material is added to a recipe), Addition is selected and cannot be edited. If the phase is a distribution (material is added to inventory), Distribution is selected and cannot be edited. If the phase is configured as both, you must specify the material feed type associated with this step. The Max and Min values will adjust accordingly.
Many aspects of recipe configuration are dependent upon accessing data from the material database using the FactoryTalk Batch Material Server. If the Material Server is not available, the MATERIALS, CONTAINERS, and MATERIAL CLASS enumeration sets are recreated with the NULL_MATERIAL, NULL_CONTAINER, and NULL_CLASS, respectively. You must reconfigure the materials after the server becomes available. Report Limits area Name ID Type Accumulate Verification Method Limit Calculation The parameter name. (view only) The number, unique to the phase, that identifies this parameter. (view only) The parameter data type. Valid types include: Real, Integer, Enumeration, and String. (view only) Displays the type of accumulation for the report as defined in the phase class in the area model. (view only) The type of verification method used for the parameter. This method sets the limits and policies for verifying report values (view-only). The equation type used to calculate the limit. There are three ways to calculate this limit: Absolute: Absolute value for the parameter. Percentage: Target Parameter + (Target Parameter * Percentage) Relative: Target Parameter + Value (view-only) Target Parameter LLL LL The recipe parameter used in calculating the limit when the Limit Calculation is Percent or Relative. (view-only) The low-low-low limit for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low/Low/Low.) The low-low limit for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low-Low-Low or High-High/Low-Low.) The low limit for the parameter (Real, Integer). (This field is disabled if the Verification Method is No Limits.) The high limit for the parameter (Real, Integer). (This field is disabled if the Verification Method is No Limits.)
L H
403
Item HH
Description The high-high limit for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low-Low-Low or High-High/Low-Low.) The High-High-High limit for the parameter (Real, Integer). (This field is only enabled if the Verification Method is High-High-High/Low/Low/Low.) The engineering units associated with the parameter, such as Degrees F or Kilograms. (view only)
HHH EU
3. If the step is a phase for which control strategies have been defined, select the appropriate control strategy from the Value list in the row named CONTROL_STRATEGY. Only parameters and reports associated with the selected control strategy are displayed. 4. For each formula parameter, select the appropriate origin from the Origin list. (If the step is a phase, the list will include Operator.) 5. In the Value field, type a value for each parameter. (See Step formula values and phase report limits for more information.)
404
8 Configuring Parameters
6. If the data Type is Enumeration, select an enumeration from the Value list based on the selected origin.
The list of enumerations displays in alphabetical order and is configured in the area model.
7. Select Display to display the step formula value for this parameter in the SFC view step (step formula values are always displayed in the Table view). 8. If you want to change the default parameter deviation limit values defined for the phase in the area model, you can edit the limit values for this recipe in the LLL, LL, L, H, HH, and HHH fields. The values entered are used to determine deviation events at run time. (See Field definitions for parameter value entry/report limit entry for more information.) 9. If this is a material-enabled phase, select the type of binding in the Container Binding area. 10. If this is a material-enabled phase, and the parameter is configured for addition and distribution, specify the material feed type associated with this step in the Feed Type area. 11. In the Report Limits area, enter the report deviation limit values for this recipe in the LLL, LL, L, H, HH, and HHH fields. The values entered are used to determine deviations in a report value at run time. (See Field definitions for parameter value entry/report limit entry for more information.) 12. Click OK to return to the Recipe Editor window.
405
3. For the HOLD_BEHAVIOR formula parameter, select the appropriate origin from the Origin list. (If the step is a phase, the list will include Operator.)
The origin of the SETPOINT and HOLD_BEHAVIOR parameters of a COUNT_DOWN Timer can be set to OPERATOR, DEFER or the result of an EXPRESSION. When a COUNT_DOWN Timer parameter is set to OPERATOR the Batch Server will prompt the operator on start of the Timer step to supply a runtime value for the parameter. When a COUNT_DOWN Timer parameter is set to DEFER the Batch Server will look to the parent procedure (or upper level recipe) for the value as defined on the Recipe Formula Parameter List. There are three possible values for HOLD_BEHAVIOR: CONTINUE, RETENTIVE, and RESET. The default value is CONTINUE. (See Using Expressions in Parameters and Reports for more information.)
The origin of the HOLD_BEHAVIOR parameter of a COUNT_UP Timer can be set to OPERATOR, DEFER, or Expression. When a COUNT_UP Timer parameter is set to OPERATOR the Batch Server will prompt the operator on start of the COUNT_UP Timer step to supply a runtime value for the parameter. When a COUNT_UP Timer parameter is set to DEFER the Batch Server will look to the recipe parameter to supply the value for the step parameter. When the Origin is set to VALUE, at runtime the value for the parameter will come from the value specified in the Value column.
4. The second parameter displayed is SETPOINT. The SETPOINT determines how long the timer step will run. The default value for the SETPOINT parameter is the Default value configured for the SETPOINT parameter of the $TIMER system phase. The SETPOINT parameter is of the type Real. 5. The third parameter displayed is TIMER_TYPE. It is set to the enumeration value of COUNT_UP or COUNT_DOWN. All the fields of this parameter are disabled; you cannot change any of the default values. 6. Select the Display check box to display the parameter values on a timer step. You can display the SETPOINT, TIMER_TYPE, or HOLD_BEHAVIOR parameters. 7. Click OK to return to the Recipe Editor window.
Recipe properties
The Properties dialog box is used to configure parameters and reports for recipe procedures and steps. There are two tabs on the Properties dialog box Parameters and Reports.
Parameters
Recipe formula parameters are used to provide flexibility when creating recipes. Recipe parameters may be used in transition conditions or to substitute for lower-level phase or recipe parameters. A recipe parameter may be created for Operation, Unit Procedure or Procedure recipe levels.
406
8 Configuring Parameters
Operation recipe parameter values are assigned when the operation step is added to a unit procedure-level recipe or at batch creation if the operation is the highest level recipe for the batch. Unit procedure recipe parameter values are assigned when the unit procedure step is added to a procedure-level recipe or at batch creation if the unit procedure is the highest level recipe for the batch. Procedure-level recipe parameter values are always assigned at batch creation because this is the highest possible recipe level for the batch.
Assigning recipe formula parameters Recipe formula parameters are created on the Parameters tab of the Properties dialog box.
Scalable
ERP Alias
1. Click the Recipe Formula Parameters button, or select Recipe Formula from the Recipe menu. 2. On the Parameters tab, click Add Parameter to create a new recipe formula parameter. A new parameter row is added to the list of paramerters and is populated with default values. 3. Type the appropriate information in the fields. 4. Repeat steps 2 and 3 until all recipe formula parameters have been defined. 5. Click Apply to save your changes and stay on the Properties dialog box, click OK to save any changes and return to the FactoryTalk Batch Recipe Editor, or click Cancel to cancel the changes and close the dialog box. 6. To delete a recipe formula parameter, select the row to delete and click Delete. Click OK to save any changes and return to the Recipe Editor.
Reports
Report parameters can be used in transition conditions or to substitute for lower-level phase or recipe parameters. A report parameter may be created for Operation, Unit Procedure or Procedure recipe levels. Reports on operation, unit procedure, and procedure recipes can be used to accumulate data from their child steps to aid report generation activities. Report values are calculated and recorded in the batch event journal when the state of the procedure is Complete, Aborted, or Stopped. Assigning report parameters Report parameters are created on the Reports tab of the Properties dialog box.
Report Expression
408
8 Configuring Parameters
1. Click the Recipe Formula Parameters button, or select Recipe Formula from the Recipe menu. 2. On the Reports tab, click Add Report to create a new report parameter. A new row is added to the list of report parameters. 3. Enter a name for the report. 4. Select the data type from the list in the Type column, and enter the appropriate engineering units in the Enum/EU column. If the Type is Enumeration, select an enumeration from the Enum/EU list. 5. Click the browse button next to the Report Expression box. The Report Expression Builder opens.
6. Create the desired expression to be used as the report value, and then click OK to save the enter the expression into the Report Expression box. (See Configuring expression values in recipe and report parameters for more information.)
7. Repeat steps 2 through 6 until all reports have been defined. 8. Click Apply to save your changes and stay on the Properties dialog box, click OK to save any changes and return to the FactoryTalk Batch Recipe Editor, or click Cancel to cancel the changes and close the dialog box. 9. To delete a report, select the row to delete and click Delete. Click OK to save any changes and return to the Recipe Editor.
410
CHAPTER 9
A download request to a controller will cause the requesting equipment phase to automatically become HELD.
411
A transition expression references the BAD_VALUE parameter will itself evaluate to BAD_VALUE which will prevent the transition from firing. A binding expression references the BAD_VALUE parameter will be unable to find binding candidates, so binding will be pending and the recipe's execution will not advance. An input parameter expression that references a parameter with a BAD_VALUE will evaluate its expression to BAD_VALUE.
There are two instances where you might legitimately want to change the value of a report expression: 1. A transition expression references the report parameter and its value is preventing the transition from firing. In this case, use the Force Transition function to force the transition to fire. (For more information on forcing a transition to fire, please refer to the FactoryTalk Batch View Users Guide or the FactoryTalk Batch ActiveX Controls Users Guide.)
412
2. A recipe parameter is dependent on a report parameter to provide its value. If the report parameter is incorrect or undesirable for some reason, there is cause to change it. In this case, use the Override function to change the recipe parameter's value instead. (For more information on overriding an expressions value, please refer to the FactoryTalk Batch View Users Guide or the FactoryTalk Batch ActiveX Controls Users Guide.)
The data types of the referenced parameters in the expression must be compatible. The data types real, integer, enumeration and string are supported (no string manipulation is allowed). The expression may only reference phase parameters and report parameters within a single operation.
For example, in a control system, the quantity of sugar added is a function of the quantity of water to be added by another phase. Configure a recipe parameter referencing the ADD_WATER report parameter of another phase and use an expression to calculate the amount of sugar to be added as the ADD_SUGAR formula parameter on this phase.
413
1. Click a step in either the SFC view or Table view. 2. Click the Value Entry button. The Parameter Value Entry/Report Limits Entry dialog box opens.
3. Select a recipe parameter or report. 4. Select Expression from the Origin list, and then click the browse button in the Value column. (If the step is a phase, the list will include Operator.) The Parameter Expression Builder opens.
5. From the tree view in the left pane, select the step containing the recipe or report parameter on which you will be building the expression. 6. From the right pane, double-click the recipe or report parameter to be used for the expression to copy it to the text box (or select it and click Paste). 7. Click an operator or function button to enter the desired operation or math function into the expression. You can also type this directly into the Expression text box. (See Expression operators or Parameter expression functions below for supported operators and functions.)
414
For this example, a value of 2 times the amount of milk added will be used for the amount of sugar to add:
8. Click OK to save and validate the expression, and then return to the Parameter Value Entry/Report Limits Entry dialog box. The report parameter expression is listed, as shown here.
9. Click OK to close the Parameter Value Entry/Report Limits Entry dialog box and validate the expression. In a running batch, the parameter expression is continuously evaluated. In the example used here, the calculation is made and the resulting value is used as the amount for the ADD_SUGAR phase, which in the example given above, would be 2 times the water added (50 KG) for a total amount of 100 KG of sugar.
Expression operators
Parameter expressions support the following operators. The precedence of the execution is depicted from highest to lowest. An operator with a higher precedence will be executed before an operator of lower precedence.
Operator () *, /, +, Description Expressions within parentheses are evaluated before expressions outside of parentheses. Multiplication, division Addition, subtraction
415
If you want the result of the expression to be an Integer, the values used to build the expression must be Integers a Real is not compatible with an Integer. However, using division in an expression always results in the resulting value being presented as Real number.
Parameter expression functions Functions are used to determine how the expression parser handles Real and Integer data types used in a parameter expression. The following tables lists available functions and their behavior on positive and negative values:
Function RND( ) Description Behavior Result 7 7 6 -7 -6 -6 Result 7 7 7 -6 -6 -6 Result 6 6 6 -6 -6 -6 Result 6 6.7 6 6.7 Result 1 Round Numeric values will be rounded to the nearest Value integer. 6.7 6.5 6.3 -6.7 -6.5 -6.3 Round up Numeric values will be rounded to the next Value larger integer. 6.7 6.5 6.3 -6.7 -6.5 -6.3 Truncate Retains only the integer portion of the numeric value. Value 6.7 6.5 6.3 -6.7 -6.5 -6.3 Value 6 6.7 -6 -6.7 Value 7 MOD 6
RDUP( )
TRNC( )
ABS( )
Absolute Numeric values will be expressed as positive values. For example, if the Real or Integer is 6.7, there is no effect. If the Real or Integer is -6.7, it is multiplied by -1 and will be expressed as 6.7.
MOD( )
416
CHAPTER 10
Synchronization For example, one phases running logic will not proceed until another phase is at a certain point within its own phase logic Permissives For example, one phase must pass a certain point in its phase logic before its partners can begin their phase logic Data Transfer For example, moving data from one phase to another
Phases that need to communicate with each other are called message partners. Message partners are then organized into link groups in the FactoryTalk Batch Recipe Editor. When a recipe containing message partner phases is on the Batch List, the link group definition informs the FactoryTalk Batch Server which phases need to communicate with each other. There are three programs involved in implementing message partners:
Equipment Editor defines the number of message partners for a phase class within the Area Model Recipe Editor defines the grouping of message partner phases into link groups Phase Logic where the actual communication between the phases occurs
Before you can define phase link groups you must first define the corresponding message partners in the area model. (See the FactoryTalk Batch Equipment Editor Users Guide for more information.)
A phase link group must contain the same number of phases as there are message partners plus one (the phase itself) configured in the area model for each of the phases that are included in the group. For example, if each phase in a phase link group is configured with three message partners, then there must be a total of four phases in the phase link group (each phase has three message partners plus itself). Message partners are configured in the Equipment Editor. The rules involving link groups are as follows:
Up to 200 link groups per recipe Up to 20 phases per link group All phases in a link group must be defined with the same number of message partners in the Area Models phase class definition The total number of phases within a link group must be equal to the number of configured message partners plus one Each phase instance may be assigned to only one link group per recipe
417
Phases in phase link groups must have unique names. If the phase names are not unique it will result in missing message partners in the linked groups.
Message partners must run in parallel within a recipe and the phase logic must run in parallel so the phases can synchronize.
When using phase link groups in conjunction with control strategies, the number of phase link groups cannot vary between control strategies configured for a single phase. For example, if a phase is configured with two control strategies, CONTROL_STRATEGY_1 and CONTROL_STRATEGY_2, and the phase has two configured phase link groups, then both control strategies must also have two phase link groups. CONTROL_STRATEGY_1 cannot have a different number of phase link groups than CONTROL_STRATEGY_2.
The actual communication between the phases is programmed in the phase logic using the the _RQ = 5Xxx request category. This is commonly implemented between two individual phases using 55xx and 52xx where:
55xx means Request to Wait for a message from another phase 52xx means Send Message and Wait for one Receiver xx = the message number from 00 to 99. All message partners must utilize the exact same message number.
One phase is responsible for sending a message to its partners at the appropriate time. The synchronization occurs when one phase in the group sends the message and the appropriate number of phase partners wait for the message. (See Send Messages to Other Phases in the PCD Programmers Technical Reference for information on phase programming.)
T1: Transfer-Out phase is ready; sets _RQ = 5501 and halts its running logic T2: Transfer-In phase is ready; sets _RQ = 5201 and halts its running logic T3: FactoryTalk Batch Server commands the PLI to reset both _RQ registers to 0 T4: PLI resets both _RQ registers to 0 T5: All running logic resumes execution
2. Select the appropriate group column heading. The cells in the column are highlighted. 3. Select the appropriate phase in the Procedure View pane, or click a phase step in the Recipe Construction pane. 4. Click Add. The selected phase will be added to the link group. 5. Repeat steps 3 and 4 until all phases have been added to the group. 6. Click OK to save any changes and return to the Recipe Editor window, or click Cancel to cancel the changes.
A phase may only be contained in one phase link group.
Equipment Model
Unit #1 Unit #2 Unit #1
SFC
Unit #2
PIC
Inertization
PHASE_A
TRANSFER_IN
F1Stirring
PHASE_B
CHARGE
TRANSFER_IN
T1
MIX
HEAT
Tempering
TRANSFER_OUT
MIX
TRANSFER_OUT
419
All of these recipe elements can contain phase link groups. However, to edit the phase link group contained in Operation A, you must open Operation A by itself.
420
CHAPTER 11
Verifying a recipe
A recipe must be verified to ensure that all connections and references are properly made. The verification process examines the selected recipe and all lower level recipes. If there are errors in the recipes being verified, messages explaining the nature of the error are displayed.
If you want to verify all recipes, select Verify All Recipes or Verify All Recipes and Validate All SFCs from the File menu.
1. Open the recipe you want to verify. 2. Click the Verify button or select Verify Recipes from the Recipe menu. The FactoryTalk Batch Recipe Editor reads the current recipe and displays a list of the recipes outstanding problems, if any, and saves the recipe in the process. 3. If there are errors, double-click an error message to open the recipe to the recipe level where the error was detected. 4. Fix the problem and run the verification again. Continue this process until the recipe verifies successfully. 5. When the recipe(s) are successfully verified, the SFC structure may then be validated if you selected Verify All Recipes and Validate All SFCs. (See Validating an SFC for more information.)
If a working recipe is changed and fails verification, the Released to Production box in the recipe header is cleared, making the recipe unavailable for use. Once you have fixed all verification errors, reset the recipe to Released to Production.
421
Basic Structure: Verification checks to ensure there is an initial step, terminal step and other steps and that they are all linked together. Unit Requirements: Unit requirements are verified against the area model. For
example, does the Unit Class or the Unit Instance exist in the area model? Is there a flow path in the area model that satisfies the Procedures Unit Requirement specified flow path?
Deferred Parameters are within the min / max and limits of the parameters that are
deferred to them.
Phase links have partners. Header Identifier, version, timestamp and author are not empty. All steps recipe paths are valid. For Procedures, this means that each referenced Unit Procedure recipe exists. For Unit Procedures, it means that each referenced Operation exists. For Operations, it means the Phase is in the area model.
If a recipe that has been released to production is changed and subsequently fails verification, the Released to Production box in the recipe header is cleared, making the recipe unavailable for use. Once you have fixed all verification errors, be sure to reset the recipe to Released to Production.
Validating an SFC
The Recipe Editor recipe verification feature ensures that basic SFC legality rules, such as step-transition-step sequencing, are enforced, but the recipe verification check does not detect logic errors within the SFC structure. Beginning with FactoryTalk Batch v. 10, the Recipe Editor also provides SFC validation. For example, the following SFC is structurally invalid:
While the above SFC structure would pass the current verification checks done by the Recipe Editor, this structure would never run to completion for the following reason: The final transition condition following the AND Convergence cannot execute unless all prior steps above it are concurrently active; however, the OR Divergence ensures that only one of the steps prior to the AND Convergence can be active at one time. While the error in the SFC shown above is relatively easy to identify, this type of SFC flaw and others can be much more difficult to identify in more complex recipe structures.
422
The SFC Validation tool can detect a variety of programming errors that result in invalid or illegal SFC programs. SFC structures identified as invalid by the tool will result in recipe verification warnings, but note that the Release to Production check box is not unchecked.
1. Open the recipe containing the SFC you want to validate. 2. From the Recipe menu, select Verify all Recipes and Validate all SFCs, or click the Verify and Validate button. The FactoryTalk Batch Recipe Editor reads the current recipe structure, determines its validity, and displays a list of the recipes outstanding problems, saving the recipe in the process. Errors are displayed in the Recipe Verification dialog box. 3. If there are errors, double-click an error message to open the recipe containing the error. 4. Fix the problem and run the validation again. Continue this process until the recipe validates successfully.
1. To set the maximum number of SFC permutations, select Options from the Recipe menu. 2. Change the value in the Max SFC Permutations box to the desired number.
423
The default setting is 65535. The allowable range for the configuration parameter is from 1024 to 2,097,152, inclusive.
3. Click OK to save your changes and close the dialog box, or click Cancel to close the dialog box without saving changes.
424
execution tokens to exist in the same linear segment, which is the segment containing the step marked with an X, below.
The actual error message text will be similar to: WARNING: SFC Validation Tool detects dual activation of Linear Segment beginning with step:%1 (where %1 is the actual segment identifier). The reported error location may not be close to the SFC structural issue. Refer to the product documentation for example(s) of SFC structure(s) that can report this error. Other error(s) may or may not be present. Unreachable terminal step SFC Validation can detect when an SFC structure makes it impossible for a recipe execution to reach the SFC terminal step. In the following SFC, the OR Divergence will activate only one of the two steps below it. This means that the transition below the AND Convergence will never activate, since it is
425
not permitted to fire unless all prior steps are active. This error makes it impossible for an execution token to reach the terminal step of the SFC.
The actual error message text will be similar to: WARNING: SFC Validation Tool detects unreachable Terminal Step. Refer to the product documentation for example(s) of SFC structure(s) that can report this error. Other error(s) may or may not be present. Parallelism with terminal step SFC Validation can detect when an SFC structure makes it possible for the terminal step of the SFC to be reached while other linear segments within the structure still have an active execution token(s). For example, in the SFC below, the AND Divergence activates both steps below it. Then whichever leg of the parallelism completes first has its execution token reach the terminal step. This results in an execution token reaching the terminal step of the SFC while another execution token is active within the structure. This is defined as an illegal behavior when an execution token reaches the terminal step of the SFC it should be the only execution token present in the SFC structure.
The actual error message text will be similar to: WARNING: SFC Validation Tool detects parallelism with Terminal Step of Linear Segment beginning with step:%1 (where %1 is the segment identifier). The reported error location may not be close to the SFC structural issue. Refer to the product documentation for example(s) of SFC structure(s) that can report this error. Other error(s) may or may not be present. Linear segment cannot reach terminal step SFC Validation Tool detects when an SFC structure makes it impossible for an active execution token contained within a linear segment to reach the SFC terminal step. For
426
example, in the SFC example below, if the active token goes down the right branch of the first OR Divergence, then the execution token enters an infinite loop through which it can never reach the terminal step of the SFC.
A second type of SFC structure can also generate this error. In the SFC structure below, if the recipe execution goes through the right-most transition, indicated by the arrow, then the execution token will reach a dead end in the second step of the right-most leg of the AND Divergence and recipe execution will be unable to reach the terminal step.
Note that in this SFC example, the linear segment reported by the Validation Tool as the source of the error actually contains no steps. The actual error message will be similar to: WARNING: SFC Validation Tool detects Linear Segment beginning with step:%1 (where %1 is the segment identifier) has no path to Terminal Step. Refer to the product documentation for example(s) of SFC structure(s) that can report this error. Other error(s) may or may not be present.
427
Unreachable linear segment SFC Validation also detects when an SFC structure makes it impossible for an active execution token to reach one or more linear segments within the SFC. For example, in the SFC below, the linear segment under the AND Convergence is unreachable because it is impossible for both prior steps to have active execution tokens simultaneously due to the initial OR divergence. This means that if recipe execution takes the left branch of the first OR Divergence, or the left branch of the second OR Divergence, then recipe execution will become hung and unable to proceed.
The actual error message will be similar to: WARNING: SFC Validation Tool detects unreachable Linear Segment beginning with step:%1 (where %1 is the segment identifier). Refer to the product documentation for example(s) of SFC structure(s) that can report this error. Other error(s) may or may not be present.
428
1. If the Recipe Editor is closed, opening it reflects the new recipe updates. Rebuilding the recipe directory is not necessary. 2. If the Recipe Editor is already open, select Rebuild Recipe Directory from the File menu. The Recipe Editor reads all of the currently stored recipes and updates the recipe directory file.
If the recipes in the recipe directory have not been verified, you are given the option to verify all recipes or verify and validate all recipes. (See Validating an SFC for more information.)
Recipe maintenance
Recipe maintenance includes page setup, generating reports, and removing obsolete recipes.
Page setup
Page Setup is accessed through the File menu or using the hot key, CTRL+P, and allows you to adjust the following:
Margins (must be greater than .25 inches) Orientation Paper size and source Preview (view only) Printer and associated properties
The print area cannot be defined to an area smaller than 4 inches (10 cm) wide or high.
Generate reports
You can filter and print a complete working set of recipes or a single recipe using the Generate Reports option in the FactoryTalk Batch Recipe Editor. The report format consists of three sections, the Overview Page, SFC, and Recipe Descriptive Information. You choose the sections that meet your reporting requirements. When generating reports, the entire recipe procedure appears in the SFC rectangle grid. An SFC rectangle represents a portion of the SFC that will print on one page at 100% scale as defined in the Page Setup. Activating the Show/Hide Page Boundaries button displays the SFC rectangles in the SFC rectangle grid.
429
SFC Rectangle
All generated reports contain the same header and footer format. The report header consists of:
If a procedure description has been included in the Header Data dialog box for a recipe, it appears under the report header information. Reports can be produced in two ways, as a complete working recipe set or a single recipe. Select either method and generate your reports using the following steps.
Users with view/read only permissions cannot access the Generate Reports menu option or toolbar button.
Print a working set of recipes The Print function in the Recipe Editor uses the configured Default Printer. If there is no default printer specified you will be prompted to establish one the first time you attempt to print. The default printer can be set or changed without having to close the Recipe Editor application. 1. Close all open recipes. On the File menu, click Close All.
430
2. Click the Generate Reports button or press CTRL +T. The Generate Reports dialog box opens.
3. The Recipe Procedures list displays the current working set of recipes. To customize the recipe list for printing, use the Select All and Deselect All buttons or select/clear the individual recipe check box. For further recipe refining, use the following Procedure Filtering options:
List Recipes of Type: Select All Procedures, Unit Procedures, Operations, or Procedures. If you select anything other than All procedures, you can also filter by Equipment. Equipment: Choose All, Unit Class, or Unit. You can filter Unit Procedures and Operations by those built against a specific Unit Class or Unit. Overview Page: Displays the entire SFC grid scaled on a single report page with its page/SFC rectangle boundaries. A cross reference grid provides numeric vertical and alphabetic horizontal coordinates. The SFC rectangles are numbered from left to right, top to bottom. Numbers will only appear in the upper right corner of rectangles containing a portion of the SFC. SFC: Displays the SFC at 100% scale and includes a cross reference grid with numeric vertical and alphabetic horizontal coordinates. Off-page references indicate the SFCs continued direction. Descriptive Information: Displays in text form the recipe header information, unit requirements, phase link groups, recipe formula parameters, steps, step parameters/reports, binding preferences/requirements, report expressions, transitions, and text boxes. Steps and transitions will print in SFC report order, left to right, top to bottom. If a group, requirement, parameter value, report limit, or text box does not exist, the report notes that status also.
431
4. In the Report Selection area, select the report elements you want to print.
Report Description: Enter a name or descriptive phrase to appear in the reports footer.
5. Click the Page Setup button to finalize any page printing adjustments.
Windows Vista does not display the Printer button on the Page Setup dialog box. This does not affect your ability to print from the FactoryTalk Batch Recipe Editor; the Printer button simply allows the selection of a different printer. If you have not yet configured a default printer, you will be prompted to do so when you click the Print button.
Print a single recipe 1. Open the recipe you want to print. 2. Click the Generate Reports button or press CTRL +T (or select Generate Reports from the File menu). The Generate Reports dialog box opens.
3. The Recipe Procedures list displays the current working set of recipes. To customize the recipe list for printing, use the Select All and Deselect All buttons or select/clear the individual recipe check box. 4. In the Report Selection section, choose the report elements you wish to print.
Overview Page: Displays the entire SFC scaled on a single report page with its page boundaries. A cross reference grid provides numeric vertical and alphabetic horizontal coordinates. The SFC rectangles are numbered from left to right, top to bottom. Numbers will only appear in the upper right corner of rectangles containing a portion of the SFC. SFC: Displays the SFC at 100% scale and includes a cross reference grid with numeric vertical and alphabetic horizontal coordinates. Off-page references indicate the SFCs continued direction. Descriptive Information: Displays in text form the recipe header information, unit requirements, phase link groups, recipe formula values, steps, step parameters/reports,binding preferences/requirements, report expressions, transitions, and text boxes.
432
Steps and transitions will print in SFC report order, left to right, top to bottom. If a group, requirement, parameter value, report limit, or text box does not exist, the report notes that status also.
Report Description: Enter a name or descriptive phrase to appear in the reports footer.
5. Click the Page Setup button to finalize any page printing adjustments. 6. To view the finished report, click the Print Preview button.
Only one recipe procedure at a time can be previewed. An error message displays if more than one recipe procedure is selected.
7. When all report options have been determined, click the Print button.
Removing a recipe
When a recipe file is no longer needed, there are two ways you can make it unavailable to batch operators.
Ensure that its Released To Production check box is not selected. (See Recipe header data for more information.) On the File menu, click Remove Recipe. Select the recipe or recipes you want to remove, and then click the Remove button.
433
434
CHAPTER 12
Recipe Formats
FactoryTalk Batch recipes can be stored in a relational database (RDB) format, XML format, or in the proprietary binary format. The three formats are mutually exclusive; they cannot be used at the same time. However, you can convert recipes from one format to the other. You select one of these formats in the FactoryTalk Batch Equipment Editor, and all recipes created or imported into the working set of recipes are then stored in that format. The binary format is the default for FactoryTalk Batch recipes.
RDB format
The RDB recipe format gives you greater flexibility when generating reports. A default Microsoft SQL Server database, masterrecipes, is created when FactoryTalk Batch is installed if you selected Yes, I want to store recipes in SQL Server during installation (you must have SQL Server 2005, SP3 installed before installing FactoryTalk Batch).Open Database Connectivity (ODBC) is used as the database connectivity protocol between the FactoryTalk Batch Recipe Editor and the Microsoft SQL Server database. The following diagram describes the flow paths and functional relationships of FactoryTalk Batch using a relational database:
3rd party editing of Recipes
Batch Server
1. Read Recipes at runtime 2. Verify Recipes against Equipment Database
Binary Files
1. Recipes 2. Equipment Database
ODBC Protocol
Recipe Editor
1. Create/Edit Recipes 2. Verify Recipes against Equipment Database
Equipment Database
Equipment Editor
1. Create/Edit Equipment Database
435
Before you can import recipes into the RDB format, you must first create the recipe database on the computer running SQL Server. FactoryTalk Batch uses a database called masterrecipes. Follow these instructions to create the masterrecipes database. 1. If they do not exist, create the MasterRecipeAuthor and MasterRecipeViewer local user groups on the computer where you want to install the masterrecipes database. (See the FactoryTalk Batch Administrators Guide for information on creating user group accounts.) 2. If you are using workgroup security, create a local user account for the Batch Server. (See the FactoryTalk Batch Administrators Guide for information on creating user accounts.) 3. Add the Batch Server user account, or the domain account used by the FactoryTalk Batch Server, to the MasterRecipeViewer user group. This allows the Batch Server to read the masterrecipes database. 4. Open the Scripts folder (in the Batch directory). (SQL Server must already be installed and running.) 5. Double-click createmasterrecipedb.bat. The batch file runs and creates the masterrecipes database. 6. After the batch file runs, you must configure FactoryTalk Batch to use the database. You set this option in the FactoryTalk Batch Equipment Editor Server Options dialog box. (See Setting the recipe file format for more information.)
XML format
XML schemas have become the industry standard for providing implementation-neutral information. An XML schema defines what a textual file should look like to represent structured data, like a master recipe, for instance. Recipes are therefore an instance document of the XML schema and can be easily exchanged between different companies. The XML recipe format gives you greater flexibility when generating recipes that must be usable across multiple operating systems and platforms. The FactoryTalk Batch Recipe Editor is capable of editing and creating XML recipes, and the FactoryTalk Batch Server can execute these recipes.
436
12 Recipe Formats
The following information is validated by the Recipe Editor and the MasterRecipe schema:
Referential Integrity: Validates that an element referenced by another element exists Uniqueness: Element names within a collection must be unique Name Length: Element names are restricted to a certain length Name Pattern: Names often must conform to a certain syntax
The following information is validated by the FactoryTalk Batch Server and/or Recipe Editor:
Phaselinks are validated for referential integrity, along with the message partner information found in the area model Enumeration set names and elements found in the area model Phase class names found in the area model The existence of referenced recipes (via the step name) Unit requirement information found in the area model Transition conditional expressions Material requirement information found in the material database SFC structure
To set or change the recipe file format, you must first start the FactoryTalk Batch Equipment Editor. 1. Click the Start button, point to All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch, and then select Equipment Editor. The Equipment Editor opens. 2. From the Options menu, select Server Options. The Server Options dialog box opens with the Project Settings tab displayed. 3. In the Store Recipes Using area, select the recipe file format in which you want to store recipes.
If you selected Microsoft SQL Server Database:
a. Locate your SQL Server by clicking the browse button next to Node. The Select Computer dialog box opens. b. Select the SQL Server computer and click OK to return to the Server Options dialog box.
437
c. Locate the appropriate database by clicking the browse button next to Database. A list of databases appears. d. Select the SQL Server database and click OK to return to the Server Options dialog box. The selected database name is inserted into the Database box.
If the SQL Server is not installed on the same computer as the FactoryTalk Batch Client and you would like to see a list of available SQL Server databases, you will need to install SQL Server Client Connectivity, which can be found on your SQL Server installation CD. You will need to do a custom install of SQL Server to install the Client Connectivity option. If you selected Binary Files or XML Files:
a. Locate the recipe directory by clicking the browse button next to Recipe Directory. The Select Directory dialog box opens. b. Select the appropriate directory and click OK to return to the Server Options dialog box. The selected directory path name is inserted into the Recipe Directory box. 4. Click OK and then exit the Equipment Editor.
438
CHAPTER 13
Importing recipes
You can import recipes from any format into the current working set of recipes. Before you import, make sure the recipe file format for the working set of recipes is set to the format you want to use. (See Setting the recipe file format for more information.) If you have set your recipe storage format to RDB (Microsoft SQL Server Database), create the masterrecipes database if it does not already exist. (See Creating the Masterrecipes database for more information.)
If you have changed the recipe file format in the FactoryTalk Batch Equipment Editor, you must stop and restart the FactoryTalk Batch Server and the FactoryTalk Batch Recipe Editor for the change to take effect.
1. From the File menu in the Recipe Editor, select the Import Recipe Into Working Set option. The Import Recipe into Database dialog box opens. (The title bar of the dialog box indicates the file storage type you selected for the current working set of recipes you have set in the Equipment Editor. The imported recipes will be converted to this format.)
2. In the Recipe directory from which recipes will be imported area, select the storage format of the recipes you want to import. 3. Select the directory or database that contains the files you want to import.
Binary Files or XML Files: (See Selecting a directory for more information.)
439
Microsoft SQL Server Database: (See Selecting a SQL Server database for more information.)
Importing or exporting FactoryTalk Batch recipes to or from a computer containing more than one instance of Microsoft SQL Server is not supported. The Import/Export Recipe dialog box only allows you to enter the name of the computer hosting the Microsoft SQL Server and the database name. The SQL Server instance name cannot be defined in the Import/Export Recipe dialog box.
4. (Optional) From the List Recipes of Type list, select All Procedures, Operation, Unit Procedure, or Procedure. 5. (Optional) From the Equipment area, select All to view all equipment classes, or select Unit Class or Unit and then select the appropriate unit class or unit from the list. 6. From the Recipe Name list, select the recipe(s) to be imported.
To select nonadjacent files in the Open dialog box, click the name of any file. Hold down CTRL and click the name of each additional file. To select adjacent files in the Open dialog box, click the name of the first file in the sequence. Hold down SHIFT and click the name of the last file.
If you select a file you don't want, hold down CTRL and click the file name again.
7. Click the Import button. The recipe(s) selected in the Recipe Name list are imported into the current working set.
If one of the imported recipes has the same name as a recipe in the working set, a dialog box opens to notify you of the problem. (See Importing or exporting recipes with the same name for more information.)
8. After the importing process has completed, click the Close button.
Selecting a directory
If you chose to import Binary Files or XML Files, you must select the directory that contains the binary or XML files you want to import.
440
1. Click the Browse button next to the Recipe Directory box of the storage format you selected. The Select Directory dialog box opens. The default directory, Batchctl, is displayed unless another directory was previously selected.
If you select the same directory as that used by the working set of recipes, an error message is displayed that states, You cannot import/export recipes from/to the current set of working recipes. Choose another directory.
2. Select the directory, and then click the Open button. The Recipe Name list on the Import Recipe dialog box is updated with the recipe list from the specified directory.
2. In the Enter the object name to select box, type the name of the computer where the SQL Server database resides, and click OK.
441
3. Click the browse button next to the Database box to select the database from which you want to import recipes or to which you want to export recipes.
4. Select the database, and then click OK. The Recipe Name list on the Import Recipe dialog box is updated with the list of recipes from the specified database.
Exporting recipes
You can export recipes from the current working set of recipes into any supported storage format, including RDB, XML, or binary. 1. Open the FactoryTalk Batch Recipe Editor. 2. From the File menu, select Export Recipe from Working Set. The Export Recipe from Database dialog box opens. (The title bar of the dialog box indicates the file storage type you selected for the current working set of recipes you have set in the FactoryTalk Batch Equipment Editor. The recipes are exported from this format.)
3. In the Recipe directory to which recipes will be exported area, select the storage format to which you want to export files.
Binary Files or XML Files: (See Selecting a directory for more information.)
442
Microsoft SQL Server Database: (See Selecting a SQL Server database for more information.)
Importing or exporting FactoryTalk Batch recipes to or from a computer containing more than one instance of Microsoft SQL Server is not supported. The Import/Export Recipe dialog box only allows you to enter the name of the computer hosting the Microsoft SQL Server and the database name. The SQL Server instance name cannot be defined in the Import/Export Recipe dialog box.
4. (Optional) From the List Recipes of Type list, select All Procedures, Operation, Unit Procedure, or Procedure. 5. (Optional) From the Equipment area, select All to view all equipment classes, or select Unit Class or Unit and then select the appropriate unit class or unit from the list. 6. From the Recipe Name list, select the recipe(s) to be exported.
To select nonadjacent files in the Open dialog box, click the name of one file. Hold down CTRL and click the name of each additional file. To select adjacent files in the Open dialog box, click the name of the first file in the sequence. Hold down SHIFT and click the name of the last file.
If you select a file you don't want, hold down CTRL and click the file name again.
7. Click the Export button to initiate the export process. If recipes with the same name already exist in the target format, you will be prompted to indicate whether you want to overwrite them with the new recipe file. (See Importing or exporting recipes with the same name for more information.)
Overwrite - Overwrites the recipe and continues the import or export process Overwrite All - Overwrites all recipes having the same name and continues the import or export process Ignore - Does not overwrite the recipe but continues the import or export process
443
Ignore All - Does not overwrite any recipe with the same name but continues the import or export process Cancel - Does not overwrite the recipe and cancels the import or export process
444
Batch
445
CHAPTER 1
Document Organization
The following subjects are covered:
Introduction to the FactoryTalk Batch View Using the FactoryTalk Batch View Windows Commanding a Batch Troubleshooting
Overview
The FactoryTalk Batch View is used to initiate and execute FactoryTalk Batch automation processing. The View secured objects are located in the FactoryTalk Directory and are modified using the FactoryTalk Administration Console. A system administrator can customize the View security to meet the needs of your facility. The View is used in conjunction with a Human-Machine Interface (HMI).
447
To change the View policy setting default values use the FactoryTalk Administration Console. (See FactoryTalk Help located in the FactoryTalk Administration Console for more information.)
If a user is logged on to the FactoryTalk Directory the View opens using the security permissions defined for that user. If there is no user logged on to the FactoryTalk Directory but the current Windows user is a FactoryTalk Windows-linked user, the View opens using the security permissions defined for the current FactoryTalk Windows-linked user. The FactoryTalk Windows-linked user is then logged on to the FactoryTalk Directory. If a user is not found, the Log on to FactoryTalk dialog box opens and remains open until a FactoryTalk user is authenticated or the Log on to FactoryTalk dialog box Cancel button is clicked. Canceling the Log on to FactoryTalk dialog box has the following affect: only the currently displayed View window is accessible, the Login button is the only enabled option and the View status bar displays a message in the following format: <No authenticated user>.
Opening the View when the View Single-SignOn product policy setting is Disabled or the FactoryTalk Use single sign-on system policy setting is False the following scenarios are possible.
If the FactoryTalk Batch View Single-SignOn product policy setting is disabled, users logged on to the FactoryTalk Directory are ignored when opening the View.
If the current Windows user is a FactoryTalk Windows-linked user, the application opens using the security permissions defined for the current FactoryTalk Windowslinked user. If the current Windows user is not a FactoryTalk Windows-linked user, then the Log on to FactoryTalk dialog box opens and remains open until a FactoryTalk user is authenticated or the Cancel button is clicked. Canceling the Log on to FactoryTalk dialog box has the following affect: only the currently displayed View window is
448
accessible, the Login button is the only enabled option and the status bar displays a message in the following format: <No authenticated user>.
2. If the Log on to FactoryTalk dialog box opens, type your user name in the Name box and your password in the Password box. Click OK. The authenticated user displays in the View status bar.
3. If you enter a user not found in the FactoryTalk Directory a Logon Message dialog box opens. Click OK to close the dialog box. 4. Click the Login button to open the Log on to FactoryTalk dialog box. 5. To close the Log on to FactoryTalk dialog box without logging on, click the Cancel button.
449
Procedure as SFC: View and interact with each component of the currently selected batch, in an SFC format. Procedure as Table: View and interact with each component of the currently selected batch, in a table format. Event Journal: Open and view event data for batches. All commands sent to the FactoryTalk Batch Server are recorded in the batchs electronic batch record. This includes the users name who initiated the command. Unacknowledged Prompts: View and respond to a list of prompts that require operator input. Signature List: View and acknowledge the list of signatures that require signoffs.
450
Phase Control: Access all procedures and equipment for the currently loaded area model. Arbitration: View and interact with current resource allocations.
Alarm Summary: Displays a list of alarm and failure messages for units and phases of the current batches. Phase Summary: Lists the status of all phases in the currently loaded area model.
The View toolbar also contains buttons that access configuration information, online help, HMI, security, and for exiting the View.
Configuration and Defaults: Allows you to configure the display of each View window. Help: Opens online Help for the View.
Go To HMI: Opens a user-defined HMI (Human-Machine Interface). If the Cross Invocation function is enabled, this button allows context information regarding the selected component to be passed to an OLE Automation Server. Login: Opens the Log on to FactoryTalk dialog box.
451
Abort Batch: Perform an emergency termination of a currently running batch. Timer Reset: Reset the ELAPSED_TIME in a Timer step to 0 (if the Timer step is configured as a COUNT_DOWN timer the REMAINING_TIME will be reset to the setpoint value). Timer Complete: Force a Timer step to complete. Manual: Placing a batch in MANUAL mode allows you to control the execution of the remaining steps in a batch. Semi-Auto: Placing a batch in SEMI-AUTO mode allows you to resume the execution of all lower level steps in a batch. Auto: Placing a batch in AUTO mode gives control of the running batch to the FactoryTalk Batch Server. Comment: Add a comment to the electronic batch record for the current batch. Add Batch: Add a batch to the batch list. Remove Batch: Remove a batch from the batch list. Clear All Failures: Clear all failures and system-generated messages (3000 requests) listed in the Alarm Summary window. Disconnect: Disconnect an unusable equipment module from the FactoryTalk Batch Server. (The Disconnect button is only available in the Procedure as SFC, Procedure as Table and Manual Phase Control windows).
Status Bar
The bottom line of the FactoryTalk Batch View displays status information regarding the data server and the Material Server. The ID of the currently selected batch is displayed to the right of the Material Server status. The current user name and system time are also located on the status bar.
Some windows within the FactoryTalk Batch View consist of resizeable panes. To resize a pane, click the vertical or horizontal splitter bar, which is used to separate the panes, and drag it to a new position.
Communication Status for the FactoryTalk Batch Server and Data Servers
The Data Server Status indicator located at the bottom of each FactoryTalk Batch View window to the right of the time display indicates the communication status of the FactoryTalk Batch Server with the View, its data server(s) and the control system. The various status indicators and their meanings are as follows:
452
Color Green
Meaning Communications are good between the FactoryTalk Batch Server and following components:
the FactoryTalk Batch View the data server(s) the control system.
Yellow
Communications are suspect between the FactoryTalk Batch Server and the control system. The Server and the control system handshake with each other via the setting and resetting of a tag in the control system called the Watchdog (which is usually a bit or flag). The Server sets the Watchdog and the control system resets the Watchdog. A Suspect indication means that communications between the Server and the control system do not reflect that the Watchdog was reset by the control system at least once (but less than the maximum number of allowable times) within the communication timeout period. The communications timeout period defaults to ten seconds and maximum number of allowable failures defaults to five times, but these values are configurable. Communications are bad between the FactoryTalk Batch Server and the control system. A Bad indication means that communications between the Server and the control system do not reflect that the Watchdog was reset by the control system within the maximum number of allowable failures. Communications between the FactoryTalk Batch Server and the View are lost. Communications are completely lost between the FactoryTalk Batch Server and one or more of its data servers.
Red
LOST L
The Data Server Status indicator displays the most severe conversation status of all the data servers.
453
with the Server while the Conversation Status of Data Servers dialog box is open, the dialog box closes.
Communication Status for the FactoryTalk Batch Server and Material Server
In order to run material-based recipes, the FactoryTalk Batch Server and the FactoryTalk Batch Material Server must communicate with each other. In the FactoryTalk Batch Equipment Editor, you can set up how the system handles batches if the Batch Server loses communication with the Material Server. You can either set the Batch Server to fail and hold execution of material-based recipes, or switch to manual processing, prompting the operator to make binding decisions until communication with the Material Server is restored. See the FactoryTalk Batch Equipment Editor Users Guide for more information on setting the Material Server communication options. The FactoryTalk Batch View displays the communication status between the Material Server and the Batch Server. The Material Server Status indicator is located at the bottom of each View window to the right of the Data Server Status indicator. The following status indicators may be displayed:
MT-G = MT-S = MT-B = GOOD Green SUSPECT Yellow BAD Red Material Server communications in use. Material Server communications available but not restored. Material Server communications not available.
454
When processing material-based batches manually, you are required to make selections without information from the material database, as discussed in the following sections. Batch Creation The Material Server Not in Use warning is displayed in the Batch Creation dialog box for all recipes when there is no communication with the Material Server. You can create the batch or cancel and create the batch at another time when the Material Server is available.
If the failure to the Material Server occurs when the Batch Creation dialog box is open, the warning message will not display.
455
If you add a material class-based recipe to the batch list when the Material Server is unavailable, the materials will not be filtered by class when the recipe is run. Instead, all materials in the material enumeration are displayed.
If the failure to the Material Server occurs when the Material Value Selection dialog box is open, the warning message does not display.
Prompt to Bind Unit Requirement The Data Not Supplied by Material Server warning displays in the Prompt to Bind Unit Requirement dialog box when there is no communication with the Material Server.
The dialog box displays data supplied by the area model in place of the data normally supplied by the Material Server. When the Material Server is not available, the first available binding is serviced as though it was prompt binding.
If the failure to the Material Server occurs when the Prompt to Bind Unit Requirement dialog box is open, the warning message does not display.
456
Manual Unit Binding The Material Server Not in Use warning displays in the Manual Bind of Step dialog box when there is no communication with the Material Server.
The dialog box displays data supplied by the area model in place of the data normally supplied by the Material Server.
If the failure to the Material Server occurs when the Manual Bind of Step dialog box is open, the warning message does not display.
Prompt to Bind a Material Phase Step For prompt binding, the list of container-equipment module pairs generated from the area model is substituted for the list that would have been produced if the Material Server were available. When the Material Server is unavailable, material additions may not be filtered by lot or label specification.
If you do not know which equipment module to select, you can look up some material information on the computer where the Material Server is installed if it is still running. If you have access to the computer where the Material Server is installed, open the Material Editor. Navigate to Independent Containers or Materials. Double-click the desired container or material to see its properties. Check the Materials, Containers, and
457
Inventory tabs and compare the values to the Unit, Material, and Amount to Charge to determine which equipment module can best accommodate the material phase step.
If the failure to the Material Server occurs when the Prompt to Bind a Material Phase Step dialog box is open, the warning message does not display.
Phase Control
The Material Server Not in Use warning is displayed when there are no communications with the Material Server.
For material binding in manual phase control, the list of container-equipment module pairs generated from the area model is substituted for the list that would have been produced if the Material Server were available. The list is filtered by the container enumeration. All the data displayed is contained in the area model and the recipe. The Label and Lot fields can only be supplied by the Material Server and therefore is blank when there is no communication with the Material Server.
If the failure to the Material Server occurs when the Phase Control dialog box is open, the warning message does not display.
458
Manual Batches If the FactoryTalk Batch Server is configured to Switch to Manual, you must reestablish communications with the Material Server when it becomes available again. When the Material Status indicator changes to Suspect (MT-S), the Material Server is available and you can attempt reconnection. 1. Double-click the Material Server Status indicator. The Failed Material Server Indicator dialog box displays. 2. Click the Material Server Control button. The Material Server Control dialog box displays. 3. Manually reconcile the batch event journal with the material database. All Loss of Material Tracking and Loss of Material Server events indicate material steps that took place without Material Server communication. Use this information to manually update the Amount, Lot, and Label information for the material inventory in the material database. (See the FactoryTalk Batch Material Editor Users Guide for more information.) 4. Select the Reestablish Communication with Material Server check box, and then click OK. After communication with the Material Server has been restored, any material-based steps that were in a HELD state must finish executing to the COMPLETE state before further processing can occur. You must acknowledge any unacknowledged prompts before the batch will continue to run. (See Using the Unacknowledged Prompts Window for more information.)
The System Configuration and Defaults dialog box opens to the tab that corresponds to the active View window. Each of these tabs is described following the instructions for the General tab. Instructions for modifying column display information, filtering and sorting specifications, row height, font selection, and SFC display sections follow the tab descriptions. On each tab you can customize a specific portion of the View.
459
1. Click the Configuration and Defaults button. The System Configuration and Defaults dialog box opens.
The Log on to Confirm User dialog box opens. Enter the appropriate user information and click OK to open the System Configuration and Defaults dialog box.
2. Select the tab for the portion of the View you want to customize. 3. Click OK to save any changes and close the System Configuration and Defaults dialog box, or click Cancel to exit without saving any changes. General Configuration Use the General tab to customize the general configuration of the FactoryTalk Batch View.
The HMI application to be used. You can create a custom bitmap to be used on the View toolbar in place of the Go To HMI button. Whether to enable the Cross Invocation function in place of the HMI application. The location of the process cell and unit bitmaps. The FactoryTalk Batch Server communication time-out information. The size of the splitter bars used in the Procedure as SFC view, Procedure as Table view, Event Journal and Phase Control windows. The resize or minimize functionality of the View window. The actual percentage of the screen to be used for the View. The font to be used for the status bar. Whether to allow or disable editing of the Batch ID (if you have written a custom program to automatically generate Batch IDs, you should disable BatchID Editing).
Batch IDs must be unique or the Arbitration window will not update correctly.
460
1. Type the path and file name for the HMI application or select the Enable Cross Invocation box.
You can type the Title to be used for the HMI window. If you want to use a custom Go To HMI toolbar button, you must specify the path and file name of the bitmap. The bitmap should be 42 x 42 pixels. The button is updated when you click the Apply button. (You can configure your HMI screen for commanding batches. See the Server API Communication Language Reference guide for more information.) If you enable Cross Invocation, enter the identity of the Automation Server in the Invocation ProgID box. All information concerning the HMI is disabled.
Otherwise
2. Type the location of the process cell and unit bitmaps. 3. Type the thickness, in pixels, for the vertical and horizontal splitter bars. 4. Select the Allow Resize check box to allow the View window to be resized. 5. Select the Allow Minimize check box to allow the View window to be minimized. 6. Type the horizontal and vertical percentage of the screen that is used by the View. The View window occupies the specified percentage of the screen, with its origin being in the upper-left corner of the screen. You are able to move the View window around on the desktop. 7. Click Apply to save the changes made on any tab. 8. Click OK to save the changes. (Some of the changes may not be applied until you exit and reopen the View.) Click Cancel to abort the changes.
To connect the FactoryTalk Batch View to a server computer other than that displayed in the Server Communications section, you must use the Registry Editor to edit the NET registry key. (See the FactoryTalk Batch Administrator's Guide for information on editing the NET key.)
Signatures Configuration The Signatures tab corresponds to the Signature List window. You can specify the columns to be displayed, the column header text, the column width, filter specifications for a specific column, the field and order in which the signatures are sorted, the row height, and the font to use. If the box labeled Display Complete, Cancelled, and System Cancelled Signatures is checked, the Signature List window displays all Signatures generated against a batch until the batch is removed from the batch list. The default setting displays only the Incomplete Signatures in the Signature List window. If the check box labeled Display Parameter Limits is unchecked, Parameter Limits are not displayed in
461
Signature dialog boxes. (See Using the Signature List Window for more information.) The default values for the Signature tab are shown here:
The commands that have a confirmation prompt. The font used for the status bar.
1. Select the check box for each of the commands that require a confirmation prompt. When a command is enabled, you are prompted to confirm that this is the correct action to take. 2. Click the Select Font button to change the font used in the status bar, if desired. 3. Click Apply to save the changes made on any tab. 4. Click OK to save the changes, (some of the changes may not be applied until you exit and reopen the FactoryTalk Batch View). Click Cancel to abort the changes.
462
Batch List Configuration The Batch List tab corresponds to the Batch List view. You can specify which columns to display, the column header text, the column width, on which column to filter and sort, the row height, and the font to use. (See Using the Batch List View for more information.) Hierarchical Step List Configuration The Hierarchical Step List tab corresponds to the Procedural Hierarchy view in the Procedure as SFC and Procedure as Table windows. You can specify which columns to display, the column header text, the column width, the row height, and the font to use. (See Recipe Table Area for more information.) SFC View Configuration The SFC View tab corresponds to the SFC area in the Procedure as SFC window. You can specify if the transition expressions display, the width of the lines used in the SFC, and the font to use. (See SFC Area for more information.) Procedure Prompts Configuration The Procedure Prompts tab corresponds to the Prompts tab in the Auxiliary Index view in the Procedure as SFC and Procedure as Table windows. You can specify which columns to display, the column header text, the column width, the priority and order in which the prompts are sorted, the row height, and the font to use. (See Auxiliary Index View for more information.) Procedure Parameters Configuration The Procedure Parameters tab corresponds to the Parameters tab in the Auxiliary Index view in the Procedure as SFC and Procedure as Table windows. You can specify which columns to display, the column header text, the column width, the priority and order in which the parameters are sorted, the row height, and the font to use. (See Auxiliary Index View for more information.) Procedure Reports Configuration The Procedure Reports tab corresponds to the Reports tab in the Auxiliary Index view in the Procedure as SFC and Procedure as Table windows. You can specify which columns to display, the column header text, the column width, the priority and order in which the reports are sorted, the row height, and the font to use. (See Auxiliary Index View for more information.) Procedure Binding Configuration The Procedure Binding tab corresponds to the Binding tab in the Auxiliary Index view in the Procedure as SFC and Procedure as Table windows. You can specify which columns to display, the column header text, the column width, and the sort order for the Unit Requirements, Binding Requirements, and Binding Preferences areas. You can also turn off the Binding Requirements and Binding Preferences areas if Dynamic Unit Allocation is not in use. (See Auxiliary Index View for more information.)
463
Procedures Table Configuration The Procedures Table tab corresponds to the Procedures Table displayed in the Recipe Table Area in the Procedure as Table window. You can specify which columns to display, the column header text, the column width, the number of parameters to display, the row height, and the font to use. (See Using the Procedure as Table Window for more information.) Unit Procedures Table Configuration The Unit Procedures Table tab corresponds to the Unit Procedures Table displayed in the Recipe Table Area in the Procedure as Table window. You can specify which columns to display, the column header text, the column width, the number of parameters to display, the row height, and the font to use. (See Using the Procedure as Table Window for more information.) Operations Table Configuration The Operations Table tab corresponds to the Operations Table displayed in the Recipe Table Area in the Procedure as Table window. You can specify which columns to display, the column header text, the column width, the number of parameters to display, the number of reports to display, the row height, and the font to use. (See Using the Procedure as Table Window for more information.) Journal Configuration The Journal tab corresponds to the Event Journal window. You can specify which columns to display, the column header text, the column width, filter specifications for up to three columns, the row height, and the font to use. (See Using the Event Journal Window for more information.) Unacknowledged Prompts Configuration The Unacknowledged Prompts tab corresponds to the Unacknowledged Prompts window. You can specify which columns to display, the column header text, the column width, filter specifications for a specific column, the field and order in which the prompts are sorted, the row height, and the font to use. (See Using the Unacknowledged Prompts Window for more information.) Alarm Summary Configuration The Alarm Summary tab corresponds to the Alarm Summary window. You can specify which columns to display, the column header text, the column width, filter specifications for a specific column, the field and order in which the alarms are sorted, the row height, and the font to use. (See Using the Alarm Summary Window for more information.) Phase Control Configuration The Phase Control tab corresponds to the Phase Control window. You can specify which font to use for the Equipment View, Phase State, Phase Messages, Phase Parameters List box, Phase Name, and whether to enable or disable the Obtain [Batch ID] From Unit and Allow [Batch ID] Override options (not to be confused with Auto Batch ID options). (See Using the Phase Control Window for more information.)
464
Phase Summary Configuration The Phase Summary tab corresponds to the Phase Summary window. You can specify which columns to display, the column header text, the column width, filter specifications for a specific column, the field and order in which the phases are sorted, the row height, and the font to use. (See Using the Phase Summary Window for more information.) Column Display Area The Column Display area is included in the following tabs: Batch List, Hierarchical Step List, Procedures Table, Unit Procedures Table, Phase Summary, Alarm Summary, Operations Table, Procedure Prompts, Procedure Parameters, Procedure Reports, Procedure Binding, Journal, Signatures List, and Unacknowledged Prompts. Several of the tabs also have filtering and sorting capabilities in the Column Display area.
1. Select the Visible? check boxes for columns to display. Clear the check boxes for those you do not want displayed. 2. For each column, you can change the text for the column header and the width of the column. 3. Type the appropriate filter information using wildcard characters. A wildcard character is an asterisk (*) and can be used in conjunction with other characters. The wildcard character is placed before, after, or before and after the other characters, but it cannot be embedded within the characters. For example, select the Batch List tab, and in the Filtering area enter A* in the Filter box and select State from the Column list. This will limit the batches that display in the Batch List view to only those batches that have been ABORTED. Or, enter *ED in the Filter column for State to display only those batches whose states end in ED, such as ABORTED, STOPPED, etc. You cannot use E*D. 4. Rows of data are sorted according to the field(s) selected in the Sorting area. Sorting does not change the order in which the columns display. Specify sort priority by selecting an item from the Column list. 5. In the Procedure Prompts, Procedure Parameters and Procedure Reports tabs, you can sort on multiple fields. Select a field and click the Up or Down button to move the field. The data is sorted according to the order of the fields in the Sorting Priority area, from top to bottom.
465
6. Specify the sort order by clicking Ascending or Descending. 7. Make any required row height changes by modifying the Table Row Height value. Font Selection Area The Select Font button that opens the Font dialog box is included on all tabs.
1. Click Select Font from any tab. The Font dialog box opens. 2. Select the desired font options. Click OK to close the Font dialog box. SFC Display Area In the SFC View tab you can select the Show Expressions check box to indicate that you want the transition expressions to display in the SFC Area of the Procedure as SFC window.
The Line Width specifies the thickness of the lines that are used for the SFC structure.
466
You can configure the information displayed in the Batch List view. (See Column Display Area for more information.) The following data can be displayed:
Item Batch ID Description The user-entered or system-generated identification of the batch. Each Batch ID must be unique. If more than one batch has the same Batch ID, the Arbitration toolbar button and Arbitration tab in the SFC view displays the incorrect information. Additionally, the SFC Prompts tab displays all prompts making it difficult to associate prompts with the correct batch when duplicate Batch IDs are used. (See Customizing Batch IDs in the FactoryTalk Batch Administrators Guide for more information.) The name of the recipe associated with the batch. The description of the recipe. The time the batch was created. The elapsed time measured from the start time, which is updated after completion of a phase. Shows the current state of the batch. Displays the current mode of the batch. Displays the name of the process cell from which the recipe is using equipment. Displays the current unit in use by the batch.
Recipe Description Start Time Elapsed Time State Mode Process Cell Unit
467
Description Displays the phase that is currently running. Displays any failure information for the batch. Displays a tally of the number of overridden input parameter expressions that exist in the batches on the Batch List.
Possible Batch States (color-coded in SFC and Phase Control views) READY IDLE RESTARTING HOLDING STOPPING ABORTING Black Black Green Yellow Blue Magenta COMPLETE RUNNING STARTING HELD STOPPED ABORTED Black Dark Green Green Dark Yellow Dark Blue Dark Magenta
Possible Batch States for Automatic Upload/Download CONNECTING UPLOADING Green Dark Green DOWNLOADING UPLOAD HELD Green Dark Yellow
Possible Modes in the Mode Column AUTO (Automatic): MANUAL (Manual): The batch is running normally and is under FactoryTalk Batch Server control. No intervention is required to complete the batch. The batch is running manually and is under operator control. When a batch is placed in MANUAL mode, the current step is completed and the batch waits for you to specify the next step to run in the recipe (through a procedure called an Active Step Change). You must return the batch to the AUTO mode for the recipe to run to normal completion. The batch is running normally and is under operator control. When a recipe level is placed in SEMI-AUTO mode, the current step is completed but pauses at the next transition as it becomes true. You are required to issue the Resume command to sequence the recipe to the next step. You must return the batch to the AUTO mode for the recipe to run to normal completion.
S_AUTO (Semi-Auto):
468
2. Click Options. The Recipe List Options dialog box opens allowing you to specify the columns to display. (See Column Display Area for more information.)
If the System Configuration Login dialog box opens, click OK to continue.
3. Select a recipe in the Recipe List dialog box. Click OK. 4. If the recipe contains a material class-based phase, the Material Value Selection dialog box opens.
5. From the Material list, select the material you want to use in this particular batch, and then click Create.
469
If you are creating a batch of a material-based recipe and the FactoryTalk Batch Server has lost communication with the Material Server and is set to continue processing in MANUAL mode, the following warning displays: WARNING: MATERIAL SERVER NOT IN USE. You can continue to create and run the batch, but automatic binding will not occur. You are prompted to select the container/equipment module pair that can supply the correct material to continue processing the batch. Use extreme caution when operating without the Material Server. The container/ equipment module list is not filtered by the Material Server when it is unavailable. Failure to select the correct container/equipment module pair could result in a hazardous situation, depending on the material. (See Processing Batches Without the Material Server for more information.)
7. If a Batch ID is not automatically generated, type a unique Batch ID. The Batch ID can be comprised of any character except the following: The defined list separator, spaces, single or double quotes, brackets, parentheses, the percent sign (%), the tab character ( \t ), the carriage return character ( \r ), or the new line character ( \n ). The maximum length of the Batch ID is 255 characters.
If the Batch ID box appears dimmed, you cannot change it. The option to make the Batch ID editable is set by the system administrator in the System Configuration and Defaults dialog box on the General tab.
8. In the Batch Scale box, type a percentage by which you want to scale the recipe, if the batch is to be run at a percentage other than 100%. All phase parameters that were marked as scalable in the FactoryTalk Batch Equipment Editor and all operation or unit parameters that were marked as scalable in the FactoryTalk Batch Recipe Editor are adjusted proportionally by the percentage you enter. Any phase, unit, or operation parameters that are not marked as scalable are not adjusted; their values remain the same as the original value specified no matter how the batch is scaled.
470
9. If there are formula values that need to be assigned or modified, select the Value cell in the Formula Values area and enter a new value. If this is a class-based recipe, and the recipe has a unit allocation method of At Batch Creation or Operator Choice, you must specify the unit allocation requirements. If the unit allocation method is At Batch Creation, you must choose a specific unit from a list of the available units. If the unit allocation method is Operator Choice, then you can choose from a list of available units, or you can select the Prompt or First Available unit allocation methods. 10. Click the Bound Unit cell in the Unit Binding area to activate the Bound Unit list. Make an appropriate selection.
If the recipe does not require that any formula values be assigned, the Formula Values area contains a single blank row. Likewise, if the recipe does not require any unit binding, the Unit Binding area contains a single blank row.
11. Click Create to add the batch to the Batch List window. The Start Batch command button is enabled.
If control strategies are enabled for a recipe, changing the selected control strategy after the recipe is added to the batch list could corrupt that recipe.
471
472
CHAPTER 2
The Procedure as SFC window consists of three distinct sections that are separated by split bars. You can click and drag any of the splitter bars to resize the individual sections. If you drag the split bar that is between the SFC Area and the command buttons to the left, the Recipe Table area is revealed.
473
SFC Area
The SFC Area displays the SFC for the selected step in the Procedural Hierarchy View. You can view a different level of the SFC by double-clicking a step in the SFC; the steps SFC displays. There are also three view sizing buttons:
Decreases the display size Increases the display size Fits the display to the window size
Parameters tab The Parameters tab displays the parameters for the selected step of the batch. If a control strategy is enabled for the selected step, the control strategy displays at the top of the list and all parameters assigned to that control strategy are displayed below it. Parameters can be changed from this tab by double-clicking the parameter item and entering a new value
474
in the Update Parameter Value dialog box. Deferred parameters can only be viewed. (See the Recipe Editor Users Guide for more information about deferred parameters.)
If a parameter expression was used to determine the value of the parameter, you can display that information by double-clicking that parameter item to open the View Expression Parameter Value dialog box.
Like deferred parameter values, the expression value cannot be changed. However, there may be times when it is imperative to override the expression and assign a new value when responding to extraordinary circumstances. (See Overriding an Expression Value for more information.) Reports tab The Reports tab displays the reports for the selected step of the batch. If a control strategy is enabled for the selected step, only reports associated with that control strategy display.
475
If an expression was used to determine the value of a report, you can display that information by double-clicking a report item to open the View Expression Report Value dialog box.
Report parameters cannot be changed by the operator because that would be considered corrupting the record of the execution of a procedure. However, there may be circumstances where the value of a report causes needed operator interaction, for example, a force transition or a recipe parameter change:
A transition expression references the report parameter and its value is preventing the transition from firing. In this case, use the Force Transition option to force the transition to fire. (See Forcing a Transition to Fire for more information.) A recipe parameter is dependent on a report parameter to provide its value. If the report parameter is incorrect or undesirable, you can override the recipe parameter so that the recipe continues to run. (See Overriding an Expression Value for more information.)
Arbitration tab The Arbitration tab displays resource arbitration information in the context of the selected recipe element.
Once a batch is added to the Batch List view, control strategies associated with the batch cannot be reassigned. However, parameter and report values assigned to control strategies can be altered within the pre-defined ranges.
Binding tab The Binding tab displays the unit requirements for the step that is selected in the Procedural Hierarchy area or the SFC area. The information on the Binding tab includes: Unit Requirements for the Batch Procedure or the unit requirement associated with the step that is selected in the Procedural Hierarchy area or the SFC area, Binding Requirements associated with the step selected in the SFC or Table View, and Binding Preferences associated with the step selected in the SFC or Table View. At the unit procedure or unit operation level there is only one unit requirement.
Using the Binding Requirements and Preferences View
The Binding tab of the Auxiliary Index view is divided into 3 sections: unit requirements, binding requirements, and binding preferences.
476
A binding requirement is an object that can be evaluated against instances of a unit class to determine which instances of the class are legal bind candidates for a unit requirement. When attempting to bind a unit requirement during recipe execution, the entire set of binding requirements defined on the unit requirement is evaluated against each potential binding candidate. Units that are unable to meet every binding requirement defined on the unit requirement are eliminated as potential binding candidates for the unit requirement. A binding preference is an object that can be evaluated against an instance of a unit class in order to sort the legal bind targets for a unit requirement into a most preferred order.
Viewing Unit Requirements
The first section (Unit Requirements) displays all the unit requirements for the batch procedure or the unit requirement associated with the step that is selected in the Procedural Hierarchy area or the SFC area. At the unit procedure or operation levels there is only one unit requirement.
The middle section of the Binding tab of the Auxiliary Index view displays, when you select a step in the SFC or Table view for a batch procedure, the associated binding requirements are displayed in the Binding Requirements area. If the recipe is a unit procedure or operation, the binding requirements are displayed independent of a step being selected.
When the Binding tab of the Auxiliary Index view is first displayed, the Binding Requirements associated with the step selected in the SFC or Table view are displayed. If no step is selected, the Binding Requirements list is blank unless the recipe is a Unit Procedure or Operation.
Requirement Type: Displays the user-configurable bind requirement type. The possible types are: Require Phase, Reject Phase, Require Attribute, Reject Attribute, and Expression. Description: Displays a text description of the requirement and depends on the type of requirement selected. The description can be the Phase Name, Unit Attribute Name or
477
an Expression. The contents of the Description column depends on the Type selected. The table below summarizes the contents of the Description field for each requirement Type:
Bind Requirement Types Require Phase Require Attribute Reject Phase Reject Attribute Expression Description Phase name Unit Attribute name Phase name Unit Attribute name Boolean expression
Double-clicking a binding requirement expression in the Auxiliary Index view opens the Binding Requirement Expression Values view. It lists the units that are potential legal binding candidates for the unit requirement, a value indicating whether those candidates currently meet the selected binding requirement, and shows a list of the inputs used to evaluate the expression.
The content of the Expression is Boolean; it evaluates to Yes or No. This is the only expression allowed for a binding requirement. The values dynamically update as the inputs to the expression change.
Viewing Binding Preferences
On the Binding tab of the Auxiliary Index view, when you select a step in the SFC or Table view for a batch procedure, the associated binding preferences are displayed in the Binding preferences area. If the recipe is a unit procedure or operation, the binding preferences are displayed independent of a step being selected.
When the Binding tab of the Auxiliary Index view is first displayed, the Binding Preferences associated with the step selected in the SFC or Table view are displayed. If no step is selected, the Binding Preferences list is blank unless the recipe is a Unit Procedure or Operation.
478
Preference Type: Displays the bind preference type as configured by the user. The
possible types are: Prefer Phase, Avoid Phase, Prefer Attribute, Avoid Attribute, Minimize Expression, Maximize Expression and Boolean Expression.
Description: Displays a text description of the preference and depends on the type of preference selected. The Description can be the Phase Name, Unit Attribute Name or an Expression.
The contents of the Description column depends on the Type selected. The table below lists the contents of the Description field for each preference Type:
Bind Preference Types Prefer Phase Prefer Attribute Avoid Phase Avoid Attribute Expression Minimize Expression Maximize Expression Description Phase name Unit Attribute name Phase name Unit Attribute name Expression that must evaluate to Yes or No Expression to be minimized Expression to be maximized
The Binding Preference Expression Values view displays the result of evaluating the binding preference expression for each of the units that are potential legal binding candidates for the selected unit requirement. Double-click a binding preference in the Auxiliary Index view opens the Binding Preference Expression Values view. It lists the units that are potential legal binding candidates for the unit requirement, a value indicating the evaluation of the selected binding preference expression for that unit, and a list of the inputs used to evaluate the expression.
479
The content of the Expression depends on the Type selected. The table below lists the contents of the Expression field for each Type.
Bind Preference Types Boolean Expression Minimize Expression Maximize Expression Expression Expression that must evaluate True Expression to be minimized Expression to be maximized
The Recipe Level, Step Name, Step State and Mode displays for the selected step. The Binding Info or PAUSED text box also displays for the selected step. The information varies depending on the current step state. If the selected step is in the PAUSED mode, then PAUSED displays. Otherwise, the binding information for the selected step displays. If the step is bound, the name of the unit to which it is bound displays. If the step is not bound to a unit, then the unit requirement name displays. Steps waiting for an operator prompt, or unit availability, display BINDING in place of the unit name or unit requirement name. The SFC structure is color coded, allowing you to easily recognize the state of a specific step. (See Possible Batch States for more information.) The SFC structure displays the steps name on the first line of the step, regardless of the level being reviewed. Steps that represent unit procedures or operations display their binding information on the second line in the step. If the step is bound, then the name of the unit to which it is bound displays. If the step is not bound, then the unit requirement name displays. The steps current state displays in the lower left corner of the step, and the current mode displays in the lower right corner of the step. When a transition is paused, the SFC Area displays PAUSED to the left of the transition. When a step is acquiring resources, the SFC Area displays ACQUIRING to the left of the transition. To view the results of the transition expression evaluation, double-click the transition to open the Transition Expression dialog box. Transition expressions display to the right of the transition.
Transition conditions do not update dynamically in the FactoryTalk Batch View. You must reopen the Transition Expression dialog box to update the transition data.
command a batch from within the Procedure as Table window using the command buttons. The following commands can be issued from within the Procedure as Table window: (See Commanding a Batch for more information.)
Start Step | Resume Step | Restart Step Hold Step Stop Step Abort Step Reset Timer Step Force Timer Step to Complete Manual Semi-Auto Auto, Bind Active Step Change Clear All Failures
The Procedure as Table window consists of three distinct sections separated by splitter bars: the Procedural Hierarchy View, the Auxiliary Index View, and the Recipe Table Area. You can click and drag the splitter bars to resize the individual sections. If you drag the splitter bar between the Procedural Hierarchy View and the Recipe Table area to the right, the SFC area is revealed. (See Recipe Table Area or SFC Area for more information.)
Editors Server Options dialog box. (See the FactoryTalk Batch Equipment Editor Users Guide for more information.)
To associate electronic batch record (.evt) files with an application in Windows Explorer, you must show file extensions. If the file extensions are hidden, FactoryTalk Batch View is unable to find the .evt files.
2. Select the appropriate batch and click OK. The electronic batch record data displays in the Event Journal window for the selected batch.
482
When cross invocation is invoked from the Unacknowledged Prompts window, the PATH or CREATEID information (escape sequence %P ), for the selected prompt is only correct for the first menu selection. You must leave the Unacknowledged Prompts window and return to display the information correctly. (See FactoryTalk Batch Administrators Guide for more information.)
483
Acknowledging a Prompt
1. Open the Unacknowledged Prompts window by clicking the Unacknowledged Prompts button. 2. Double-click the prompt to be acknowledged. The Acknowledge dialog box opens with the current prompt data. 3. Type the appropriate value for the parameter. 4. Click Acknowledge to complete the response. The prompt is removed from the list when the acknowledgment is complete.
3. Select a lot or storage container to bind the material to, and click OK. The prompt is acknowledged and removed from the Prompts List.
484
If a user action generates a single Signature, the Signature dialog box for that Signature displays. For example, if you select the ABORT icon and a Command Verification Policy is configured in the area model for the ABORT command, the Command Signature dialog box opens.
The requested user information in a Signature dialog box is determined by the Signature Template defined in the area model. (See the Equipment Editor Users Guide for information on configuring Electronic Signature Templates.)
485
If a user action generates multiple Signatures, the Generated Signatures dialog box opens and lists the associated Signatures. (See Acknowledging a Set Parameter Signature for more information.)
Acknowledging a Signature
To acknowledge a signature, open the Signature dialog box and enter the Signoff information required for validation. 1. Click the flashing Signature List button to display the Signature List window.
486
3. Type the User ID and Password for the selected Signoff. 4. Type a Comment for the selected Signoff (if required). The Sign button is enabled. 5. Click the Sign button. The Signoff State changes to Complete.
The Signer must be listed under Security Requirements or be a member of one of the Groups in the list to complete a Signoff.
6. Select the next Incomplete Signoff and repeat steps 3 - 6. 7. When all Signoffs are Complete click the Close button. Selecting the Close button without completing a Signature closes the dialog box and leaves the Signature on the Signature List.
Signatures contain: Signoffs (1-3), Comments (Required|Optional|None), Last Signoff (Optional - marked with an asterisk).
Batch execution is suspended until the Signature is complete or Cancelled. The parameter value changes when the Signature is completed.
487
If a phase parameter has a Param Change Verification Policy and Deviation Limits defined, then changing the parameter to a value outside the defined limits generates two Signature requests which are displayed in the General Signatures dialog box.
Double-click one of the Signatures to open the associated dialog box. If you cancel one of the Signatures in a Generated Signatures dialog box, then all other Signatures within the Generated Signatures dialog box are System Canceled. If you close the Generated Signatures dialog box you can use the Signature List window to complete the necessary signatures.
The Signature List window, by default, displays only Incomplete Signatures. To display all Signatures, change the default setting.
488
The action associated with Command is not executed until the Signature request is complete. If a Command Signature request is canceled then the associated command is canceled. Command Verification Policies are configured in the Equipment Editor. You can configure verification poicies on the following commands:
ABORT is the exception. When an ABORT command is issued the command executes. Signature completion is required to remove the ABORTED batch from the batch list. The ABORT command cannot be cancelled by the user.
489
Force Transition Override Parameter Expression Value Clear Override Parameter Change Parameter Prompt Acknowledge Phase Bind Phase Bind Prompt Acknowledge Set Lots Set Labels Unit Bind Unit Bind Prompt Acknowledge
Parameter Deviation Signatures and Report Parameter Deviation Signatures are generated if an area model is configured to support Parameter Deviations and a recipe parameter value exceeds the defined limits. General Usage Signature requests are generated if a General Usage phase logic request is received during phase execution. (See the PCD Programmers Guide for more information on General Usage Phase Logic Requests.)
Selecting Yes cancels the Signature and the associated action. System cancelled Signatures are canceled with their associated actions.
Signoff Failures
Electronic Signatures are configured and authenticated using FactoryTalk Security. Only FactoryTalk users with assigned permissions are authorized to complete Signature Signoffs. If a user enters an invalid user name or password an entry is recorded in the Event Journal and the Signoff Failure dialog box opens. (For more information on Electronic Signature security see FactoryTalk Batch Administrators Guide.)
490
The Phase Control window consists of three areas. They are described in the following sections.
If Process Cell icons are changed, or units are added in the Equipment Editor, you must close and restart the FactoryTalk Batch View to display the changes in the Phase Control window.
491
There are three view sizing buttons: Decrease display size, Increase display size, and Fit display to window size. If the area model exceeds the viewable area of the Unit Display area, a scroll bar appears, allowing you to scroll through the area model. You can also click and drag the vertical split bar between this area and the Phase List Display area to enlarge or decrease the size of each area. When a unit is selected in the Manual Phase Control window, cross invocation does not pass the PATH or CREATEID information for the escape sequence, %P. (See FactoryTalk Batch Administrators Guide for more information.)
492
Commanding Phases
To directly manipulate a phase, you must first acquire it. A phase can only be acquired when it is not currently owned. The phase can be run from within the Phase Control window. This process is called manual phase control. You must release the phase when it is no longer needed, to make it available to other batches. Acquiring a Phase 1. Open the Phase Control window. 2. Select the phase to be acquired by clicking the phases button. 3. Click the Acquire button, and then confirm the command. The Opr light for the selected phase turns green, indicating the operator has control of the phase, and the mode changes to A.
If the phase you are attempting to acquire is running, the phase is acquired upon completion of that phase.
Acquiring a Material Phase 1. Open the Phase Control window. 2. Select the material-enabled phase to be acquired by clicking the phases button. 3. Click the Acquire button, and then confirm the command. The Opr light for the selected phase turns green, indicating the operator has control of the phase, and the mode changes to A.
If the phase you are attempting to acquire is running, the phase is acquired upon completion of that phase.
4. Click Start and then confirm the command. The Phase Control Feed Type and Material Selection dialog box opens.
5. If the phase is configured as both a material distribution and addition, select the type you need for this phase from the Feed Type list. If not, the configured Feed Type for the material phase is listed and cannot be changed.
493
6. Select a material to be acquired from the Material list, and click OK. The Phase Control dialog box opens to bind the equipment module.
7. Any configured containers associated with the selected material are listed in the Make a Selection to Bind Equipment Module area. Select a container that determines the requirements of the equipment module and the material to bind the MATERIAL step, and click OK.
If communication with the Material Server fails while you have the Phase Control dialog box open, all containers associated with the equipment module are displayed. The list is not filtered by the selected material. Use extreme caution when operating without the Material Server. Failure to select the correct container/equipment module pair could result in a hazardous situation, depending on the material. (See Processing Batches Without the Material Server for more information.)
You are returned to the Phase Control window. The batch state displays DOWNLOADING.
If the phase has Automatic Upload/Download configured, the Unacknowledged Prompts area displays a description of the prompt to be acknowledged. (See Acknowledging a Prompt for a Phase for more information.)
Starting a Phase 1. Acquire the appropriate phase. 2. Click Start to initiate the phase and then confirm the command. The Phase Control dialog box opens.
3. Type a unique batch ID for the manual phase control batch. If control strategies are enabled for the phase, select the appropriate control strategy from the Control Strategy list and then click OK.
Batch IDs must be unique or the Arbitration window will not update correctly.
494
Acknowledging a Prompt for a Phase 1. Acquire the appropriate phase, and then Start the phase. 2. Select the prompt to be acknowledged in the Phase Specific Display area. 3. Click Acknowledge. The Acknowledge dialog box opens. 4. Type the appropriate value for the prompt. 5. Click Acknowledge. The prompt is removed from the list when the acknowledgment completes. Resetting a Phase 1. Select the phase button for the phase to be reset. 2. Click Reset. If the phase has been run, it must be reset prior to being released. Releasing a Phase 1. Select the phase button for the phase that is to be released. 2. Click Release. The Opr light for the selected phase turns gray, indicating that you no longer own the phase.
If the Allow Override option is enabled under the Phase Control tab in the System Configuration and Defaults dialog box, you can enter a Batch ID other than the one that is automatically created. If Allow Override is not enabled, the automatically created Batch ID cannot be changed. The Allow Override option is only applicable if the Obtain From Unit option is enabled. (See Setting the System Configuration and Defaults for more information.) 1. Open the Phase Control window. 2. Select the unit in the Unit Display area on which the desired phase resides. The Phase List Display area displays the status and ownership of all phases in the unit. Phases that are not running are in IDLE status. 3. Select the desired phase in the Phase List Display area. 4. Click Acquire and the Opr button turns green when the phase acquisition is complete. 5. Click Start to initiate the phase. A confirmation dialog box opens prompting you to confirm that you want to start the phase. 6. Click Yes to start the phase, or No to cancel the phase initiation.
495
7. Type a unique batch ID when prompted and click OK to continue, or Cancel to cancel the phase initiation. The Phase button displays the current step index and the active state, both in the appropriate color. The mode displays next to the step index box as an A for operator-controlled AUTO mode. The phase transitions to the RUNNING state and then to the COMPLETED state after all steps are executed.
Batch IDs must be unique or the Arbitration window will not update correctly.
8. Once the phase is complete, it must be reset. Click the appropriate Phase button, and then click Reset. 9. Click Release. The Opr button is no longer illuminated, indicating that there is no current owner of the phase.
1. Select the Unit in the Unit Display area on which the desired phase resides. 2. Select the desired phase button in the Phase List Display area. The Phase List Display area displays the status and ownership of all phases in the unit. The phases that are not running are in IDLE status. 3. Click Acquire. 4. Click Start to initiate the phase. A confirmation dialog box opens prompting you to confirm that you want to start the phase. 5. Click Yes to start the phase, or click No to cancel the phase initiation. 6. Type the batch ID when prompted, and click OK to continue. This enables the Semi-Auto and Auto options in the Mode area. 7. Select the Semi-Auto option to initiate processing. The phase is automatically put into the PAUSED state, allowing you to manually process the phase using the Resume button. 8. Respond to any Unacknowledged Prompts. 9. The phase pauses at each pre-programmed break point. Click the Resume button to restart execution of the phase. The phase transitions to the RUNNING state and then returns to the PAUSED state when it reaches the next pre-programmed break point. The phase transitions to the COMPLETE state after all steps are executed.
496
10. With the appropriate phase button selected, click Auto to return the phase to the AUTO mode. 11. Click Reset. The phase transitions to the IDLE state. 12. Click Release. The Opr light is no longer illuminated, indicating there is no current owner for the selected phase.
Resources have a limited number of owners based on their definition in the area model. You can acquire a resource when it is not currently owned, or the number of current owners is less than the defined maximum number of owners. Only the current owner can release a resource. The Arbitration window consists of the following areas:
List Devices: The options in this area are used to specify the device focus type, which can be any or All of the following: Equipment, Phases, Recipes and Operator. The selection made here is used as the label for the Devices list. Devices list: This list contains a list of resources that match the device focus type selected
in the List Devices area. The name this list is contextual, based on the selection made in the List Devices area. For example, select the All option in the List Devices area and notice the text next to the devices list changes to All Devices. Select the Equipment option in the List Devices area, the list changes to Equipment and all items in the list are equipment items. Select the appropriate resource from the Devices list.
Command buttons: The Acquire (+) button allows you to gain ownership of an available resource, or to add Operator to the Needed By list. The Release (-) button allows you to
497
release ownership of a resource that you currently own. The Up Arrow and Down Arrow buttons allow you to prioritize the resources in the Needed By list. The View Previous button returns the Devices list to the previously selected resource. The Select button sets the highlighted resource as the active resource in the Devices list.
Current Profile: The Current Profile area displays ownership information for the selected resource. The information displayed depends on the resource selected.
Owns displays the resources that the selected operator, recipe, or equipment owns Owned By displays the operator, recipe, or equipment that owns the selected
resource Double-click a resource to select it as the active resource in the Devices list, or use the Select button.
Priority List: The Priority List area displays requirement information for the selected
resource. The information displayed depends on the type of resource selected. Recipes and Operator display the equipment and phases that need to be acquired. Equipment and phases display Operator or the name of the recipe that needs to acquire the resource. Double-click a resource, or use the Select button, to select it as the active resource in the Devices list.
Needs displays the resources that the selected operator, recipe, or equipment needs Needed By displays the operator, recipe or equipment that needs the selected
resource. The operator can re-prioritize the operator, recipe or equipment listed in the Needed By list.
498
generated and stops flashing when the Alarm Summary window becomes the active FactoryTalk Batch View window.
499
If the Phase Summary window does not display data, it is possible that the FactoryTalk Batch Server is not configured to support the Server API item used in this window. (For additional information, see the PhaseDataList item in the Server API Communication Language Reference guide.)
When a phase is selected in the Phase Summary window, cross invocation does not pass the CREATEID information for the escape sequence, %P. (See FactoryTalk Batch Administrators Guide for more information.)
500
CHAPTER 3
Commanding a Batch
Using FactoryTalk View, you can issue batch commands from the Batch List view, the Procedure as SFC window, or the Procedure as Table window. The command buttons are only enabled for commands that are valid for the batchs current conditions. The command buttons on the Batch List view affect the entire batch. The same command buttons on the Procedure as SFC and Procedure as Table windows affect any currently selected step that is in O-AUTO mode.
A step is any recipe level within the batch: Procedure, Unit Procedure, Operation or Phase. The defaults for the instructions given in this chapter for commanding a batch are Batch & Step Levels unless otherwise noted.
While commanding a batch, you may receive prompts that require operator input in order to continue processing the batch. These prompts display in the Unacknowledged Prompts window of the FactoryTalk Batch View.
Starting a Batch
A batch can only be started when it is in the READY state. A batch can be started from the following FactoryTalk Batch View windows: Batch List view, Procedure as SFC view, or Procedure as Table view.
Holding a Batch
This command temporarily stops execution of the batch at a step. A HELD batch can be RESTARTED, STOPPED or ABORTED. A batch can be held from the following FactoryTalk Batch View windows: Batch List view, Procedure as SFC view, or Procedure as Table view.
501
Restarting a Batch
Restarting a batch begins the execution of the batch that is in the HELD state. Unless there is an active step change, the batch restarts with the step that was the active step at the time the batch was HELD. A batch should not be restarted if there are phases associated with the batch that have failed or are in external control. A batch can be restarted from the following FactoryTalk Batch View windows: Batch List view, Procedure as SFC view or Procedure as Table view.
Aborting a Batch
The ABORT command is used to permanently stop the execution of a batch at the current step, and is generally used in emergency situations. You can abort a batch only when it is in one of the following states: RUNNING, STOPPING, HOLDING, HELD, or
502
3 Commanding a Batch
RESTARTING. A batch can be aborted from the following FactoryTalk Batch View windows: Batch List view, Procedure as SFC view or Procedure as Table view.
You cannot restart an ABORTED batch!.
Stopping a Batch
The STOP command is used to permanently stop the execution of a batch at the current step, and it is generally used in non-emergency situations. You can stop a batch only when it is in one of the following states: RUNNING, HOLDING, HELD, or RESTARTING. You cannot restart a STOPPED batch. A batch can be stopped from the following FactoryTalk Batch View windows: Batch List view, Procedure as SFC view, or Procedure as Table view.
You cannot restart an STOPPED batch!.
503
1. Double-click the recipe parameter expression containing the value you want to override. The View Expression Parameter Value dialog box opens.
2. Click the Override button. The Override Parameter Expression Value dialog box opens.
504
3 Commanding a Batch
3.
Enter the override value and click OK. The calculated value of the parameter expression is overridden with the new assigned value.
The new value remains valid until you click the Clear Override button, which commands the expression to evaluate again. The override information is captured in the event journal for the batch:
A transition expression references the report parameter and its value is preventing the transition from firing. In this case, use the Force Transition option to force the transition to fire.
It is strongly recommended that this command be used in conjunction with a command signature or FactoryTalk Security to require authorization before a transition can be forced to fire. See the FactoryTalk Batch Administrators Guide for information on configuring FactoryTalk Security on Batch View commands, or the Equipment Editor Users Guide for information on configuring Electronic Signature Templates and Command Policies.
505
2. Click the Force Transition button. Click OK to confirm that you want the transition to fire. 3. Complete the confirm or electronic signature, if configured. The transition fires immediately. A record of the force action is added to the event journal for the batch:
Recipe Modes
Understanding recipe modes is critical to understanding how to command a batch. The mode of a recipe defines how the recipe sequences from one step to the next when transition statements become true. There are three modes of procedural (recipe) control:
AUTO The recipe automatically progresses from step to step when its transition conditions become true. SEMI-AUTO The recipe does not progress to the next step when its transition conditions become true, until the operator commands the recipe to resume. MANUAL The operator has complete control over the execution of steps within a
recipe.
AUTO Mode
In AUTO mode, the recipe automatically progresses from step to step when its transition conditions become true. There are two types of AUTO mode:
operator.
P-AUTO (Procedure-Auto) A recipe step in P-AUTO mode can only be commanded by the higher-level recipe step to which it belongs.
506
3 Commanding a Batch
The highest recipe level is usually in O-AUTO mode while all subordinate recipe steps are in P-AUTO mode. Once the operator commands the highest level of the recipe (which is in O-AUTO mode) to start, the subordinate steps further down in the recipe hierarchy are automatically put into P-AUTO mode.
SEMI-AUTO Mode
In SEMI-AUTO mode, the recipe does not progress to the next step when its transition conditions become true, until the operator commands the recipe to resume. In SEMIAUTO mode, the FactoryTalk Batch Server stops normal sequencing. Once you place a recipe step in SEMI-AUTO mode, all higher-level recipe steps that contain the SEMIAUTO step are automatically placed in MANUAL mode. When a lower-level recipe step has stopped normal sequencing, all higher-level recipe steps that contain it also stop normal sequencing.
MANUAL Mode
In MANUAL mode, the operator has complete control over the execution of steps in a recipe. In MANUAL mode, the FactoryTalk Batch Server stops normal sequencing. Once a recipe step is placed in MANUAL mode, the lower level steps it contains are placed in O-AUTO mode. As a result, if a step is placed in MANUAL mode, the operator can command any lower level steps it contains. Furthermore, when a step is placed in MANUAL mode, the higher-level steps that contain it are also automatically placed in MANUAL mode. When a lower-level recipe step has stopped normal sequencing, all higher-level recipe steps that contain it also stop normal sequencing. When a step is placed in MANUAL mode, the steps which contain it further up in the recipe hierarchy are also automatically placed in MANUAL mode. For example, if an operation within a procedure-level recipe is placed in MANUAL mode, the phases that the operation would normally command are automatically put into OAUTO mode so they can be directly controlled by the operator. In addition, the unit procedure that contains the operation, which has been placed in MANUAL mode, is automatically put into MANUAL mode. The procedure that contains the unit procedure is also automatically put into MANUAL mode.
If a higher-level Procedure is placed into O-AUTO or P-AUTO, the mode of the Timer step will be set to P-AUTO. If the level immediately above the procedure containing the Timer step is placed into MANUAL, the mode of the Timer step changes to O-AUTO.
507
If the procedure containing the Timer step is placed into MANUAL all recipe levels above the Timer step procedure will be placed into MANUAL. If the procedure containing the Timer step is placed into AUTO (only possible when current mode is MANUAL), the Timer step will transition to O-AUTO mode.
While the mode of a Timer step has no effect on its operation, the Timer step must be in O-AUTO before it can be Reset or forced to Complete.
508
3 Commanding a Batch
second unit procedure, you must place the procedure in AUTO mode. The batch then continues to execute normally and runs to completion. A batch or step can be placed in SEMI-AUTO mode when it is in MANUAL or AUTO mode. A batch can be placed in SEMI-AUTO mode from the following FactoryTalk Batch View windows: Batch List view, Procedure as SFC view, or Procedure as Table view. 1. In the Batch List view, select the batch that is to be placed in SEMI-AUTO mode. 2. Open the appropriate FactoryTalk Batch View window. 3. Select the recipe level that is to be placed in SEMI-AUTO mode. If the Batch List view is the active window, the highest procedure level is placed in SEMI-AUTO mode. 4. Click Semi-auto. Any higher level steps are placed in MANUAL mode, all lower level steps are placed in P_AUTO mode, and the selected step are placed in S_AUTO mode. The active step completes its processing, and execution pauses at the next transition as it becomes TRUE. 5. When you are ready to continue execution, select the step that is to be resumed. 6. Click the Resume Batch or Resume Step button, and the step transitions to the RUNNING state. 7. Repeat steps 57 until each of the subordinate steps have been run. 8. You can now place the batch in AUTO mode and continue normal execution, perform an active step change, or perform semi-auto processing at another recipe level.
Any higher-level recipes that contain the step you put into MANUAL mode, also go into MANUAL mode. Any lower-level steps contained by the recipe step in MANUAL mode go into OAUTO mode
A batch or step that is placed in MANUAL mode allows any lower-level active step(s) to complete, but the lower-level steps will not automatically transition to the next step. You can place a batch or step in MANUAL mode from the following FactoryTalk Batch View windows: Batch List view, Procedure as SFC View, or Procedure as Table View. 1. In the Batch List view, select the batch that contains the step you want to place in MANUAL mode. 2. Open the appropriate View window (Procedure as SFC View or Procedure as Table View). 3. Select the lowest appropriate recipe level containing the steps you want to command. (For example, if you want to command a phase, select the operation that contains it. If you want to command an operation, select the unit procedure that contains it.)
509
4.
Click the Manual button. The batch then completes the active step and the step transitions to the COMPLETE state. The batch must be placed in AUTO mode to resume automatic execution.
For example, assume you have a recipe consisting of two unit procedures in succession. The first unit procedure consists of three operations: the first two operations run in parallel and the third follows the two parallel operations. Once you start the batch, you place the first unit procedure in this recipe into MANUAL mode. This causes the FactoryTalk Batch software to place the procedure into MANUAL mode. Furthermore, since the unit procedure that contains the two parallel operations is in MANUAL mode, the mode of the two parallel operations changes to O-AUTO and they execute normally. However, execution halts prior to starting the next operation. You must now either perform an Active Step Change to specify the next operation to execute (which you can do since the mode of the operation is O_AUTO) or return the unit procedure to AUTO mode. If you return the unit procedure to AUTO mode, it continues to execute normally but execution stops prior to starting the second unit procedure because the procedure is still in MANUAL mode. To start execution of the second unit procedure, you must place the procedure in AUTO mode to resume normal sequencing.
To reset a Timer step, select the step in the SFC or Table view, and then click the Timer-Reset button. When a Timer step in the RUNNING or HELD state receives the Timer-Reset command the ELAPSED_TIME report will be reset to 0. If the Timer step is configured as a COUNT_DOWN timer the REMAINING_TIME report will be reset to the setpoint value. If the Timer-Reset command is issued and the command is no longer valid, due to a change of state for example, the command is ignored. (See Auxiliary Index View for information on viewing reports and parameters.)
To force a Timer step to Complete, select the step in the SFC or Table view, and then click the Timer-Complete button. When a Timer step is in the RUNNING state and receives a Timer-Complete command the Timer step will transition to the COMPLETE state. If a Timer-Complete command is issued and the command is not longer valid due to a change of state for example, the command is ignored.
510
3 Commanding a Batch
2. Select the Parameters tab to view the Hold Behavior, Setpoint (COUNT_DOWN timers only) , and Timer Type for the selected Timer step.
3. Double-click anywhere in the SETPOINT row. The Change Parameter Value dialog box opens.
4. Type a new setpoint value in the Value box, and then click OK. The value entered must be within the displayed minimum and maximum values for the parameter. If the value is between the minimum and maximum values when you click OK the new value is sent to the Timer step. If the value is not between the minimum and maximum values, an error message requests Please enter a value between the configured Minimum [Minimum Value] and Maximum [Maximum Value] values. Click OK to enter a new value. 5. Click OK to close the Properties dialog box and apply the change.
You can change the active step in a batch as long as the recipe level that contains the steps requiring the Active Step Change is in MANUAL mode. For example, if you want to command phase steps, the operation must be in MANUAL mode. Steps that are in the HELD state cannot be removed as the active step. An active step change can be performed in the Procedure as SFC or Procedure as Table views, although it is recommended that it be performed within the Procedure as SFC view. 1. In the Batch List view, select the batch that requires an active step change. 2. Open the Procedure as SFC or Procedure as Table view. 3. Select the procedure in the Procedural Hierarchy View section. 4. Select the recipe level that contains the active step to be changed and place this recipe level in MANUAL mode. a. If the Procedure as SFC view is the active window, select the recipe level that contains the active step to be changed. Place this recipe level in MANUAL mode.
511
Double-click the selected step in the SFC. This displays the steps within this recipe level.
b. If the Procedure as Table view is the active window, select the level that requires the active step to be changed. Place this recipe level in MANUAL mode.
Switch to the Procedure as SFC view. Double-click the selected step in the SFC. This displays the steps within this recipe level. Switch back to the Procedure as Table view.
c. If a step to activate is a material phase step, you must first bind the step to an equipment module before doing the Active Step Change. Select each material step that you want to activate and perform a manual bind. (See Performing Material Binding for more information.)
4. After the currently active steps are in a quiescent state (COMPLETE, STOPPED, or ABORTED), click the Active Step Change button.
.
The active step(s) changes to a gray background and is outlined in yellow after clicking the Active Step Change command button. In addition, the cursor changes to a hand shape. Use the cursor to toggle steps between activated and deactivated status.
5. A new set of command buttons displays: Execute ASC and Cancel ASC. 6. Position the Hand cursor over the quiescent step(s) and click to deactivate them. The yellow outline changes to dark blue. 7. Using the Hand cursor, click the new step(s) to activate. The outline changes to green. 8. Click the Execute ASC button to accept the active step change, or click the Cancel ASC button to cancel the active step change. A confirmation message displays before the active step is changed. 9. Click Yes. You are returned to the appropriate Batch View window. The new active step(s) display a READY state.
If you did not bind a material phase step to an equipment module, you are prompted to bind the step, and then you must begin the Active Step Change again.
10. Select the new active step in the Procedural Hierarchy View section; it is in the READY state and in O_AUTO mode. Any subsequent steps in the recipe that have already completed are reset. This allows you to place the batch in the AUTO mode, and process the balance of the batch normally. 11. Click Start Step to start the step. The step runs and returns to a completed state when it is finished. 12. Place the batch in AUTO mode to complete normal execution.
512
3 Commanding a Batch
Manual binding is the process of binding a unit, or rebinding a previously bound unit, to a step within a control recipe without being prompted to do so. Manual binding must be performed from within the Procedure as SFC or Procedure as Table view. The following criteria must be met to perform manual binding:
The step is associated with a unit class in the recipes equipment requirements. The step represents the highest recipe level wholly contained within the unit. (For example, one step in the recipe represents a unit procedure that is associated with the Premixer unit class, and another step that is associated with the same Premixer unit class is an operation. As long as the balance of the manual binding requirements are met, then you can manually bind the unit procedure, but not the operation, since the unit procedure is the highest recipe level associated with the unit.) The step is inactive or has a binding status of BINDING. More than one legal binding choice exists for the unit that is associated with the step.
All other steps within the recipe that are associated with the same unit requirement are bound to the same unit.
1. In the Batch List view, select the batch that requires binding. 2. Open the Procedure as SFC or Procedure as Table view. 3. To bind a unit to a step, you must select the unit procedure in either the SFC Area, Recipe Table Area or the Procedural Hierarchy. If the control recipe was created from an operation or unit procedure, then select the parent of the SFC. If the manual binding criteria is met, the Bind command button is enabled. 4. Click Bind and the Manual Bind of Step (if the highest level is Procedure) or Manual Bind of Batch (if the highest level is Operation) dialog box opens with a list of binding options.
5. Select the appropriate binding option and click OK. You are returned to the appropriate Batch View view.
513
Material binding is the process of binding activate material-enabled phase steps to material equipment modules, or rebinding a previously bound material to a step within a control recipe without being prompted to do so. Material phase binding must be performed from within the Procedure as SFC or Procedure as Table view. The following criteria must be met to perform manual binding:
The step is associated with a material in the recipe. The step is inactive or has a binding status of BINDING.
1. From the Batch List view, select the batch that requires binding. 2. Open the Procedure as SFC or Procedure as Table view. 3. To bind a material to a step, you must select the Material step in either the SFC Area, Recipe Table Area or the Procedural Hierarchy. If the manual binding criteria have been met, the Bind command button is enabled. 4. Click the Bind button, and the Prompt to Bind a Material Phase Step dialog box opens with a list of legal binding options.
5. Select the material specification that determines the lot or storage container to bind the material step, and then click OK. You are returned to the appropriate FactoryTalk Batch View window.
Prompted binding is the process of binding a unit to a step after a prompt is generated. Only unit class requirements that are defined with the Prompted Binding method generate a prompt, including those that are defined as such at the time the batch is created. The execution of the batch pauses when the transition above the unbound step becomes
514
3 Commanding a Batch
True. A prompt displays in the Unacknowledged Prompts view and on the Prompts tab of the Auxiliary Index view in the Procedure as SFC or Procedure as Table view.
All other steps within the procedure that are associated with the same unit requirement are bound to the same unit.
1. In the Batch List view, select the batch that requires binding. 2. Locate the prompt in the Unacknowledged Prompts view, or in the Prompts tab of the Auxiliary Index View in the Procedure as SFC view. 3. Double-click the prompt. The Prompt to Bind Unit Requirement dialog box displays with a list of available units.
4. Select the unit to bind to the step, and click OK. The prompt is removed from the list when the acknowledgment is complete.
Batch Batch Recipe Phase Operation Unit Procedure Batch Unacknowledged Prompts (not binding requests) Process Cell Unit Equipment Phase Batch Process Cell Unit Equipment Phase Operation Unit Procedure No elements applicable No elements applicable Equipment Phase
Arbitration
516
3 Commanding a Batch
1. In the View window, select the available element, and click the Go To HMI button. The configured shortcut menu appears.
2. Select a menu item or sub-menu item to send context data to the Automation Server.
Check with your system administrator to determine what context data is configured for each of the shortcut menu items displayed on your system.
517
518
CHAPTER 4
Troubleshooting
When running batches, you may occasionally encounter situations that are difficult to resolve. This section provides solutions to some of the problems you may encounter.
Issue The following error displays when running a batch: Recipe SFC Requires Illegal Use of Dedicated Resources, and the batch goes into a HELD state. Solution Parallel steps requesting the same equipment module cannot occur just after an AND Divergence.
Abort or Stop the batch. Remove the batch from the batch list. Revise the recipe to include a null procedure before each of the parallel steps after the AND Divergence. Create and run a batch using the new recipe. (See the Recipe Editor Users Guide for information on adding null phases to a recipe.)
A batch appears to be running, but it is not progressing as it should. No errors are generated. The status is RUNNING.
Parallel steps requesting the same equipment module cannot occur just before an AND Convergence.
Abort or Stop the batch. Remove the batch from the batch list. Revise the recipe to include a null procedure after each of the parallel steps before the AND Convergence. Create and run a batch using the new recipe. (See the Recipe Editor Users Guide for information on adding null phases to a recipe.)
A failure is generated and the batch is held because the batch server selected an equipment phase under EXTERNAL control to bind to during batch execution.
Phases put into an external state can still be viewed as binding candidates by the FactoryTalk Batch Server. (The external state is a tag in the controller that prevents the Server from controlling the phase.) In order to remove a phase from being viewed as a binding candidate, you must take ownership of the phase. (For more information on the External attribute, see the PCD Programmers Guide.) (For more information on taking ownership of a phase, see Acquiring a Phase.)
519
520
Batch
521
CHAPTER 1
Document Organization
The information presented in this document should minimize the effort required to archive the batch data to a database. This manual presents the following subjects:
Introduction to the FactoryTalk Batch Archiver Working with Electronic Batch Records Creating a Data Source Using the FactoryTalk Batch Archiver Creating a Custom Archiver Using the Windows Event Log FactoryTalk Batch Archiver Setup for FactoryTalk Historian Classic for Batch Users
Overview
The FactoryTalk Batch Archiver collects data from the electronic batch record files (.evt files) generated by the FactoryTalk Batch Server and stores the data in a specified Open Database Connectivity (ODBC)-compliant relational database. Rockwell Automation recommends using a high-performance database such as SQL Server due to the superior robustness and performance of these products.
The FactoryTalk Batch Archiver requires an ODBC-compliant database that supports stored procedures, such as SQL Server 2005 Service Pack 3. Database platforms that do not provide stored procedure support, such as Microsoft Access, cannot be used with the Batch Archiver.
The FactoryTalk Batch Server creates an electronic batch record for every batch on the Batch List. While these files may be viewed with a word processor or spreadsheet, many plants have implemented one of the many commercially available Relational Database Management System (RDBMS) software packages. The Batch Archiver collects data from each electronic batch record file and places it in the specified RDBMS database, allowing you to store the electronic batch record data in this format.
523
You can configure the FactoryTalk Batch Archiver to archive batch data to the RDBMS database in either of two ways:
When using End-of-Batch archiving, the Batch Archiver inserts records into the RDBMS database when a batch is removed from the batch list. In this case, the Batch Archiver runs as a software program and is initiated by the FactoryTalk Batch Server. When using Incremental archiving, the Batch Archiver inserts records into the RDBMS database on a pre-defined schedule. In this case, the Batch Archiver runs as a Windows service. You can configure the archiving time interval in the FactoryTalk Batch Equipment Editor Server Options dialog box. (See Configuring the Reporting Option for more information.) When the operator creates a control recipe, the FactoryTalk Batch Server adds the electronic batch record file name to the FactoryTalk Batch Archivers work queue file (Archque.txt). After the Batch Archiver successfully inserts all of the electronic batch records into the database, it removes the electronic batch record file name from the work queue file. The Batch Archiver does not delete the electronic batch record file unless it is specifically configured to do so. If the FactoryTalk Batch Archiver cannot successfully insert each item from the electronic batch record file, it does not remove the file name from the Batch Archivers work queue file. Every time the Batch Archiver runs, it attempts to insert the records from each file listed in the queue into the RDBMS database. In this manner, the Batch Archiver attempts to store the data at a later time in the event of a failure. This mechanism ensures that failures such as networking problems do not result in a loss of archived data.
If the system fails while the FactoryTalk Batch Archiver is in the process of inserting a files records, the Batch Archiver does not remember where it was in the record insertion process. When the Batch Archiver is restarted, it attempts to insert all of the files records, which may result in duplicate records in the target database. When the FactoryTalk Batch Archiver is configured to run at the end of a batch, the FactoryTalk Batch Server runs the Batch Archiver as a Windows IDLE_PRIORITY process. If the system is busy, the Batch Archiver is superseded by higher-priority functions, which slows the archiving process.
System Architecture
You can configure the FactoryTalk Batch Archiver to run as a software program (for endof-batch archiving) or as a Windows service (for incremental archiving). The Batch Archiver uses ODBC (Open Database Connectivity) technology to communicate with any of several ODBC-compliant databases. Table creation scripts are provided for Microsoft SQL Server. (See Creating a Data Source for more information.)
524
The following diagram illustrates the sequence of events that occur when the FactoryTalk Batch Server initiates the Batch Archiver to insert batch record data into your RDBMS database.
1
The operator or MES (Manufacturing Execution System) starts a batch. The FactoryTalk Batch Server creates an electronic batch record file. The FactoryTalk Batch Server adds the name of the electronic batch record to the electronic batch record directory file, EventDir.txt. The FactoryTalk Batch Server incrementally writes to the FactoryTalk Batch Archivers queue file, ArchQue.txt. The data in this file consists of the path to the electronic batch record file, and if the batch is removed from the batch list, a tab and the word REMOVED follows the file name.
Operator/MES Archiver Queue ArchQue.txt 1 4 Recipe Execution (Batch Server) 3 2 *.evt files 6 5 FactoryTalk Batch Archiver 9
7 8
ODBC
Non-Incremental (End-of-Batch) Archiving: When a batch is removed from the batch list, the FactoryTalk Batch Server initiates the Batch Archiver. For End-of-Batch archiving, the Batch Archiver runs as a software program and the Batch Archiver service must be disabled.
For Incremental archiving, the FactoryTalk Batch runs as a Windows service on a predefined schedule. The service must be enabled at all times during batch processing. 6 7 8 9
The Batch Archiver reads the ArchQue.txt file for the name of the electronic batch record file and the status of the batch. The Batch Archiver reads the electronic batch record file. The Batch Archiver inserts records into a database via ODBC. If electronic batch record data is inserted into the database successfully, the file name is removed from the ArchQue.txt file. batch record file listed in the ArchQue.txt file into your database.
10 Steps 5-9 are repeated until the Batch Archiver has attempted to insert each electronic
525
Implementation Overview
Implementing the FactoryTalk Batch Archiver involves five distinct steps:
The first step to implement the FactoryTalk Batch Archiver requires creating the RDBMS database where the FactoryTalk Batch Archiver will archive data from the event journals (.evt files).
After creating the database, the second implementation step involves configuring a Data Source name for the RDBMS database. The Data Source name functions as an alias for the database used by the Batch Archiver.
Once the Data Source name is established, the next step is setting up the ODBC Connect String. The FactoryTalk Batch Archiver uses this string to locate the appropriate RDBMS database where it archives data.
Configuring the Batch reporting option in the Equipment Editors Server Options dialog box
When the Data Source is generated, you will then configure the reporting option. This is done using the Batch Reporting tab of the Equipment Editor Server Options dialog box. The reporting options that can involve the FactoryTalk Batch Archiver include Archiver (End-of-Batch) and Archiver (Incremental).
The final step to implementing the FactoryTalk Batch Archiver requires configuring the Batch Archiver service. Configuring the service is a function of the selected reporting option. The first three steps are covered in the Creating a Data Source chapter. The last two steps are discussed in the Implementing the FactoryTalk Batch Archiver chapter.
526
CHAPTER 2
To see whether a level (e.g., operation) became active, look through the Description column and find the phrase Operation Started, Step Activated, etc. The EU column will contain the word Phase if the step activated is a phase.
527
Example: Recipe 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1\CHAR GE:1-1 12:TPROC\TUP:1\TRANCT:1\CHAR GE:1-1 Description Step Activated State Changed: State Changed: PValue CHARGE:1 RUNNING COMPLET E EU Pha se Phase ICE_CRE AM CHARGE A CHARGE A
To evaluate a transfer of control, you will find entries showing the continuous phases involved becoming active and idle in turn. However, only the final continuous phase will show that it completed. In other words, if a transfer of control involved three instances of the same phase running in sequence, the first would start and become idle, then the second would start and become idle, and finally the third would start and become complete. The following example shows the state changes of an entire operation that contains a transfer of control operation in which a RECIRC phase occurs both before and after a transition:
Recipe 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1\RECIR C:2-1 12:TPROC\TUP:1\TRANCT:1\CHAR GE:1-1 12:TPROC\TUP:1\TRANCT:1\RECIR C:2-1 12:TPROC\TUP:1\TRANCT:1\CHAR GE:1-1 12:TPROC\TUP:1\TRANCT:1\CHAR GE:1-1 12:TPROC\TUP:1\TRANCT:1-1 Description Operation Started State Changed: Step Activated Step Activated Step Deactivated State Changed: State Changed: State Changed: State Changed: State Changed: Step Activated PValue 0 RUNNING RECIRC:2 CHARGE:1 Initial Step IDLE IDLE RUNNING RUNNING COMPLET E CHARGE_ B:1 Pha se RECIRC1 CHARGE A RECIRC1 CHARGE A CHARGE A CHARGE B Pha se Pha se RECIRC1 CHARGE A EU Phase
528
Recipe 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1\CHAR GE:1-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1\RECIR C:3-1 12:TPROC\TUP:1\TRANCT:1\RECIR C:3-1 12:TPROC\TUP:1\TRANCT:1\RECIR C:3-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1\CHRG _B:1-1 12:TPROC\TUP:1\TRANCT:1\CHRG _B:1-1 12:TPROC\TUP:1\TRANCT:1\CHRG _B:1-1 12:TPROC\TUP:1\TRANCT:1\RECIR C:3-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1\CHRG _B:1-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1\RECIR C:3-1 12:TPROC\TUP:1\TRANCT:1-1 12:TPROC\TUP:1\TRANCT:1-1 12:TRNPROC\TRANUP:1-1 12:TPROC\TUP:1\TRANCT:1-1
Description Step Activated State Changed: Step Deactivated State Changed: Owner Changed: Attribute Change Step Deactivated State Changed: State Changed: State Changed: State Changed: Step Activated State Changed: Step Deactivated State Changed: Step Deactivated State Changed: Step Activated Operation Done
PValue RECIRC:3 IDLE CHARGE:1 RUNNING PROGRAM PAUSED off RECIRC:2 IDLE RUNNING COMPLET E COMPLET E Terminal Step IDLE CHARGE_ B:1 IDLE RECIRC:3 COMPLET E Terminal Step 0
EU Pha se
Pha se
Pha se
529
530
CHAPTER 3
Creating the RDBMS database Configuring a Data Source name for the RDBMS database Creating the ODBC database connect string
While you can archive FactoryTalk Batch data to a variety of Relational Database Management System (RDBMS) software packages, Rockwell Automation recommends using SQL Server 2005 SP3. The instructions contained within this document are specific to these two applications.
The FactoryTalk Batch Archiver requires an ODBC-compliant database that supports stored procedures, such as SQL Server 2005 SP3. Database platforms that do not provide stored procedure support, such as Microsoft Access, cannot be used with the Batch Archiver.
Creating the RDBMS Database The first step to implementing the FactoryTalk Batch Archiver is to create the RDBMS database where the Batch Archiver will archive data from the event journals (.evt files). Scripts to create the SQL Server databases (with a default database table name of BATCHHIS) are provided in the C:\Program Files\Rockwell Software\Batch\History folder. Configuring the Data Source Name After generating the database where the FactoryTalk Batch Archiver will archive data, the second step requires configuring a Data Source name for the RDBMS database. The Data Source name functions as an alias for the database used by the Batch Archiver. The Data Source name may be produced in one of two ways:
While the Data Source name may be manually created using ODBC, the instructions in this chapter specifically use the FactoryTalk Batch Archiver Setup application to create both the Data Source name and the ODBC database connect string. Creating the ODBC Connect String In addition to creating the Data Source name, the FactoryTalk Batch Archiver Setup application also creates the ODBC Connect String. The Batch Archiver uses the ODBC
531
Connect String to locate the appropriate RDBMS database for archiving data. Once created, the ODBC Connect String is stored in the BatchArc.ini file. Other Required Steps After creating the data source for SQL Server, configure the FactoryTalk Batch Archiver for Incremental or End-of-Batch archiving. This involves configuring the FactoryTalk Batch Equipment Editor Server Options as well as the Batch Archiver service. These instructions are included in the next chapter, Implementing the FactoryTalk Batch Archiver.
Pack 3. This section assumes that the SQL Server software is running on a different computer than the computer where the FactoryTalk Batch Server and FactoryTalk Batch Archiver software are installed.
It is highly recommended that the SQL Server software runs on a separate computer than the FactoryTalk Batch Server and the FactoryTalk Batch Archiver applications.
532
3. Click New. The Create New Data Source dialog box opens. 4. Select System Data Source (applies to this machine only), and then click Next. 5. From the Select a driver for which you want to set up a data source area, scroll down and select SQL Server, click Next, and then click Finish. The Create a New Data Source to SQL Server dialog box opens. 6. In the Name box, type a name for the data source (such as Batch Archiver). 7. In the Description box, type a description of the data source (such as FactoryTalk Batch Historical Data). 8. From the Server list, select the SQL Server to which you want to connect (if the SQL Server is on this machine, select local), and then click Next.
When using Incremental Archiving, the user account assigned to the FactoryTalk Batch Archiver service must be granted login access to SQL Server and must have permission to insert data into the BATCHHIS table. When using End-of-Batch Archiving, the user account assigned to the FactoryTalk Batch Server must be granted access to the BatchHistory database on the SQL Server and must have permission to insert data into the BATCHHIS table. The Servers user account must be a member of the local Administrators group on the SQL Server computer.
9. Select how SQL Server should verify the authenticity of the login ID as follows:
If you are not using the Batch Archiver in conjunction with FactoryTalk Historian Classic for Batch, select With Windows NT authentication using the network login ID. If you are using the Batch Archiver in conjunction with FactoryTalk Historian Classic for Batch, select With SQL Server authentication using a login ID and password entered by the user.
533
The login ID specified must be that of the user who created the RSBizWare database. (See Creating a Data Source for FactoryTalk Historian Classic for Batch for more information.)
10. Make sure Connect to SQL Server to obtain default settings for the additional configuration options is selected, and then click Next. 11. Select the database file name as follows:
If you are not using the Batch Archiver in conjunction with FactoryTalk Historian Classic for Batch, check the Change the default database to box, and select BatchHistory from the pull-down list If you are using the Batch Archiver in conjunction with FactoryTalk Historian Classic for Batch, select the name of the appropriate RSBizWare database, not the Batch History database. (See Creating a Data Source for FactoryTalk Historian Classic for Batch for more information.)
12. Select Use ANSI quoted identifiers and Use ANSI nulls, paddings, and warnings, and then click Next. 13. Select Perform translation for character data, and then click Finish. The ODBC Microsoft SQL Server Setup dialog box opens.
14. Click Test Data Source. The results display in the Test Results area. 15. If the test is successful, click OK to close the SQL Server ODBC Data Source Test window. If the test is not successful, consult your system administrator.
534
16. Click OK to exit the ODBC Microsoft SQL Server Setup dialog box, and return to the Select Data Source dialog box.
17. Select the Machine Data Source tab. Select the new data source as shown above, and then click OK.
535
536
CHAPTER 4
Configuring the Batch reporting option in the FactoryTalk Equipment Editors Server Options dialog box Configuring the FactoryTalk Batch Archiver service
Configuring the Reporting Option Configure the reporting option on the Batch Reporting tab in the FactoryTalk Batch Equipment Editors Server Options dialog box. You can choose one of the following reporting options:
periodic interval. Configuring the Archiver Service The final step for the FactoryTalk Batch Archiver implementation is configuring the Batch Archiver service. Configuring the service is a function of the selected reporting option.
Archiver (End-of-Batch) The Batch Archiver service must be disabled since the
FactoryTalk Batch Server initiates the FactoryTalk Batch Archiver when a batch is removed from the batch list.
Archiver (Incremental) Since the FactoryTalk Batch Archiver runs as a service on a periodic interval, the Batch Archiver service must be assigned a Windows user name and the service must be enabled.
537
2. From the Options menu, select Server Options. The Server Options dialog box opens to the Project Settings tab. 3. Select the Batch Reporting tab.
Starting with FactoryTalk Batch version 9.0, the Report Editor functionality was phased out. If you are currently using this feature, it is recommended that you begin transitioning to a different reporting application, such as FactoryTalk Historian Classic for Batch or another third-party application.
4. In the Reporting Application area, select either Archiver (End-of-Batch) or Archiver (Incremental). 5. In the Table Name box, type the name of the data table where the batch data is archived. The default table name created by the supplied scripts is BATCHHIS. 6. If Archiver (Incremental) is selected, enter the time period between active archiving in the Incremental Period box, and then select Minutes or Seconds. The minimum setting is 5 seconds. The maximum is 9999 minutes.
If a value outside of this range is entered, the FactoryTalk Batch Archiver will run in 5minute incremental periods.
The database connect string is automatically entered in the Database Connect String box. This was configured when the Batch Archiver Setup function created the database connect string.
538
Material Server Filters are only displayed if Material Manager is installed. eProcedure Filters are displayed only if eProcedure is installed.
8. Select the data that you want to archive from the Batch event journal files (.evt).
You cannot filter out data added to the Batch event journal files (.evt) by the ADDEVENT execute. The date format used for the event journal files LclTime is YYYY.MM.DD HH:MM:SS and is not configurable, regardless of the language being used.
9. Click OK. (See the FactoryTalk Batch Administrators Guide for more information on the Server Options dialog box.)
539
user account specified during the installation. You can use the Local System account instead of the Server user account if archiving data only to the local computer.
The FactoryTalk Batch Archiver cannot log into the database when the database account uses special characters. To avoid this problem on Windows Server 2008 systems using Active Directory, change the default format of user@domain.com to domain\user.
1. Click the Start button, point to All Programs > Administrative Tools, and then select Services. The Services dialog box opens.
2. Double-click FactoryTalk Batch Archiver. The FactoryTalk Batch Archiver Properties (Local Computer) dialog box opens to the General tab. 3. Select the Log On tab. The Server account specified during installation is the default account. 4. Click Browse. The Select User dialog box opens. 5. Locate and select the desired Batch Archiver user account. Click OK to close the Select User dialog box. 6. In the Password box, type the password for the Batch Archiver user account, type the password again in the Confirm password box, and then click OK. A message displays stating that the user account has the Log On As A Service right.
540
1. Click the Start button, point to All Programs > Administrative Tools, and then select Services. The Services dialog box opens. 2. From the Services list, double-click FactoryTalk Batch Archiver. The FactoryTalk Batch Archiver Properties (Local Computer) dialog box opens to the General tab. 3. From the Startup Type list, select Disabled. 4. Click OK, and then close the Services dialog box.
541
6. In the Incremental Period box, enter 10 (or more) and select Minutes. This should be set to an incremental period that is high enough to ensure a significant number of records are generated so that when the FactoryTalk Batch Archiver runs it will pick up at least the number or records specified in the Maximum Records Per Transaction field.
542
For example, if the batches running only generate 50 records and the Maximum Records Per Transaction is set to 75 then the incremental period should be increased. Conversely, if 500 records are generated every 10 minutes then it may be advantageous to set the incremental period lower.
This value is set higher by default for Historian Classic for Batch users primarily because considerably more database-side processing time is required to evaluate and parse each and every record, along with inserting data into the Batch History tables. Having the FactoryTalk Batch Archiver send more records to the database (i.e. 1000) in each transaction, higher performance results in terms of the total records transferred per second.
543
Manager cannot communicate with the Windows Services of the selected computer, you receive an error message. 1. Click the Start button, point to All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch, and then select Batch Service Manager. The FactoryTalk Batch Service Manager dialog box opens.
2. Click Select Computer. The Select Computer dialog box opens. 3. Select the name of the computer where the Batch Archiver service is installed. Click OK. The Select Computer dialog box closes.
Select the computer first because the FactoryTalk Batch Service Manager needs to determine the available services on the selected computer.
4. From the Service list, select FactoryTalk Batch Archiver. 5. Click the Start button to start the Batch Archiver service.Click OK.
4. From the Service list, select FactoryTalk Batch Archiver. 5. Click the Stop or Pause button.
Clicking the Pause button causes the Incremental Archiver to pause after processing the active .evt file. Click the Start button to resume Incremental Archiving.
6. Click OK.
544
CHAPTER 5
C, C++, or Visual Basic application batch (.bat) file command (.cmd) file
ArchQue.txt File
Keep the ArchQue.txt file locked while it is open and keep it open for only a few seconds. If the queue file is held open for more than a few seconds, the FactoryTalk Batch Server cannot add entries to the queue as other control recipes are created. The ArchiverEnabled=Never setting (in the BatchArc.ini file) causes the Archiver queue file to not get written to. If you want to write to this queue file, then a setting other than "Never" must be used and you must manually maintain the size of the archive queue file.
The archive queue file, ArchQue.txt, contains a list of electronic batch record files. The line format within the list contains the path and file name of the electronic batch record file. The path name can use either UNC names or local path names, depending on how the
545
journal project directory is defined in the FactoryTalk Batch Equipment Editor Server Options dialog box as shown here.
If the batch is removed from the batch list, a tab character (\t) and the word REMOVED follows the file name. Each electronic batch record file is listed in a single record delimited with Carriage Return / Line Feed (CR/LF). Line Format (UNC) \\computer_name\sharename\path_to_journal_file \t REMOVED{CR/LF}
Example
\\station1\BATCHCTL\SAMPLEDEMO1\journals\123.evt \t REMOVED{CR/LF} \\station1\BATCHCTL\SAMPLEDEMO1\journals\124.evt \t REMOVED{CR/LF} \\station1\BATCHCTL\SAMPLEDEMO1\journals\125.evt {CR/LF}
546
Description Time event is recorded in Greenwich Mean Time Local time event is recorded Unique identifier assigned by the Batch Server Alpha Batch ID The recipe element that was executing at the time of the electronic batch record entry. The field contents appear as:
<UniqueID>:[<Procedure>\] [<Unit Procedure>:Instance\] <Operation>:InstanceLoopCounter
The data in the brackets is optional, depending on the recipe level. Descript Event varchar(255) NULL varchar(155) NULL varchar(255) NULL varchar(255) NULL varchar(155) NULL varchar(255) NULL varchar(255) NULL varchar(155) NULL varchar(155) NULL Description of PValue data Event type triggering the record Value reported to the electronic batch record Description of PValue data Event type triggering the record Value reported to the electronic batch record Engineering units associated with Pvalue Area model name in batch equipment configuration where batch was executed Process cell in Batch equipment configuration Yellow Paint Material Tracking / Material Bound / Material Unbound 50 Engineering Units Report 50 GALLONS THE_PAINT_COMPANY
ProcCell
YELLOWPAINT1
547
Field Type varchar(155) NULL varchar(155) NULL datetime NULL varchar(85) NULL varchar(50) NULL varchar(155) NULL varchar(50) NULL varchar(255) NULL varchar(255) NULL varchar(255) NULL
Description Unit name in Batch equipment configuration Name of the phase generating the record Last date the batch report was printed Computer name/Windows user name Phase class description Common name of the material Inventory control system material ID used to track the material Name assigned to a lot of material ID assigned to a distributed portion of a lot Containers name where material and lot were distributed, or where material and lot are stored Unique ID used as a key to allow grouping of separate event entries all resulting from a single material addition Used for event journal signatures by Batchsig program to detect changes in .evt file. Information stored here is a hexadecimal or a single spaced character. Tag indicating information reported to SAP Unique identifier assigned to the record when it is added to the database Number of times an active eProcedure control step has been reactivated
YELLOWPAINT 31
PromiseID
varchar(50) NULL
100
Signature
varchar(255) NULL
ERP_Flag RecordNo
31
Reactivation Number
int
548
Example <FORM> Add a CIP Batch to the Batch List. Click OK when done. </FORM>
SQL Server columns that have a field type of ntext only retrieve 256 characters of data at a time using a standard SELECT statement. To retrieve all the data use the READTEXT function. (See How to Display All Instruction HTML Data from an SQL Database for more information.) SignatureID int A 32-bit unsigned integer that uniquely identifies a Signature Request within the batch system. A 32-bit unsigned integer that uniquely identifies an Action within the batch system. An Action is a queued Execute command to the Batch Server that is pending one or more Signature completions prior to being performed. 1
ActionID
int
How to Display All Instruction HTML Data from an SQL Database If you are archiving data to an SQL database, you must use the READTEXT function to retrieve all data in the Instruction HTML column for a specified record number. The following steps provide a sample query and explain how to modify the query that will produce an .html file for viewing in a browser: 1. In Query Analyzer go to the Tools > Options > Results tab and clear the Print column headers (*) option. Click Apply and then OK to close the dialog box. 2. From the Query menu, select Results to File. 3. Copy the following example query into a blank query window:
/* --------*/ Displays the contents of a text column in a 255-character wide query window @txtptrval is the text pointer value for the specified text column @offsetval is the offset value and represents the starting position within a text column @bufferval represents the amount of text to put in the row in this case, it is set to 255 because isql/w only displays 255 characters in a row @maxval is the full length of the entire text column
549
BEGIN SET NOCOUNT ON DECLARE @txtptrval VARBINARY(16), @offsetval INT, @bufferval INT, @maxval INT SELECT @txtptrval = TEXTPTR(bhbatchhis.InstructionHTML) FROM bhbatchhis WHERE recordno = '5817' SELECT @offsetval = 0 SELECT @bufferval = 255 SELECT @maxval = DATALENGTH(bhbatchhis.InstructionHTML) / 2-1 FROM bhbatchhis WHERE recordno = '5817' --PRINT --PRINT --PRINT --PRINT 'Total length of column: ' '------' @maxval ''
-- Last chunk, reduce buffer size to the nChars remaining IF (@offsetval + @bufferval) > @maxval BEGIN SELECT @bufferval = @maxval - @offsetval --PRINT 'Last chuck... buffer size remaining is:' --PRINT '------' --PRINT @bufferval END WHILE @offsetval < @maxval BEGIN READTEXT bhbatchhis.InstructionHTML @txtptrval @offsetval @bufferval --PRINT 'Data started at character position' --PRINT @offsetval SELECT @offsetval = @offsetval + @bufferval --PRINT 'Data ended at character position' --PRINT @offsetval --PRINT ' ' 550
-- Last chunk, reduce buffer size to the get the last nChars remaining IF (@offsetval + @bufferval) > @maxval SELECT @bufferval = @maxval - @offsetval + 1 END SET NOCOUNT OFF END
4. In the query, edit the WHERE clause to specify the recordno for which you want to view the InstructionHTML. 5. Run the query and save the results to a file name, such as Output.html.
Be sure to specify the .html extension, change the Save as type to All Files (*.*), and change the File Format to ANSI.
6. In Windows Explorer, double-click the .html file to view the actual HTML in your browser.
4. Select User-defined (End of Batch). 5. In the Executable file box, use the browse button to locate the .exe file.
551
6. In the Initialization file box, use the browse button to locate the .ini file. 7. Click OK. (See the FactoryTalk Batch Administrators Guide for more information on the Server Options dialog box.)
552
CHAPTER 6
Configuring the FactoryTalk Batch Archiver for FactoryTalk Historian Classic for Batch
If you are using FactoryTalk Historian Classic for Batch, you must configure the FactoryTalk Batch Archiver to store the relevant batch data to the RSBizWare relational database.
553
name in the FactoryTalk Batch Archiver Setup and specify the BHBatchHis Table name in the FactoryTalk Batch Equipment Editor.
All FactoryTalk Batch users previously archiving data to a BatchHis Table must perform these steps to ensure proper connectivity and data storage.
1. Open FactoryTalk Batch Archiver Setup by selecting All Programs > Rockwell Software > FactoryTalk Batch Suite > FactoryTalk Batch > Archiver Setup from the Windows Start menu. The Select Data Source dialog box displays. 2. Click the Machine Data Source tab. 3. Select the valid RSBizWare Data Source name (DSN). 4. Click OK.
554
6 Configuring the FactoryTalk Batch Archiver for FactoryTalk Historian Classic for Batch
Response Recipe Header Recipe Parameter Deviation Recipe Value Recipe Value Change Report Parameter Deviation
State Change State Command Unit Bind Unit Creation Bind Unit Unbind
Archiver (Incremental) Maximum Records Per Transaction = 1000 Incremental Period = 5 Minutes
The minimum value that can be entered in the Maximum Records Per Transaction field is 0 and the maximum is 10000. However, the maximum number of records that can be successfully archived in a single transaction depends on the capabilities of your computer, and may be significantly less than 10000. If you encounter Time Out messages in the batcharc log, reduce the value in the Maximum Records Per Transaction field. If you enter a value of 0, all records will be committed in a single transaction at the end of the batch.
555
Archiver (Incremental) Maximum Records Per Transaction = 10 Incremental Period = 1 minute or less.
These values ensure that events are processed, stored, and committed to the database as quickly as possible, making this data available for prompt retrieval.
These settings are a guideline and may vary depending on the number of events generated per batch, the duration of the batch, etc.
556
APPENDIX A
557
The following FactoryTalk Batch Archiver events can be entered in the Windows event log:
Category Start Start Start Start Start Start Start Start Shutdown Setup
Event 1001 1002 1003 1004 1005 1006 3001 3002 4001 5001
Description FactoryTalk Batch Archiver Service started successfully in incremental mode FactoryTalk Batch Archiver Process started successfully in nonincremental mode FactoryTalk Batch Archiver failed to start; see the BATCHARC.LOG file for more information FactoryTalk Batch Archiver failed to open the BATCHARC.LOG file Service handler not installed Bad Service Request FactoryTalk Batch Archiver Service paused FactoryTalk Batch Archiver Service continuing FactoryTalk Batch Archiver Service shutting down FactoryTalk Batch Archiver setup; new connect string = <new string>
558
Batch
559
CHAPTER 1
Document Organization
The information in this document should minimize the effort required to create your own custom look for batch automation system data. The following subjects are presented in this document:
Installing the ActiveX Controls Library ControlRecipeList Interface PromptsList Interface SignatureList Interface ProcedureView Interface
ControlRecipeList control PromptsList control ProcedureView control Timer View control SignatureList control
561
The ControlRecipeList control performs the functions of the Batch List window, the SignatureList control performs the functions of the Batch Signature List window, and the PromptsList control performs the functions of the Unacknowledged Prompts window in the View. The ProcedureView control performs the functions of both the Procedure as Table and Procedure as SFC windows in the View. These controls are used to create, command, and remove control recipes from the Batch List, acknowledge operator prompts, view running control recipes, change step formula values, acknowledge electronic signatures, and perform active step changes. The Batch ActiveX controls can vary in appearance through the use of the Properties and Methods that the controls support. Though the appearance can vary, the controls allow you to perform the same functions as their corresponding FactoryTalk Batch View windows.
In HTML pages that use the Batch ActiveX controls, the class IDs in the <OBJECT> tags must be updated. This is done by looking up the class ID in the registry, or by deleting and reinserting the control in an HTML editor. For HMI screens, the controls must be deleted and reinserted.
Redistributing Files
You may use and redistribute all the files with this product as long as you credit Rockwell Automation in the About box. Please read and honor the license agreement.
562
If you choose to use the ActiveX controls in Visual Basic, the controls must be added to the Visual Basic toolbox before you can use them in your project. The following instructions explain how to manually add the controls to the toolbox after starting a new project. However, if you choose, you may define the controls so that they are loaded automatically. 1. Start Visual Basic. 2. From the Projects menu, select Components. The Components dialog box opens. 3. Select the Controls tab. A list of available Custom Controls displays. 4. Scroll through the list, locate, and select the BatchControl BatchView Controls library to add the ControlRecipeList control and the PromptsList control; select the BatchControl ProcedureView Control library to add the ProcedureView control. To add the SignatureList control, select the SignatureListOCX Controls library. 5. Click OK to close the dialog box. The ActiveX controls are now available on the Visual Basic toolbox. The ProcedureView appears as an SFC/table combination, the PromptsList as a question mark, the ControlRecipeList as a card file, and the SignatureList as a tablet with a pen, as shown here.
563
Version Checking
Beginning with FactoryTalk Batch version 9.0, the ProcedureView, InstructionView, and ControlListView ActiveX controls check the FactoryTalk Batch Server version on startup via the CPRVersion API item and determine compatibility with the Server. If a version incompatibility exists between the Server and the ActiveX control, a message displays along the bottom of the control: The [Name] ActiveX control is incompatible with the current Server. It is strongly recommended that you upgrade your system before continuing.
This incompatible condition is untested and unsupportedupgrade your FactoryTalk Batch Server to the same version as the ActiveX controls currently installed.
The message is continually displayed for as long as the control is connected to the FactoryTalk Batch Server. If the Server is shut down and then restarted, the control once again checks for version compatibility. For information on the CPRVersion API item, refer to the FactoryTalk Batch Server API Technical Reference Guide. For more information on the BatchVersionCompatible property, refer to the FactoryTalk Batch ActiveX Controls Library Reference Guide.
Configure the FactoryTalk Batch ActiveX Controls and FactoryTalk View SE to use the same FactoryTalk Directory. In FactoryTalk View Studio, set the Expose ToVBA property to VBA Control. The Expose ToVBA property is located in the Property Panel dialog box. To open the Property Panel dialog box, right-click the Display containing the FactoryTalk Batch ActiveX Control, and then click Property Panel on the context menu.
In FactoryTalk View Studio, add VBA code to the Graphic Display containing the FactoryTalk Batch ActiveX Control. For more information, refer to the following VBA code example.
564
565
566
CHAPTER 2
Place the control within a web browser or other ActiveX container. Place the control on a Visual Basic form and open it as an executable.
ControlRecipeList Interface
The appearance of the ControlRecipeList interface varies depending on the container and how the control is configured within that container. However, the generic ControlRecipeList interface functions the same regardless of the container and can perform all of the standard functions of the Batch List window in the FactoryTalk Batch View without custom modifications. The information displayed in the ControlRecipeList window is user-configurable.
567
568
569
1. Right-click the ControlRecipeList control and then click Login on the shortcut menu.
2. In the Login dialog box, type your user name in the User Name box. 3. Type your password in the Password box. 4. Click OK.
To log off the ActiveX control, log off of the FactoryTalk Network (if single-signon is enabled) or log off Windows.
If your recipes do not display in the list, then close and reopen the Master Recipe List dialog box.
2. To filter the list of recipes, select an option from the Filtering Column list, and then click Refresh.
If the recipe list is empty, click Cancel to close the Master Recipe List dialog box. Click the Add button again. If the recipe list is still empty, please refer to the Administrators Guide for instructions on configuring Server Options to point to your recipe directory.
570
4. If the recipe contains a material class-based phase, the Material Value Selection dialog box opens. If not, skip to step 6.
5. From the Material list, select the material you want to use in this particular batch, and then click Create. 6. The Batch Creation dialog box opens.
If you are creating a batch of a material-based recipe and the FactoryTalk Batch Server has lost communication with the Material Server and is set to continue processing in MANUAL mode, the following warning will display: WARNING: MATERIAL SERVER NOT IN USE. You can continue to create and run the batch, but automatic binding will not occur. You are prompted to select the container/equipment module pair that can supply the correct material to continue processing the batch. Use extreme caution when operating without the Material Server. The container/equipment module list is not filtered by the Material Server when it is unavailable. Failure to select the correct container/equipment module pair could result in a hazardous situation, depending on the material. (See Processing Batches Without the Material Server on page 575 for more information.)
7. If a Batch ID is not automatically generated, type a unique Batch ID. The Batch ID can be comprised of any character except the following: The defined list separator, spaces, single or double quotes, brackets, parentheses, the percent sign (%), the tab
571
character ( \t ), the carriage return character ( \r ), or the new line character ( \n ). The maximum length of the Batch ID is 255 characters.
If the Batch ID box appears dimmed, you cannot change it. The option to make the Batch ID editable is set by the system administrator in the System Configuration and Defaults dialog box on the General tab.
8. In the Scale box, type a percentage by which you want to scale the recipe, if the batch is to be run at a percentage other than 100%. All phase parameters that were marked as scalable in the FactoryTalk Batch Equipment Editor and all operation or unit parameters that were marked as scalable in the FactoryTalk Batch Recipe Editor are adjusted proportionally by the percentage you enter. Any phase, unit, or operation parameters that are not marked as scalable are not adjusted; their values remain the same as the original value specified no matter how the batch is scaled. 9. If there are formula values that need to be assigned or modified, select the Value cell in the Formula Values area and enter a new value.
If this is a class-based recipe, and the recipe has a unit allocation method of At Batch Creation or Operator Choice, you must specify the unit allocation requirements. If the unit allocation method is At Batch Creation, you must choose a specific unit from a list of the available units. If the unit allocation method is Operator Choice, then you can choose from a list of available units, or you can select the Prompt or First Available unit allocation methods. 10. Click the Bound Unit cell in the Unit Binding area to activate the Bound Unit list. Make an appropriate selection.
If the recipe does not require that any formula values be assigned, the Formula Values area contains a single blank row. Likewise, if the recipe does not require any unit binding, the Unit Binding area contains a single blank row.
572
11. Click Create to add the batch to the Batch List window. The Start command button is enabled.
If control strategies are enabled for a recipe, changing the selected control strategy after the recipe is added to the batch list could corrupt that recipe.
Viewing Batch Creation Errors If any problems exist in the area model or recipe that will prevent a batch from running, the No Legal Units Summary dialog box opens. If dynamic unit allocation is enabled for the recipe, the dialog box includes a summary error message, the reason for the error, the binding requirements and the binding requirement expression values for each unit requirement.
If dynamic unit allocation is not enabled, a message will display the error that prevents the batch from being created.
The No Legal Units Summary dialog box contains the following information:
The top section, Summary Message, displays all the summary error messages returned by the failed execute and the associated unit requirement. The second section, Unit Summary Information, displays the unit requirement(s) along with each unit that failed the unit requirement and the associated reason. The third section, Unit Binding Requirements, displays the binding requirement information for those unit requirements whose reason for exclusion was a binding
573
requirement, including the unit requirement, the binding requirement ID, and the description of the binding requirement.
The fourth section, Expression Data, displays any expression data information for the binding requirements displayed in the Unit Binding Requirements section that are of an expression type. Included is the unit requirement, the binding requirement ID, the unit name, the result and the expression values.
Right-click the appropriate control recipe in the ControlRecipeList and select Start from the ControlRecipeList shortcut menu. (Notice that the state of the control recipe changes from READY to RUNNING.)
Right-click the control recipe, and select the appropriate command from the ControlRecipeList shortcut menu. (Notice that the state of the control recipe changes from the previous state to the selected state.)
Right-click the appropriate control recipe, and select either Manual or Semi-Auto from the ControlRecipeList shortcut menu.
The ControlRecipeList does not indicate when a control recipe has paused while in SEMIAUTO or MANUAL modes. To determine if a control recipe is PAUSED, open the ControlRecipeList shortcut menu. If the control recipe is PAUSED, the Resume command is enabled.
Right-click the appropriate control recipe, and then click Remove on the ControlRecipeList shortcut menu.
574
controls. When you enable cross invocation and identify the automation server, the shortcut menu displays the cross invocation menu items.
Cross Invocation is enabled by setting two properties in the ActiveX Controls Library: InvocationProgID and ShowCustomMenuItems.
The items that appear in the shortcut menu are formatted using cross invocation strings associated with the equipment resource to which the current selection corresponds. Up to five menu items can be configured. These cross invocation strings also indicate the context data passed to the Automation Server. (See the FactoryTalk Batch Administrators Guide for more information on cross invocation strings and what context data can be configured.) The FactoryTalk Batch element selected for Cross Invocation from the ControlRecipeList ActiveX control is:
Control ControlRecipeList Selectable Elements Batch
1. Right-click the appropriate selection in the ActiveX controls. The configured Cross Invocation menu items display.
2. Select a menu or sub-menu item. The context data is automatically passed to the configured automation server.
Check with your system administrator for the context data configured for each of the shortcut menu items displayed on your system.
575
Server. All material-based decisions or selections made by the operator without communications with the Material Server are reported in the batch event journal as Loss of Material Server and Loss of Material Tracking events. When the material database becomes available you must manually reconcile the event journal with the material journal and update the material database with the Amount, Lot, and Label information for material inventory.
Loss of communication with the Material Server causes the FactoryTalk Batch Server to switch to prompt binding and presents an unfiltered list of container/equipment module pairs from which to select binding candidates. The operator must select the container/ equipment module pair that can supply the correct material to continue processing the batch. Failure to select the correct container/equipment module pair could result in a hazardous situation, depending on the material. Exercise extreme caution when operating without the Material Server.
When processing material-based batches manually, you are required to make selections without information from the material database, as described in the following sections.
576
CHAPTER 3
Place the control within a web browser or other ActiveX container. Place the control on a Visual Basic form, and open it as an executable.
PromptsList Interface
The appearance of the PromptsList varies depending on the container in which it is placed, and how it is configured within that container. However, the control functions in the same way regardless of the container in which it is placed, and it allows you to recognize and respond to any Unacknowledged Prompts.
577
578
1. Right-click the PromptsList control and select Login from the PromptsList shortcut menu. The Login dialog box opens.
2. Type your user name in the User Name box. 3. Type your password in the Password box. 4. Click OK to log in. Clicking the Cancel button clears any data you have entered and closes the Login dialog box.
To log out of the ActiveX control, log off of the FactoryTalk Directory (if single-signon is enabled) or log off Windows.
Acknowledging a Prompt
Acknowledging a prompt from the PromptsList includes opening the Acknowledge dialog box and entering a parameter value.
579
1. Right-click the appropriate prompt in the PromptsList Control. From the PromptsList shortcut menu, select Acknowledge. The Acknowledge dialog box opens, displaying the current prompt data.
2. Type the response value. 3. Click the Acknowledge button. The prompt will be acknowledged and removed from the PromptsList.
2. Select a lot or storage container to bind material to, and click OK. The prompt is acknowledged and removed from the PromptsList.
580
The items that appear in the shortcut menu are formatted using cross invocation strings associated with the equipment resource to which the current selection corresponds. Up to five menu items can be configured. These cross invocation strings also indicate the context data to be passed to the automation server. (See the FactoryTalk Batch Administrators Guide for more information on cross invocation strings and the context data that can be configured.) The following describes the elements that can be selected for cross invocation from the PromptsList ActiveX control.
Control PromptsList Selectable Elements Unacknowledged Prompts (not binding requests)
1. Right-click the appropriate selection in the ActiveX Controls. The configured Cross Invocation menu items display.
2. Select a menu or sub-menu item. The context data is automatically passed to the configured Automation Server.
Check with your system administrator for the context data that is configured for each of the shortcut menu items displayed on your system.
581
582
CHAPTER 4
Place the control within a web browser or other ActiveX container. Place the control on a Visual Basic form, and open it as an executable.
SignatureList Interface
The appearance of the SignatureList control varies depending on the container, and how it is configured within that container. You can configure the SignatureList control to display all the Signatures associated with a batch or only the Incomplete Signatures. The control functions the same regardless of the container you place it in, and allows you to recognize and respond to pending Signatures in the SignatureList. (See the FactoryTalk Batch
583
584
1. Right-click the SignatureList control and select Login from the SignatureList shortcut menu. The Login dialog box opens.
2. Type your user name in the User Name box. 3. Type your password in the Password box. 4. Click OK. Click the Cancel button to close the Login dialog box.
To log out of the ActiveX control, log off of the FactoryTalk Directory (if single-signon is enabled) or log off Windows.
Acknowledging a Signature
Acknowledging a Signature from the SignatureList control requires opening the Signature dialog box and entering the Signoff information required for validation. The Signature Template defined in the area model determines the user information required to
585
complete a Signature. (See the FactoryTalk Batch View Users Guide for more information on acknowledging a Signature.)
1. Double-click the appropriate Signature in the SignatureList control. The Signature dialog box opens, displaying the associated Signature data.
2. Type your user name in the User ID box. 3. Type your password in the Password box. 4. Type a comment for the selected Signoff (if required). The Sign button is enabled.
The signer must be listed under Security Requirements or be a member of one of the Groups in the list to complete a Signoff.
5. Click the Sign button. The Signoff State changes to Complete. 6. When all Signoffs are complete click the Close button. If you select the Close button without completing the Signature, the Signature dialog box closes and the Signature remains on the Signature List. A batch with pending Signatures cannot be removed from the Batch List. (See the FactoryTalk Batch ActiveX Controls Library Reference Guide for information on Signature states.)
Signatures can require up to three Signoffs. Each Signoff requires a valid User ID and Password. Signoff Comments are either required, optional or not allowed. A Signoff marked with an asterisk identifies it as the Last Signoff.
586
If a user action generates a single Signature Request, the Signature dialog box for that Signature is displayed to the user. If an action generates multiple Signature Requests, the Generated Signatures dialog box is displayed, and lists the associated Signatures. (See the FactoryTalk Batch View Users Guide for information on multiple Signature Requests.)
Cancelling a Signature
If you cancel a Signature Request the action that generated the Signature is also cancelled. Selecting the Cancel Signature button in a Signature dialog box displays a dialog box like the one shown here:
If you select the Yes button the associated action is cancelled and the Signature State is changed to Cancelled. (See the FactoryTalk Batch View Users Guide for more information on Cancelling a Signature.)
587
Windows XP Professional SP3: Click the Start button, point to All Programs > Control Panel, double-click Administrative Tools, and then select Component Services.
3. Open Component Services > Computers, right-click on My Computer, and then select Properties. The My Computer Properties dialog box opens.
Windows XP Professional
4. Click on the [Default] COM Security tab, and click the Edit Default button in the Access Permissions area. The Access Permission dialog box opens.
588
5. Click the Add button. The Select Users, Computers, or Groups dialog box opens.
6. Select the correct location in the From this location box by doing one of the following:
If the FactoryTalk Batch Server is running on a domain, select the Server domain name. If the Server is running on a local user account (workgroup), select the name of the FactoryTalk Batch Client computer.
7. In the Enter the object names to select box, add the account the Server runs as to the list and click Check Names. This verifies that the account exists.
If the Server is running on a domain, choose the Servers domain account. If the Server is running on a local user account (workgroup), select the name of the local account under which the Server runs.
8. Click OK. 9. Click OK to close the Access Permission and My Computer Properties dialog boxes. 10. Close the Component Services window. 11. Log off and then log back on.
589
590
CHAPTER 5
Place the control within a web browser or other ActiveX container. Place the control on a Visual Basic form, and open it as an executable.
Consult your system administrator for information on using these options. The appearance of the ProcedureView varies depending on the container in which it is placed, and how it is configured within that container. However, the control functions in the same way regardless of the container in which it is placed.
591
592
593
step transition, the shortcut menu items will be applicable to the recipe level currently being displayed.
594
Description Opens the Properties dialog box, allowing you to view the properties of the selected recipe step or transition. Allows you to log on to the FactoryTalk Batch View security.
1. Right-click the ProcedureView control, and select Login from the ProcedureView shortcut menu. The Login dialog box opens.
2. Type your user name in the User Name box. 3. Type your password in the Password box. 4. Click OK.
To log off of the ActiveX control, log off of the FactoryTalk Network (if Single-SignOn is enabled) or log off Windows.
595
selected control recipe. It allows you to watch a control recipe execute its steps and transitions. To navigate to a lower recipe level, double-click a step, other than the initial step, in the SFC. The SFC for that step will then be displayed. Control recipes can be navigated downward in this way to the operation level. To navigate up through the control recipe, double-click the initial step of the SFC. The magnification of the displayed SFC can be adjusted by selecting Zoom from the shortcut menu and then selecting the zoom percentage. To view the entire SFC within the ProcedureView, select Zoom and then select Whole Procedure. Text is not included in the depiction of the current procedure when the zoom percentage is at or below 35%.
596
view, right-click outside of the SFC (do not click on a recipe step, comment, or transition), or if the Table view is the active view, right-click the table header. The ProcedureView shortcut menu opens. 2. Select the appropriate command from the menu. (Notice that the state of the control recipe changes from the previous state to the selected state.)
If the logged in user does not have permission to send the Timer-Complete or Timer-Reset commands then the commands will not be enabled even if the Timer step is in the proper mode and state. If the Timer-Complete or Timer-Reset commands are configured to require confirmation then, when selected by the user, a confirmation dialog is displayed. In the ProcedureView, the shortcut menu accelerator keys now support Timer steps. For example, if both TIMER-RESET and RESUME are enabled, the user can toggle between the selected command on the dialog by pressing ALT+R and then pressing Enter to select the command. The TIMER-COMPLETE command is accessed the same way: ALT+C toggles between TIMER-COMPLETE and CLEAR FAILURES.
597
In addition to viewing parameter information, the Parameter tab also allows you to edit parameter values. Editing Parameter Values 1. Right-click a recipe step at the lowest (operation) level of the control recipe. This step should represent a phase. The ProcedureView shortcut menu opens. 2. Select Properties from the shortcut menu. The Properties dialog box opens. 3. Double-click a parameter from the Parameter tab. A dialog box opens containing the minimum and maximum values (view-only) and the value of the parameter.
4. Enter a new value in the Value box and click OK to save the new value, or click Cancel to exit the dialog box without saving the new value.
You cannot edit the MATERIAL, MATERIAL_CLASS, or CONTAINER values for a materialenabled phase.
5. Click OK.
598
599
Preferences associated with the step selected in the SFC or Table View. At the unit procedure or unit operation level there is only one unit requirement.
Viewing Expression Values Double-clicking a binding requirement or preference expression opens the Binding Requirement (or Preference) Expression Values view. It lists the units that are potential legal binding candidates, a value indicating whether those candidates currently meet the selected binding requirement or preference, and shows a list of the inputs used to evaluate the expression.
If viewing an expression for a binding requirement, the content of the Expression is Boolean; it evaluates to True or False. If the expression is Minimum or Maximum the
600
Result column shows the actual value determined for the minimum or maximum. The values dynamically update as the inputs to the expression change. If viewing an expression for a binding preference, the content of the Expression depends on the Type of expression selected:
Bind Preference Types Boolean Expression Minimize Expression Maximize Expression Expression Expression that must evaluate True Expression to be minimized Expression to be maximized
601
cause the step to display a green hatch background, indicating that the step will become active when the active step change is executed.
If a step to activate is a material step, you must first rebind the step to a material before doing the Active Step Change. Select each material step to activate and then perform a manual bind. (See Performing Material Binding for more information.)
The Table view of the ProcedureView control does not use hatching to indicate selected and deselected steps. Instead, the initial active step row is highlighted in yellow, selected (active) step rows are highlighted in bright green, and deselected (inactive) step rows are highlighted in blue.
7. Right-click anywhere within the ProcedureView control. The Active Step Change menu opens. 8. Select Commit Changes from the menu to execute the active step change, or click Cancel to cancel the active step change. The new active step(s) will display a READY state and will be in the O_AUTO mode. Any subsequent steps in the recipe that have already completed will be reset. This allows the operator the option to place the batch in the AUTOMATIC mode and process the balance of the batch normally.
If you did not rebind a material step, you will be prompted to rebind the step to a material, and begin the Active Step Change procedure again.
9. Right-click each of the active steps to open the ProcedureView shortcut menu, and select Start to start the step. The selected step will run and return to a COMPLETED state when it is finished.
If the control recipe is placed in AUTOMATIC mode, the entire procedural level of the control recipe can be started, and the remainder of the control recipe will continue executing normally.
The step is associated with a unit class in the recipes equipment requirements. The step represents the highest recipe level wholly contained within the unit. (For example, one step in the recipe represents a unit procedure which is associated with
602
the Premixer unit class, and another step that is associated with the same Premixer unit class is an operation. As long as the balance of the manual binding requirements are met, then you may manually bind the unit procedure, but not the operation, since the unit procedure is the highest recipe level associated with the unit.)
The step is inactive or has a binding status of BINDING. More than one legal binding choice exists for the unit that is associated with the step.
All other steps within the control recipe that are associated with the same unit alias will be bound to the same unit.
If the Material Server is unavailable, a warning message is displayed in the dialog box. The unit list displays data supplied by the area model in place of the data normally supplied by the Material Server. When the Material Server is not available, first available binding is serviced as though it was prompt binding. Use extreme caution when operating without the Material Server. Failure to select the correct unit or binding method could result in a hazardous situation, depending on the material.
3. Select the appropriate binding option. Selecting Operator Prompt results in an operator binding prompt when unit binding is required during recipe execution. Selecting First Available causes the unit procedure to automatically bind to the first available unit when unit binding is required during recipe execution. To specify a particular unit for binding, select the Specific Unit option and then select the unit from the list. 4. Click OK to save changes and exit the Bind dialog box, or click Cancel to exit without saving changes.
603
or Procedure as Table window. The following criteria must be met to perform manual binding:
The step is associated with a material in the recipe. The step is inactive or has a binding status of BINDING.
Material binding is performed from the Procedure as SFC or Procedure as Table window. 1. Within the ProcedureView control, navigate to the recipe level that contains the material step to be changed. 2. To bind a material to a step, you must select the material step in either the SFC view or Table view. Right-click the material step, and the ProcedureView shortcut menu opens. 3. If the manual binding criteria have been met, the Bind menu option will be enabled. Select the Bind menu option. The Prompt to Bind a Material Phase Step dialog box opens.
If the Material Server is unavailable, a warning message is displayed. The list of container/equipment module pairs generated from the area model is substituted for the list that would have been produced if the Material Server were available. When the Material Server is unavailable, material additions may not be filtered by lot or label specification. Use extreme caution when operating without the Material Server. Failure to select the correct container/equipment module pair could result in a hazardous situation, depending on the material.
4. Select the material specification that determines the lot or storage container to bind the material step, and click OK. Or, click Cancel to exit without saving changes.
604
The items that display in the shortcut menu are formatted using cross invocation strings associated with the equipment resource to which the current selection corresponds. Up to five menu items can be configured. These cross invocation strings also indicate the context data passed to the automation server. (See the FactoryTalk Batch Administrators Guide for more information on cross invocation strings and the context data that can be configured.) The ProcedureView ActiveX control elements that can be selected for cross invocation are: Batch, Recipe Phase, Operation, and Unit Procedure. 1. Right-click the appropriate selection in the ActiveX controls. The configured Cross Invocation menu items display.
2. Select a menu or sub-menu item. The context data is automatically passed to the configured automation server.
Check with your system administrator as to what context data is configured for each of the shortcut menu items displayed on your system.
605
606
CHAPTER 6
Place the control within a web browser or other ActiveX container. Place the control on a Visual Basic form, and open it as an executable.
Consult your system administrator for information on using these options. The appearance of the TimerView varies depending on the container in which it is placed, and how it is configured within that container. However, the control functions in the same way regardless of the container in which it is placed.
607
If you double-click on the Setpoint box for a COUNT_DOWN Timer, the Change Setpoint Value dialog box opens. (See Changing a Setpoint for more information.) The Filter Pattern status bar (optional) is displayed below the Timer Step grid. DOubleclicking on the status bar opens the Timer Step Filter dialog box. (See Using Filters for more information.) The status bar is enabled or disabled at design time. (See Viewing the Status Bar in the Batch ActiveX Controls Library Reference Guide for more information.) Hovering the cursor over any row in the Timer list displays that Timer steps recipe path in a tooltip. For each Timer step that satisfies the filter criteria the ActiveX control displays the following information.
Item Step Name Type Elapsed Remaining Time Setpoint Units of Time State Unit Description The recipe step name. The type of counter COUNT_UP or COUNT_DOWN. Time How much time has elapsed since the Timer started running. How much time is left on the Timer; the setpoint value minus the elapsed time. (COUNT_DOWN timers only) The configured period of time that the Timer phase is set to run. (COUNT_DOWN timers only) The units of time assigned to a Timer step; can be Seconds, Minutes, Hours, or Days. The recipe steps current state. The name of the unit in which the Timer step is running (this value may be blank)
The TimerView ActiveX control updates at least once every five seconds. This value is configured at design time. (See Viewing the Communication Tab in the Batch ActiveX Controls Library Reference Guide for more information.) If no Timer steps match the given filter criteria, a message displays. After a period of time if one or more Timer steps match the configured criteria, then those steps will be displayed. If the Timer steps go out of scope of the filter and there are no Timer steps to display, the No Timer steps match the configured filter criteria message displays. If the ActiveX control cannot communicate with the configured Batch Server node then a Communications Lost message is displayed. If communications are reestablished then the ActiveX control will display the Timer steps that satisfy the filter criteria.
608
have been added to the Batch List. The menu items are disabled if the menu item is not valid for the selected element.
1. Right-click in the TimerView control, and select Login from the TimerView shortcut menu. The Login dialog box opens. 2. Type a valid FactoryTalk user name in the User Name box. 3. Type a valid password in the Password box. 4. Click OK.
To log off of the ActiveX control, log off of the FactoryTalk network (if Single-SignOn is enabled) or log off Windows.
609
The name of the Timer displays in the header. The current State, Type, Hold Behavior, Unit, BatchID, Units of Time, Elapsed Time, Remaining Time (COUNT_DOWN Timers only), and Recipe Path are displayed (view-only). If the Timer is a COUNT_DOWN Timer, the Setpoint box is enabled; double-click in the box to open the Change Setpoint Value dialog box.
Changing a Setpoint
The Change Setpoint Value dialog box can be displayed two ways from the TimerView ActiveX control. For COUNT_DOWN Timers, double-click the Setpoint box from the table view, or double-click the Setpoint text box on the Timer Step dialog box.
The Change Setpoint Value dialog box shows the Minimum and Maximum values (viewonly) for the Setpoint parameter and allows the user to type a new value in the Value box. The user enters a new value then clicks one of the following buttons:
OK: Immediately updates the Timers setpoint value in the Batch Server and closes the
dialog.
Apply: Immediately updates the Timers setpoint value in the Batch Server. It also recalculates the Est. Remaining Time value and does not close the dialog box.
610
Recalculate: Recalculates the Est. Remaining Time value, but does not initiate an
update to the setpoint in the Batch Server. The Recalculate option is meant as a means for the user to fine tune the setpoint value before committing the change.
The value entered must be within the displayed minimum and maximum values for the parameter. If the value is between the minimum and maximum values when the user clicks OK then the new value will be sent to the Timer step. If the value is not between the minimum and maximum values when the user clicks OK, an error message requests Please enter a value between the configured Minimum [Minimum Value] and Maximum [Maximum Value] values. Upon clicking OK for the error message, the user will be able to enter a new value.
Using Filters
Filters can be preconfigured on the Appearance tab of the Property Pages dialog box at design time, or from the Timer Step Filter dialog box, which is accessed from the Filter menu at run time (if the Filter menu option was enabled at design time).
You should select only one Filter, but if more than one Filter is selected, the control filters in the following order: FilterOnAreaModel (Unit Name), FilterOnBatchID (Batch ID), and then FilterOnBatchList (Batch Recipe Path).
The Timer Step Filter dialog box consists of a tree control where the use can apply a filter to any one of three distinct areas:
Unit Name: Filters Timer steps based on the Unit in which they are running. This filter
is applied to the value appearing in the Unit column. This filter cannot be combined with any other filter by value.
Batch ID: Filters Timer steps based on the ID of the batch. This filter is applied to only the batch ID of a Timer step. This filter cannot be combined with any other filter by value.
611
Batch Recipe Path: Filters Timer steps based on the batchs Recipe Path. This filter is
applied to the recipe path of a Timer step. This filter cannot be combined with any other filter by value.
It is important that the filter pattern is correct for the Filter By option. You can filter either on the area model, unit name, or a batchs recipe path. There is a chance of a filter mismatch if the incorrect Filter By option is set using the wrong filter pattern.
As items are selected from the tree, the filter pattern is built and displayed in the Filter Pattern box at the bottom of the dialog box. The user is able to edit the text in this box to further refine the filter criteria.
If a filter pattern is set at run-time, the filter value is not persisted and the default filter value set in configuration mode will be used the next time the ActiveX control is initiated. The run-time setting of the filter is only valid for the current running session of the control.
A group of one or more characters (charlist) enclosed in brackets ([ ]) can be used to match any single character in the string and can include almost any character code, including digits. To match the special characters left bracket ([), question mark (?), number sign (#), and asterisk (*), enclose them in brackets. The right bracket (]) cannot be used within a group to match itself, but it can be used outside a group as an individual character. By using a hyphen (-) to separate the upper and lower bounds of the range, charlist can specify a range of characters. For example, [A-Z] results in a match if the corresponding character position in string contains any uppercase letters in the range A-Z. Multiple ranges are included within the brackets without delimiters. The meaning of a specified range depends on the character ordering valid at run time. An exclamation point (!) at the beginning of charlist means that a match is made if any character except the characters in charlist is found in the string. When used outside brackets, the exclamation point matches itself. A hyphen (-) can appear either at the beginning (after an exclamation point if one is used), or at the end of charlist to match itself. In any other location, the hyphen is used to identify a range of characters. When a range of characters is specified, they must appear in ascending sort order (from lowest to highest). [A-Z] is a valid pattern, but [Z-A] is not. The character sequence [] is considered a zero-length string ("").
612
Index
Symbols
.bpc files 374 .evt file 128 .evt files 523 .oxml files 374 .pxml files 374 .uop files 374 .upc files 374 .uxml files 374
OPC data server 212 operations to a recipe 363, 382, 391 parallel steps to a table 389 parallel steps to an SFC 379 phase link groups 419 phases to a recipe 382, 391 procedure 365 process cell classes 314 process cells 315 recipe header data 372 resource classes 311 resources 312 RSLinx Enterprise Live Data server 213 steps before parallel steps 390 steps to an SFC 379 transitions to an SFC 382 unit attribute tags 312 unit attributes 312 unit classes 315 unit procedures 363 unit procedures to a recipe 383, 391 units 316 adding comments 386 adding control recipes 570 adding text boxes 386 Administrative Tools 61 alarm summary window 498 alias name 364 Allowable Failures 78 allowable SFC permutations 423 Amount parameter 400 AND convergence 347, 348, 380, 519 AND divergence 347, 348, 380, 519 AND path, example 343 AND structure 337
A
abort a batch 502 abort command 594 acknowledge a prompt 484 material phase step 484 acknowledging a signature 486 acknowledging prompts 579, 580 acquire a material phase 493 a phase 493 resources 498 active step change 511 active step change command 594 active step change, performing 601 ActiveX components 562 overview 561 ActiveX controls troubleshooting 134 using 563 ADDEVENT execute 539 adding branch structures to an SFC 381 data server 314 enumeration sets 313 enumerations 313
613
arbitration null phase 346 window 497 arbitration information equipment modules 297 process cells 233 shared resources 222 unit 243 Archiver database schema 547 event filters 75 incremental period 75 pausing 544 running 543 service 140 starting 543, 544 stopping 544 system architecture 524 Archiver event filters FactoryTalk Historian Classic for Batch 554 Archiver service assign user account to 540 enabling 541 archiving end-of-batch 525 incremental 525 non-incremental 525 ArchQue.txt File 545 area 578 area model creating 163 editing 311 errors exporting 321 errors importing 321 export XML file 170 exporting 169 import XML file 167, 168, 169 naming 163 opening 164
supported changes 311 translating 164 area model, previous version 164 assigning recipe formula parameters 407, 408 report limits 404 step formula values 404, 413 Timer step formula values 405 transition expressions 384 associating comments 386 associating recipe comments 386 associating text boxes 386 auditing Equipment Editor 33 message generation 33 Recipe Editor 33 auto command 569, 594 AutoBatchID execute failure 137 automatic custom Batch IDs 136 logoff time period 18 mode 508 phase processing 495 restart control 82 automatic upload/download 189
B
Batch auditing 33 batch comment 471 modes 468 Batch COM+ Application 8 adding 10 user account 141 batch commands, configuring verification policies 204 batch creation without material server 455 batch creation errors 573
614
Index
batch event filters 555 Batch ID 568, 578 Batch IDs customizing 135 disable editing 135 batch scale 470, 572 Batch Server cold boot 63, 128 computer name 82 demo mode 61, 63 does not start 132 end of batch 128 failure 127 grace period 63 incompatible 564, 569, 579, 585, 595, 609 incompatible version 449 options 70 performance chart 131 restart 127 user group 8 warm all boot 63 warm boot 63 warm restart 128 Batch Server Service starting 66 startup type 69 Batch Server Statistics COM information 61 dialog box 64 Batch Service Manager 544 interface 61 batch states 468 automatic upload/download 468 Batch View open from command line 148 terminal services 143 batcharc.ini file 554 BATCHHIS table select 74
BatchIDCreation.dll 138 Batchsvr.ini 127, 129 Batchsvr.log 127 batchsvr_group 8 BatchVEW.ini 145 begin parallel step 354 binary format exporting recipes to 442 binary recipe format 435 bind command 594 binding 602 material 514, 603 preferences 599 requirements 599 binding expressions creating 371 data types 226, 395 operators 226, 394 binding methods 402 binding preferences configuring 370 creating 369 expressions 479 printing 431, 432 viewing 478 binding requirements 225 configuring 368 creating 228, 368 deleting 229 editing 229 example 225 expressions 478 printing 431, 432 viewing 477 boot methods cold boot 63 warm all boot 63 warm boot 63 BPC 335
615
start 451 stop 451 timer-complete 452 timer-reset 452 command handshake timeout 84 command line convert XML 170 open Batch View 148 Command Signature 46 command verification policies 489 command verification policies dialog box, field descriptions 205 Command Verification Policy 46 command verification policy changing 206 configuring 204 removing 207 commanding phases 493 Timer steps 597 timer steps 510 commanding a control recipe 570, 596 commanding phases 493 comment 471 comment command 594 comments 351 adding 386 associating 386 disassociating 387 editing 386 communication status 452 indicators 452 communications timeout 77 COM-related exception errors 322 configuration and defaults setting 459 configuring binding preferences 370 binding requirements 368 custom archiver 545
C
calculation method 277 cancelling a signature 490 system cancelled 490 change timer setpoint 610 changing colors 120 fonts 120 list view properties 120 recipe storage format 437 report margins 122 unit requirements 364, 367 view properties 119 class view area 156 class-based recipe 358 classes 160 Clear Failures command 594 clear failures command 569 clear overrides 505 clearing failure messages 499 colors changing 117 COM object converting XML to binary 171 command buttons 334, 451 abort 452 add 452 auto 452 clear all failures 452 comment 452 disconnect 452 hold 451 manual 452 remove 452 semi-auto 452
616
Index
end-of-batch archiving 541 formatted reports 125 incremental archiving 539 list reports 125 optimal record transfer 542 Recipe Editor options 329 report footings 122 report headings 122 the server 537 unit attribute tag information 242 user preferences 116 container binding 402 Container parameter 400 containers information equipment modules 300 continuous phase 102 control recipes adding 570 commanding 570 filtering 570 control strategies and verification policies 284 configuring 275 definition 162 example 186 formula values 399, 404 implementing 186 overview 185 phase link groups 418 with upload/download parameter subsets 190 ControlRecipeList adding a control recipe 570 changing modes 574 changing states 574 commanding a control recipe 570 menu 568 removing a control recipe 574 starting a control recipe 574
converting XML area model 170 converting XML to binary from COM object 171 from command line 170 CopyFileID field 127 copying a recipe 374 copying phases 286 create a batch 469 creating binding expressions 371 binding preferences 369 binding requirements 368 global unit attributes 256 Masterrecipes database 436 operations 363 phase link groups 419 procedure 365 unit attributes 250 unit procedures 363 creating a data source SQL 532 Creating an SQL Server Data Source 532 creating area model 163 creating phases 261 control strategy tab 275 general data 261 messages tab 274 parameters data 265 parameters tab 265 phase message item 274 report parameters 269 creating process cell class 231 cross invocation 516 ControlRecipeList 574 default values 79 definition of 235 enable 461 example 91
617
manual phase control window 492 phase summary window 500 ProcedureView 605 PromptsList 581 unacknowledged prompts window 483 cross invocation strings equipment modules 298 process cells 234 shared resources 223 unit 244 current profile 498 cutting and pasting phases 286
Data Servers 453 conversion status 453 data servers assigning 217 working with 210 data source 553 data types 341 binding expressions 226, 395 enumeration 226, 395 examples 226, 395 integer 226, 395 real 226, 395 string 226, 395 database names 113 Network Editor 113 schema 547 SQL Server 134 types to use 523 database connection string 553 verify 554 databases creating masterrecipes 436 DCOM distributed communications 562 security 562 decimal places setting 330 decision logic 342 dedicated resources 347, 380 default 578 cross invocation values 79 hyperlink values 80 default printer when running Vista 430 default tags naming conventions 294 defer parameters 401
D
data server adding 210, 314 default item access path 211 definition 159 deleting 216 editing 215 OPC 211 RSLinx Enterprise Live Data 214 scan rates 212 server location 212 server name 211 types 211 watchdog item access path 211 watchdog item name 211 watchdog protocol 212 watchdog write item access path 212 watchdog write item name 212 data server definition file 209 data server definition file (DSDF) 5 data server properties modifying 314 data server protocols CIP 210 FTD 210 OPC 210
618
Index
defining steps 382, 391 deleting equipment requirements 367 phase link groups 420 recipes 433 unit attributes 251 unit instances 245 descriptive information 432 descriptive information report 431 descriptors cross invocation 79 hyperlink label 80 design view area 156 deviation limits 277 device focus 497 directory share 3 disable Archiver service 74 Batch Archiver service 525, 537 disabling Batch Archiver service 541 disassociating recipe comments 387 disassociating text boxes 387 disconnecting equipment module 515 display 402 distributed communications 562 DSDF 5 DSDF. See "data server definition file" duplicating phases 285 dwell time 103 dynamic unit allocation 330, 361
editing comments 386 editing text boxes 386 electronic batch record 128 electronic batch records 523 description 527 interpretation examples 527 electronic signature template 195 adding 197 configuring signoffs 198 deleting 203 modifying 204 Electronic Signatures policy setting 59 security 59 electronic signatures how they work 193 sequence of tasks 195 types of 193 using 193 enable parameter limit tags 302 report limit tags 305 end parallel step 354 end-of-batch archiving 525 configuring 541 enhanced phase logic request 187, 190 enum/EU 402 enumeration data type 342 enumeration sets 173 adding 313 definition 159 deleting 177 description 173 editing 176 example 173 negative ordinal values 173 working with 175 enumerations adding 313
619
E
edit command verification policies dialog box, field descriptions 205 Edit menu 331 edit signature templates dialog box, field descriptions 196 editing parameter values 598 unit attributes 251
material database unavailable 174, 265 eProcedure hyperlinks 79 equipment database, previous version 164 equipment dependencies process cells 233 unit 243 Equipment Editor access modes 22 audited events 34 configuration options 23 interface 155 opening 154, 329 security 21, 154 equipment module arbitration data 297 configuring 287 container information 300 cross invocation strings 298 definition 163 general data 288 hyperlink strings 299 OPC tags 294 sharing 308 tag data 291 tag naming conventions 293 tags 254, 292 tags definition 163 equipment phase tag properties modifying 313 equipment phases modifying 319 equipment requirements deleting 367 equipment requirements. See "unit requirements" 358 error message application log is full 133 license for component not found 133 recipe directory file not found 133
error messages 498 ErrorLogDirectory 129 errors troubleshooting 131 EU 404 EU (Engineering Units) 578 evaluating recipe parameter expressions 411 report parameter expressions 412 event filters FactoryTalk Historian Classic for Batch 554 for FactoryTalk Batch 555 for Material Manager 555 event journal 527 filter criteria 483 open 482 sort criteria 483 event journals 11 event journals signatures electronic batch records 78 Event Log entries 557 Event Viewer 95 examples AND convergence 343 AND divergence 343 AND path 343 complex parallel structure 356 data types 341 decision logic 342 loop logic 343 null phase 346 OR convergence 342 OR divergence 342 OR path 342 parallel logic 343 REPEAT path 343 SFC execution 344 simple parallel structure 355 synchronization 346
620
Index
transitions 339 unit attribute binding 225 execute ADDEVENT 539 exit from View 451 export RDB files 441 recipes 442 export errors COM-related exceptions 322 illegal characters encountered in writing out instruction file 321 unable to access instruction file 321 exporting enumerations (XML) 170 recipes to binary 442 recipes to SQLB 443 system phases (XML) 170 with same name 443 XML area model 169, 170 XML recipes 442 expression builder unit binding 225, 393 validation 227, 396 expression length maximum 396 expression values viewing 600 expressions binding 371 in recipe parameters 411 in report parameters 411 operands 227, 395 operators 226, 394, 415 validating 227, 396 expressions, transition 338 external applications using the SignatureList control 587 external security device 20
F
FactoryTalk AssetCentre message fields 43 FactoryTalk AssetCentre client view audit logs in 42 FactoryTalk Batch 8 upgrading older versions 433 FactoryTalk Diagnostics Viewer extended message fields 40 standard message fields 39 view audit messages in 39 FactoryTalk Directory 11 FactoryTalk Help 12 FactoryTalk Historian Classic for Batch Archiver event filters 554 FactoryTalk Live Data 213 FactoryTalk Security 11 FactoryTalk Services Platform 12 FactoryTalk Windows Firewall Configuration Utility 10 failure handshake timeout 76 phase 77 watchdog timeout 76 failure messages 498 feed type 403 File menu 331 file types 374 filter patterns timer steps 612 filtering control recipes 570 timer steps 611 filters 465, 483 FactoryTalk Historian Classic for Batch 554 final step 337 footer report description 433 forcing a transition 505 Format menu 331
621
formatted report 125 formula values 399 assigning 404, 405 control strategies 399, 404 material-enabled phase parameters 399 using expressions 413
HMI changing logged in user 19 Go To 460 hold a batch 501 hold behavior timer steps 350 hold command 569, 594 hold propagation setting 76 hyperlink default values 80 hyperlink strings equipment modules 299 process cells 235 shared resources 223 unit 245
G
general data equipment modules 288 general information phases 261 process cells 232 shared resources 221 unit 241 General Usage Phase Logic Requests 58 generate reports 429 generated signatures 488 global binding requirement 225 global binding requirements configuring 225 global unit attribute creating 256 enable 258 grace period 67 groups, configuring for electronic signatures 198
I
icons creating 237 path verification 236 ID 403 illegal characters encountered in writing out instruction file 321 import RDB files 441 import errors COM-related exceptions 322 material-specific 323 XML parser 322 importing binary recipes 439 enumerations (XML) 168 enumerations to XML 168, 169, 170 RDB recipes 439 recipes 439 system phases (XML) 169 with same name 443 XML area model 167, 168, 169 XML recipes 439
H
H 402, 403 header data 372 Help menu 332 HH 402, 404 HHH 402, 404 hiding recipe construction toolbox 334 High/Low 277 High-High/Low-Low 277 High-High-High/Low-Low-Low 277 Historian Classic for Batch 532
622
Index
incompatible Batch Server 449, 564, 569, 579, 585, 595, 609 Incremental Archiver 74 incremental archiving 525 configuring 539 initial step 337 inserting steps into a table 389 steps into an SFC 377 installing ActiveX components 562 integer data type 341 ISA S88 153
location bar 156 log files 11 log on 585 ControlRecipeList 569 ProcedureView 595 PromptsList 579 SignatureList 585 TimerView 609 log on to Batch View 451 login 449 Login command 595 loop material 384 rebinding 384 loop logic 343 Lot parameter 400
L
L 402, 403 Label parameter 400 limit calculation 403 limit tags creating for parameters 301 creating for reports 304 mapping to parameter tags 303 mapping to report tags 306 naming conventions 293 tag locking disabled 303, 306 tag locking enabled 302, 305 limitations SFC 343 transition expression 343 limits 399 Link menu 331 linking SFC components 383 SFC elements 342 units 246 list devices 497 list report 125 list view properties changing 120 LL 402, 403 LLL 402, 403
M
maintaining recipes 421 manual binding 513 mode 509 phase control 493 phase control, material-enabled phases 493 manual binding 602 manual command 594 manual failover 83 manual unit binding without Material Server 457 Margins 429 masterrecipes database creating 436 material binding 514 material binding 603 Material Class parameter 400 material class-based recipes 359 material database area model 165 enumerations 174, 265
623
material loop creating 384 examples 385 Material Manager 81 Material Manager event filters 555 Material parameter 400 material phase acquiring 493 material phase step prompt, acknowledging 580 material report parameters 401 Material Server 454 communication status 454 monitoring 454 outage 455 reestablishing communications 458 material server outage 575 material value selection without Material Server 456 material-based recipes 359 material-enabled parallel steps 344 material-enabled phase configuring 284 disabling 285 feed type 403 parameters 399 material-specific errors 323 max 402 maximum expression length 396 Maximum Log File Size box 78 menu 585 ControlRecipeList 568 ProcedureView 593 PromptsList 578 SignatureList 585 TimerView 608 menu bar 156, 331 message partners 263 messages
clear failures 499 configuring phase messages 274 modifying 318 viewing 499 migrating area models 164 min 401 minimize the View 460 Minimum Disk Space box 78 mode changes ControlRecipeList 574 ProcedureView 597 mode column 468 modes 468 automatic 508 manual 509 semi-auto processing 508 modifying area object 311 data server properties 314 equipment phase tag properties 313 equipment phases 319 messages 318 process cell class 314 process cell properties 315 recipe parameter properties 316 recipe phases 318 report parameter properties 317 resource class properties 311 resource properties 312 unit attribute properties 312 unit attribute tag properties 313 unit attribute tags 312 unit class properties 315 unit properties 316 unit requirements 364, 367 moving text boxes 386 multiple instances Batch View 143, 449
624
Index
N
name 401, 403 naming a recipe 372 NET registry key 82 Network Editor database 113 status bar 114 network model add a server 116 information 112 remove server 116 synchronizing 115, 116 no legal units 573 No Limits 277 none, verification policy 277 non-incremental archiving 525 not allowed 277 null procedure 345, 380 null phase 347 arbitration 346 NULL_CLASS 403 NULL_CONTAINER 403 NULL_MATERIAL 403
file types 374 S88.01 definition 327 operators, expressions 226, 394, 415 operators, transitions 340 optimal data access 543 optimal performance configuring Archiver for 542 data access 543 record transfer 542 optimal record transfer 542 optimum data access recommendations for FactoryTalk Historian Classic for Batch 556 Options dialog box 329 OR convergence 385 OR divergence 385 OR path, example 342 OR structure 337 origin 401 override clear 505 parameter expressions 504 overriding recipe parameter expressions 412 report expressions 412 Object Database Connectivity (ODBC) 74 OLE for process control (OPC) 5 OPC groups 5 Open Database Connectivity 435 opening a recipe 362 Equipment Editor 329 opening the View 449 operands binding expression 227, 395 operation 357 adding to a recipe 382, 391 changing unit requirements 364 creating 363 overview page report 431, 432
O P
Page Boundaries 429 Page Orientation 429 Page Setup 429 Paper Size 429 Paper Source 429 parallel logic 343 parallel steps 347, 354, 380, 519 adding step before 390 adding to a table 389 adding to an SFC 379 parallel structure complex 356
625
simple 355 table view 355 Parameter Deviation Verification Policies 55 parameter deviations, selecting verification method 184 parameter expression override value 504 overriding 412 parameter limit tags configuring 307 creating 301 parameter limits 184 parameter tags mapping to limit tags 303 naming conventions 293 parameter values 399 assigning 404, 405 editing 598 using expressions 413 parameters defer 401 how editing affects limit tags 307 overview 179 phase 182 recipe formula 407, 408 report 182 scaling 184 setting decimal places 330 target 284 password 449 pausing the Archiver 544 Period (msec) box 77 permissions 4 permissions, configuring for electronic signatures 198 phase 357 adding to a recipe 382, 391 configuring to material-enabled 284 copying 286 cutting 286
definition 161 disabling material-enabled 285 how editing affects limit tags 307 material-enabled 101 parameters creating 265 definition 161, 182 material-enabled 265 pasting 286 reports configuring 269 S88.01 definition 327 phase commands, configuring verification policies 204 phase control window 491 without Material Server 458 phase link group 263, 265 phase link groups control strategies 418 creating 419 deleting 420 phase list display area 492 phase logic enhanced request 187, 190 phase logic simulation 101 phase parameters 183 definition 161 phase report limits 399 assigning 404 phase simulator starting 101 phase specific information display area 492 phase summary window 499 phases acknowledge phase prompt 495 acquire 493 command 493 commanding 493
626
Index
release 495 reset 495 start 494 policy changing for a command 206 removing for a command 207 verification 204 policy settings default 23 ESignature Network Directory 59 Print Preview 429 print preview 125 Printer selection of 429 Printer Properties 429 printing binding preferences 431, 432 binding requirements 431, 432 recipes 429 working set 430 printing report expressions 431, 432 printing reports print a range of pages 126 priority list 498 procedure 357 changing unit requirements 367 creating 365 file types 374 S88.01 definition 327 procedure filtering 431 procedure level operation 357 phase 357 procedure 357 unit procedure 357 procedure levels 357 procedure view pane 335 resize 335 sizing 335
ProcedureView active step change 601 changing modes 597 changing states 596 commanding a control recipe 596 log on 595 manual binding 602 menu 593 SFC view 593 starting a control recipe 596 Table view 592 viewing step properties 598 process cell adding 315 arbitration information 233 class creating 231 editing 231 configuring 232 creating a 232 cross invocation strings 234 definition 160 general information 232 removing 236 process cell class adding 314 modifying 314 process cell properties modifying 315 process levels 357 process-connected device 331 product policies 13 prompt acknowledge 484 prompt binding without Material Server 456, 457 prompted binding 514 prompts acknowledging 579 material phase step 580
627
PromptsList acknowledging prompts 579, 580 interface 577 menu 578 properties 595 Properties dialog box 598 Binding tab 599 Parameter tab 598 Recipe tab 599 Report tab 599
importing binary 439 importing RDB 439 importing XML 439 material class-based 359 material-based 359 opening 362 printing 429 multiple recipes 430 procedure entry table 353 procedure levels 357 process levels 357 rebuilding directory 428 releasing to production 428 removing 433 saving 374 SFC view 337 step formula values 399 table-based 353 translating 433 unit-based 358 upgrading FactoryTalk Batch 433 to 10.0 433 verifying 421 recipe comments 386 recipe construction pane 335 Recipe Editor access modes 22 audited events 37 configuration options 23 interface 330 menu bar 331 procedure view pane 335 recipe construction pane 335 recipe construction toolbox 334 status bar 335 toolbar 332 Recipe level BPC 335
R
RDB files export 441 import 441 RDB format 435 exporting recipes to 443 process flow diagram 435 RDB recipe format 435 real data type 341 rebinding loop creating 384 rebuilding recipe directory 428 recipe adding operation 382, 391 phase 382, 391 unit procedure 383, 391 assigning recipe formula parameters 407, 408 building overview 336 class-based 358 comments 351 copying 374 exporting to binary 442 exporting to SQL 443 exporting XML 442 file types 374 header data 372
628
Index
UOP 335 UPC 335 recipe list dialog box 469 Recipe menu 331 recipe parameter expressions evaluating 411 recipe parameter properties modifying 316 recipe parameters expressions in 411 warm restart handling 317 recipe phases modifying 318 recipe verification what is verified 421 recipes printing a working set 430 released to production 134 rectangle SFC 429 rectangle grid 429 redistributing files 562 release phase 495 resources 498 releasing recipe to production 428 remove a batch 471 removing recipes 433 SFC link 383 steps from a table 392 from an SFC 384 removing a control recipe 574 REPEAT path, example 343 report descriptive information 431, 432 footer 430 header 430
report description 432, 433 report expression overriding 412 report expressions printing 431, 432 report footer report description 433 report information 430 report limit tags configuring 307 creating 304 report limits 399 assigning 404 report parameter expressions evaluating 412 report parameter properties modifying 317 report parameters 183 expressions in 411 material 401 warm restart handling 318 report parameters, configuring 269 report preferences setting 120 report selection 431, 432 report tags mapping to limit tags 306 naming conventions 293 reporting options 537 configuring 537 reporting values for optimal performance SQL Server only 555 reports changing margins 122 configuring 269 configuring footings 122 configuring headings 122 generate 429 how editing affects limit tags 307 phase reports 182
629
print 429 procedure filtering 431 working with columns and rows 124 request tags, naming conventions 294 reset phase 495 resize procedure view pane 335 resize the View 460 resource arbitration 346 dedicated 347, 380 resource class properties modifying 311 resource classes adding 311 resource properties modifying 312 resource types cross invocation 79 hyperlinks 80 resources adding 312 definition 160 restart a batch 502 restart Batch Server 127 restart command 569, 594 restore a batch 128 resume command 594 re-verify recipes 163 RSLinx Enterprise 213 RSLinx Enterprise Live Data server 214 RSLinx Enterprise Live Data tags 180 RSLinx Enterprise Server Path 212, 215
scale 184, 470, 572 scan rates data server 212 security 447, 562, 569 automatic logoff time period 18 Batch View 13 commands 447 event journals 11 external device 20 files 11 folder 11 log files 11 log on 447 Windows 7 security permissions, configuring for electronic signatures 198 selection tool 354 semi-auto command 594 semi-auto phase processing 496 semi-auto processing 508 server adding 116 removing 116 server configuration 537 Server Options Archiver (End of Batch) 74 Archiver (Incremental) 74 Archiver Event Filters 75 Batch Server tab 76 BatchReporting tab 73 Cross Invocation tab 78 editing 70 Material Policies tab 81 Project Settings tab 70 redundant servers 72 Restart Control tab 72, 73 server options 156 Server Options dialog box 63 service manager 544
S
S88.01 Procedural Model 357 saving a recipe 374 saving area model 163 scalable 407
630
Index
setpoint change 510 changing 610 setting binary recipe format 437 RDB recipe format 437 Recipe Editor options 329 report preferences 120 security on folders or files 11 user preferences 116 XML format 437 SFC 337, 354 adding branch structures 381 parallel steps 379 steps 379 transitions 382 assigning transition expressions 384 branch structures 381 components AND structure 337 final step 337 initial step 337 OR structure 337 step 337 transition 337 defining steps 382 element linking 342 examples 385 AND path 343 execution 344 OR path 342 REPEAT path 343 inserting steps 377 limitations 343 linking components 383 null procedures 345
removing links 383 steps 384 SFC area working in the 480 SFC rectangle 429 SFC rectangle grid 429 SFC report 431, 432 SFC validation 422, 423 allowable permutations 423 SFC validation errors 424 Linear Segment Cannot Reach Terminal Step 426 Parallel Activation of Linear Segment 424 Parallelism with Terminal Step 426 Unreachable Linear Segment 428 Unreachable Terminal Step 425 SFC View window 473 SFC view 337, 593 shared directory 3 shared resources defining 221 definition 160 description 220 sharing equipment modules 308 units 246 Show/Hide Page Boundaries 429 showing recipe construction toolbox 334 signature list window 485 Signature Requests Active Step Change 54 Add Event 54 Command 46 General Usage 58 General Usage Signature 58 Parameter Deviation 56
631
Parameter Prompt Acknowledge 49 Phase Bind Prompt Acknowledge 50 Remove Batch 52 Report Parameter Deviation 57 Set Parameter 48 Unit Bind 51 Unit Bind Prompt Acknowledge 50 signature requests active step change 489 add event 489 clear override 490 command signatures 488 force transition 490 general usage signature 490 override expression value 490 parameter change 490 parameter change signature 487 parameter deviation signature 490 parameter prompt acknowledge 490 phase bind 490 phase bind prompt acknowledge 490 remove batch 489 report parameter deviation signature 490 reset batch 489 set all label 490 set all lot 490 timer-complete 489 timer-reset 489 unit bind 490 unit bind prompt acknowledge 490 signature requirement, removing for a command 207 signature template 485 adding 197 configuring signoffs 198 creating 195 deleting 203 modifying 204 verification policy 277 Signature Templates 45
signature templates dialog box, field descriptions 196 SignatureList acknowledging 585 cancelling 587 interface 583 log on 585 SignatureList control using in external applications 587 signatures electronic 193 how they work 193 sequence of tasks 195 types of 193 signoff failures 490 signoff policies, configuring for commands 204 signoffs, configuring 198 simple recipes 354 simple step 354 simulator 101 ack/clear requests 108 change dwell time 103 command a phase 107 indicating a continuous phase 103 interface 101 phase configuration 102 phase ownership 107 phase parameter tag 107 phase status 104 report parameter tag 107 request data tags 107 request sequence 103 restore/clear requests 109 starting 101 unit tag status 109 Single-SignOn 154, 448 sizing procedure view pane 335 smart binding 368 Source Step 578
632
Index
SQL database creating a data source 532 SQL wildcards 465, 483 start a batch 501 a phase 494 start command 569, 594 starting Equipment Editor 329 the Archiver 544 starting a control recipe ControlRecipeList 574 ProcedureView 596 status bar 158, 335 step formula values 399 assigning 404 assigning to Timers 405 using expressions in 413 Step menu 331 step parameters 354 steps 337, 338 adding before parallel steps 390 parallel steps to a table 389 parallel steps to an SFC 379 to an SFC 379 defining 382, 391 inserting into a table 389 into an SFC 377 parallel 347, 380 removing from SFC 384 removing from table 392 stop a batch 451 stop command 569, 594 stopping the Archiver 544
string data type 342 subarbitration 347, 380 symbols 354 SFC recipe structure 354 synchronization 345 synchronize 115 system architecture 524 system failure 524 System Log file 133 system problems 127
T
table adding parallel steps 389 adding step before parallel steps 390 defining steps 391 inserting steps 389 removing steps 392 Table view 592 display items 592 window 480 table view 353 parallel structures 355 recipe structure 354 step name 354 step parameters 354 step sequence 353 transition expressions 354 tag verification 129 tags deleting tag class 258 description 249 editing 254 editing from menu 254 editing tag class 258 equipment module information 291 equipment module tags creating 254 definition 163
633
limit 301, 304, 307 mapping to limit tags 303, 306 naming conventions 293 RSLinx Enterprise Live Data 180 set to default addresses 296 set to default names 255 unit attribute 251 unit attribute tags 250 information 242 working with 249 target parameter 403 target parameters, and report verification policies 284 template adding 197 configuring signoffs 198 deleting 203 modifying 204 signature 195 text box 386 text boxes adding 386 associating 386 disassociating 387 editing 386 moving 386 text comments 351 time 578 timer complete 510 reset 510 Timer steps changing a setpoint 610 changing the setpoint 510 commanding 597 ProcedureView 597 timer steps 350 commanding 510 filtering 611 hold behavior 350
inserting 378 modes 507 using filter patterns 612 Timer-Complete command 594 Timer-Reset command 594 TimerView filter patterns 612 filters 611 log on 609 window 607 timing 345 toolbar 157, 332, 450 toolbox 334 transition forcing 505 transition expression limitations 343 transition name 382 transitions 337 adding to an SFC 382 assigning conditions 384 data types 226, 341, 395 examples 339 expressions 338, 354 expressions in table view 354 identifiers 339 operators 340 translating recipes 433 translating area models 164 troubleshooting ActiveX controls 134 application event log 133 Batch Archiver is disabled 541 Batch Server failure 127 Batch Service Manager 132 batch terminated 128 error messages 127 event journal files 134 recipes not visible 134
634
Index
SQL Server selection 134 system problems 127 tag verification 129 text in Batch dialog boxes 133 type 401, 403, 578
unit attribute tag creating 251 unit attribute tag properties modifying 313 unit attribute tags 242 adding 312 creating 251 modifying 312 unit attributes adding 312 deleting 251 editing 251 unit binding expression builder 225, 393 unit class properties modifying 315 unit classes adding 315 unit instance configuring 241 creating 240 removing 245 unit procedure 357 adding to a recipe 383, 391 changing unit requirements 364 creating 363 file types 374 S88.01 definition 327 unit properties modifying 316 unit requirements 358 changing 364, 367 viewing 477 unit tag class See "unit attribute" unit-based recipe 358 units adding 316 UOP 335 UPC 335
U
unable to access instruction file 321 unacknowledged prompts window 483 unique icons 237 unit arbitration information 243 configuring 241 configuring arbitration 243 configuring cross invocation 244 configuring general information 241 configuring hyperlinks 245 configuring tag information 242 creating a unit class 239 creating a unit instance 240 creating tags 251 cross invocation strings 244 definition 160 deleting 245 editing a unit class 240 equipment dependencies 243 general information 241 hyperlink strings 245 linking 246 removing a unit instance 245 sharing 246 tags information 242 working with 239 unit attribute adding 250 unit attribute binding example 225 unit attribute properties modifying 312
635
upgrading FactoryTalk 9.x recipes 433 older versions of FactoryTalk Batch 433 recipes to 10.0 433 upgrading recipes to 10.0 433 upload/download parameter subsets 187 definition 162 using with control strategies 190 user account creating 7 for Archiver service 540 user groups, configuring for electronic signatures 198 user preferences changing colors 117, 120 changing fonts 120 changing view properties 119 editing information tips 118 list view properties 120 setting 116 working with columns and rows 124 user-defined (End of Batch) 75 using ActiveX controls 563
migrating from 7.0 164 removing for a command 207 verification policy, changing for a command 206 verify recipes 153 verifying recipes 421 version checking 564 View configuring 459 alarm summary 464 Batch List view 463 Cross Invocation 460 event journal 464 Hierarchical Step List 463 HMI 460 operations table 464 phase control 464 phase summary 465 procedure binding 463 procedure parameters 463 procedure prompts 463 procedure reports 463 procedure table 464 SFC view 463 Signature List 461 unacknowledged prompts 464 unit procedure table 464 login 449 view audit messages 39 FactoryTalk AssetCentre client 42 FactoryTalk Diagnostics Viewer 39 View interface 450 View menu 332 view properties 120 View security 447 FactoryTalk Security 447 Single-SignOn 448 View windows alarm summary 498 arbitration 497
V
validating binding expressions 227, 396 parameters with expressions 412 validating SFCs 422, 423 allowable permutations 423 value 402 verification what is verified 421 verification method 184, 402, 403 verification policies 277 verification policy 277 and control strategies 284 configuring 277 configuring for commands 204 configuring for parameters and reports 281 dialog box fields 279
636
Index
Batch List 473 Batch List view 467 phase control 491 phase summary 499 SFC View 473 signatures 485 Table View 480 unacknowledged prompts 483 viewing binding preferences 478, 599 expressions 479 binding requirements 477, 599 expressions 478 expression values 600 SFC recipes 337 table-based recipes 353 unit requirements 477 Vista considerations default printer 430 Printer button 432
Windows Event Log 557 entry properties 95 modify settings 95 tag verification 130 Windows Firewall Exceptions 9 Windows registry NET key 81 Windows services Archiver 61 Batch Server 61 Windows-linked user 154 workgroup configuring client 13
X
XML importing enumerations 168, 169, 170 XML area model convert 171 convert from command line 170 export 169 importing 167 XML parser errors 322 XML recipe format 436 XML recipe schema 436 XML recipes exporting 442 importing 439
W
warm restart support 311 watchdog item name 211 protocol 212 watchdog item access path 211 wildcard character 465 Windows Desktop 18
637