Factorytalk Batch PhaseManager
Factorytalk Batch PhaseManager
In no event will Rockwell Automation, Inc. be responsible or liable for indirect or consequential damages resulting from the use or application of this
equipment.
The examples and diagrams in this manual are included solely for illustrative purposes. Because of the many variables and requirements associated
with any particular installation, Rockwell Automation, Inc. cannot assume responsibility or liability for actual use based on the examples and
diagrams.
No patent liability is assumed by Rockwell Automation, Inc. with respect to use of information, circuits, equipment, or software described in this
manual.
Reproduction of the contents of this manual, in whole or in part, without written permission of Rockwell Automation, Inc., is prohibited.
Throughout this manual, when necessary, we use notes to make you aware of safety considerations.
WARNING: Identifies information about practices or circumstances that can cause an explosion in a hazardous environment, which may lead to
personal injury or death, property damage, or economic loss.
ATTENTION: Identifies information about practices or circumstances that can lead to personal injury or death, property damage, or economic
loss. Attentions help you identify a hazard, avoid a hazard, and recognize the consequence
SHOCK HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that dangerous voltage may be
present.
BURN HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that surfaces may reach dangerous
temperatures.
Important: Identifies information that is critical for successful application and understanding of the product.
Allen-Bradley, Rockwell Software, and Rockwell Automation ControlLogix, eProcedure, FactoryTalk, RSBizWare, RSBizWare BatchHistorian, RSBizWare Historian, RSBizWare MaterialTrack, and RSLinx are
trademarks of Rockwell Automation, Inc.
Trademarks not belonging to Rockwell Automation are property of their respective companies.
Table of contents
Chapter 1
Chapter 2
Chapter 3
FactoryTalk Batch phases in Synchronize the area model with the project file ......................................................... 36
Save the area model and select a data server .......................................................... 37
Logix Designer
Select phases and synchronize .................................................................................. 38
Review results and save files...................................................................................... 39
Results of creating equipment phases in a project by synchronizing ............... 41
Open an equipment phase in Logix Designer from FactoryTalk Batch Equipment
Editor .................................................................................................................................... 44
Project file equipment phase changes ............................................................................. 44
Synchronize to update equipment phases in the project file ............................. 46
Updated project file ................................................................................................... 50
Deleted parameters and reports............................................................................... 51
View synchronization issues ............................................................................................. 51
Cannot Synchronize messages - create or update project................................... 52
Chapter 4
Chapter 5
Chapter 6
PhaseManager introduction
See also
See also
Intended audience The information in this guide is for FactoryTalk Batch system designers, process
engineers, and control engineers who are using PhaseManager to develop a batch
automation system with FactoryTalk Batch and Logix Designer to develop phase
logic for Logix5000 controllers.
Logix Designer users who do not use FactoryTalk Batch and only want to create
sequence routines and develop code for a specific piece of equipment that may be
incorporated into a FactoryTalk Batch system use PhaseManager.
See also
What is PhaseManager? In FactoryTalk Batch Equipment Editor, create a phase class to represent a group
of equipment that performs a minor processing activity in a manufacturing plant,
and create a phase when a specific instance of a phase is added to a unit.
An equipment phase is a special kind of program. A state machine built into the
program manages the state of the equipment phase. The state specifies which
routine the phase executes. The phase can be commanded to change states, and
change the routine it is executing. Equipment phase programs have input and
output parameters. Parameters can be configured as Sequencing parameters,
marking these tags as requiring data to be supplied from an internal sequencer
(Equipment Sequence Manager) or external sequencer (FTBatch).
See also
FactoryTalk Batch features PhaseManager adds these features to the FactoryTalk Batch software:
See also
Logix Designer features PhaseManager adds these features to the Logix Designer programming software:
See also
Logix5000 Controller features PhaseManager adds these features to the Logix5000 family of controllers:
See also
How PhaseManager works PhaseManager features work together to provide a seamless workflow that
improves the designing, troubleshooting, and commissioning phases of the
in a FactoryTalk Batch development life cycle. This discussion includes some background information
system about the components of FactoryTalk Batch systems and how FactoryTalk Batch
terminology and concepts are implemented in FactoryTalk Batch and Logix
Designer.
See also
Common Industrial Protocol PhaseManager uses the Common Industrial Protocol (CIP) as the
communication mechanism between the FactoryTalk Batch Server and the
(CIP)
Logix5000 controller. In FactoryTalk Batch, each Logix5000 controller is
represented as a CIP data server that was added and configured in FactoryTalk
Batch Equipment Editor. Logix5000 CIP data servers require RSLinx Classic for
the CIP communications from the FactoryTalk Batch Server to the controller.
The FactoryTalk Batch Server and Logix Designer communicate with the
Logix5000 controller by sending and receiving CIP (Common Industrial
Protocol) messages through RSLinx Classic.
See also
Equipment phases in Logix FactoryTalk Batch Equipment Editor provides the ability to create a model of the
Designer equipment in a manufacturing plant. The phases defined in FactoryTalk Batch
Equipment Editor define the capabilities of a piece of equipment, or what the
equipment can do. When adding an instance of a phase class to a specific unit,
create a phase. Each phase represents a unique piece of equipment that can
perform the processing activity described by the phase.
Using Logix Designer with PhaseManager, can also create equipment phases in
Logix Designer controllers. An equipment phase in Logix Designer is a type of
program that represents both the specific piece of equipment and its capabilities,
or the processing activity it performs. The Logix Designer equipment phase is a
combination of the FactoryTalk Batch phase and the phase it was created from.
PhaseManager adds special Relay Ladder Logic (RLL) and Structured Text
instructions to Logix Designer used when developing phase logic to interact with
the FactoryTalk Batch Server, and for internally manipulating the equipment
phase objects in the Logix5000 controller.
See also
Equipment phase With PhaseManager, create a phase in FactoryTalk Batch Equipment Editor or
synchronization edit the definition of equipment phases, including parameters and reports, in
either FactoryTalk Batch Equipment Editor or in Logix Designer and synchronize
them in FactoryTalk Batch Equipment Editor. FactoryTalk Batch Equipment
Editor contains the tools to view synchronization status and manage the
synchronization process.
Tip: These types of phases must be initially created and edited in FactoryTalk Batch
Equipment Editor and added to Logix Designer through the synchronization
process:
• Material phases
• Phases that contain control strategies
• Phases that contain parameter deviations
See also
Integration of FactoryTalk PhaseManager adds the ability to double-click a phase in FactoryTalk Batch
Batch Equipment Editor with Equipment Editor and open its corresponding equipment phase in Logix Designer
to view and edit its phase logic.
Logix Designer
Place the pointer over a phase that is assigned a CIP data server, the pointer
changes to the Logix Designer equipment phase symbol, indicating to double-click
to open Logix Designer.
See also
Benefits of using PhaseManager improves existing functionality, and how using PhaseManager and
the Common Industrial Protocol (CIP) differs from using FactoryTalk Batch
PhaseManager and CIP with the OPC communication protocol.
instead of OPC
See also
Reduced phase logic Without PhaseManager, a control engineer must implement the Phase Logic
programming Interface (PLI), which is a set of ladder logic (RLL) routines that provides the
controller interface to the FactoryTalk Batch Server and executes the command
handshake protocol required by the server to communicate with the controller.
This communication protocol is implemented using OPC and communication
tags or other memory locations in the controller to hold commands, requests, and
other data needed by the PLI. When OPC is used, the FactoryTalk Batch Server is
compatible with any type of controller, including Logix5000 controllers, PLC-5s,
or controllers manufactured by any vendor.
In Logix Designer with PhaseManager, the functionality associated with the PLI is
embedded into the Logix5000 controller by means of equipment phase objects
and instructions. Since PhaseManager implements the PLI functionality in the
Logix5000 controller, do not implement PLI routines when using PhaseManager
to create and maintain equipment phases in the FactoryTalk Batch system.
All commands previously supported from the FactoryTalk Batch Server to the
controller, such as sending a parameter value to the controller, are also supported
by PhaseManager. Likewise, all requests from the controller to the FactoryTalk
Batch Server, such as the controller requesting a new parameter value, are also
supported by PhaseManager. How these commands are sent is different when
PhaseManager is used, due to the use of CIP messaging.
See also
Eliminates duplicate equipment In a FactoryTalk Batch system using the OPC communication protocol and the
phase and tag configuration Logix Designer programming software, manually enter communication tag data
for each of the ten standard tags and for each parameter, report, and additional
request tag on each phase in FactoryTalk Batch Equipment Editor. In Logix
Designer, manually create the corresponding tags. Each Tag Name entered in
Logix Designer must match the Tag Item Name entered in FactoryTalk Batch
Equipment Editor. Additionally, in Logix Designer manually create the tags
required for the PLI and FactoryTalk Batch Server communications.
Through synchronization, these tag names from the phase are automatically
created on the corresponding equipment phases in Logix Designer.
See also
Compatible tag data types The data types of the input and output parameter tags defined in Logix Designer
must be compatible with the data types supported in FactoryTalk Batch
Equipment Editor. These data types are supported:
Logix Designer Data Type Corresponding FactoryTalk Batch Equipment Editor Data Types
Real Real
DINT, INT, SINT Integer
DINT, INT, SINT Enumeration
String String
See also
Open phase logic in Logix PhaseManager gives the ability to double-click a phase in FactoryTalk Batch
Designer from FactoryTalk Equipment Editor and directly view and edit its phase logic in Logix Designer.
Logix Designer opens to the equipment phase in the project file that corresponds
Batch Equipment Editor to the phase selected in FactoryTalk Batch Equipment Editor. It is not necessary
to manually open Logix Designer and navigate to the equipment phase to view or
edit the phase logic for a phase in FactoryTalk Batch.
See also
Improved implementation of Logix Designer with PhaseManager improves the implementation of equipment
phases in Logix5000 controllers. Using OPC and the PLI, a phase is typically
phase logic routines
executed in a single relay ladder logic (RLL) routine that implements logic for all
of the active states defined by the S88 standard. These active states include
Stopping, Starting, Running, Holding, Aborting, and Restarting.
Use other Logix Designer program features when developing equipment phase
logic. These features include the ability to use timing diagnostics information, Max
and Last Scan, for debugging equipment phases in Logix Designer, and the ability
to configure a fault routine for the equipment phase.
See also
Additional resources These documents contain additional information concerning related Rockwell
Automation products.
Resource Description
FactoryTalk Batch Equipment Editor User Guide The FactoryTalk Batch Equipment Editor is a graphical
interface used to create and maintain an equipment
database. This process equipment database is called an
area model. The area model is stored in a file with a .cfg
file extension and is available to all other FactoryTalk
Batch programs, including the Recipe Editor, View, and
Phase Simulator.
Logix Designer online help. The Logix Designer application provides one
programming software for sequential, process, drive, and
motion control programming that is compliant with the
EC61131-3 standard. The Logix Designer application
supports symbolic programming with structures and
arrays, and an instruction set that serves many types of
applications in an environment that is common to the
Rockwell Automation® Logix platforms: ControlLogix and
CompactLogix.
The Logix Designer application is designed to work with
Rockwell Automation Logix Platforms and the
Logix5000™ family of controllers.
Logix5000 Controllers PhaseManager User Manual Provides set up and program information for a Logix5000
controller to use Equipment Phases. It gives guidance and
examples to:
• Lay-out code in sections that include Equipment
Phases.
• Set up a state model for equipment.
• Program equipment to run by the state model.
Use Equipment Phase instructions to transition to a
different state, handle faults, set up break points, and so
forth.
FactoryTalk Batch PCD Programmer Technical Reference Provides information and instructions about the
Guide FactoryTalk® Batch-PCD interface design. It is intended to
be used as a reference guide.
This section describes how to configure data servers and phases in FactoryTalk
Batch Equipment Editor so these PhaseManager features can be used:
See also
Add a Logix5000 CIP data Add data servers either before creating the rest of the elements in the area model,
or after the process cells, unit classes, phase classes, and resources in the area model
server are defined. Define at least one data server before creating the specific phases from
the phase classes.
If possible, create the project file in Logix Designer before adding a Logix5000 CIP
data server. Specify the project file when a Logix5000 CIP data server is added to
detect errors more easily when designing the system.
See also
Specify the data server name To add data servers, give each one a name and specify the type of data server. Add
and type one data server for each Logix5000 controller in the system. When creating
phases, assign a data server to each one.
2. Select Edit > Data Server. The Data Servers dialog box opens.
3. Select the Add... button. The Add Data Server dialog box opens.
4. In Name, enter a name for the data server. This name should easily identify
the Logix5000 controller that this data server represents. A suggested name
is the type of Logix5000 controller and its location in the chassis, or the
phase/ unit that this controller is connected to in the plant.
Tip: When ready to synchronize the area model with the Logix Designer project, this
name displays in the Synchronize Logix5000 Data Servers dialog box. Choose
which data server to synchronize by selecting its name.
Now that a data server is added, there are several ways to proceed:
• To create phases in the area model, select OK to close this dialog box. Finish
adding information about the data server later.
• If the Logix Designer project file associated with this data server is known,
continue to Select a project file.
• If the project file associated with this data server is not known, the
controller to be used is known, see Select the controller network path.
See also
Select a project file After a name for Logix5000 CIP data server is specified, select the Logix Designer
project file that contains the phase logic for the controller this data server
represents.
Select a project file for a data server the Logix Designer project is synchronized.
Specify a project file and synchronize the area model with the Logix Designer
project to allow full use of the PhaseManager features to easily detect errors while
designing the FactoryTalk Batch system.
Important: To select a project file, install Logix Designer on the same computer as
FactoryTalk Batch Equipment Editor.
1. Complete these steps in the Add or Edit Data Server dialog box.
5. Navigate to the Logix Designer project (.acd file) that contains the phase
logic for the controller this data server represents. Select it and select Open.
Tip: The Logix Designer project file must be revision 16.0 or higher.
The Edit Data Server dialog box displays the Path of the project file
selected, the Revision of the project file, and the Controller Type that the
project file specifies.
The Controller Network Path also displays the communications path that
is specified in the Path box of the Logix Designer project.
7. Select OK. The Controller Network Path box displays <unknown>. Select
a Controller Network Path later. (See Select the controller network path
for more information.)
Tip: If any other error messages are encountered when a project file is selected, see
Select a project file - error messages for a list of possible error messages and
how to resolve them.
• Synchronize this data server with the Logix Designer project file selected.
(See Synchronize to create equipment phases in the project file for more
information.)
• Run the FactoryTalk Batch Server, only if the Controller Network Path is
specified.
• Select a Controller Network Path if one was not specified in the Logix
Designer project file. (See Select the controller network path for more
information.)
• Create phases in the area model.
• To adjust the timing of the FactoryTalk Batch Server communications to
the controller, see Optimize the timing of the server communication
connection to the controller.
See also
Select a project file - error messages If error messages display when a Logix Designer project file is selected, use this
table to troubleshoot.
The Logix Designer project file is Disable the Read-Only Attribute for the selected project file. In Windows Explorer,
read-only and cannot be opened. navigate to the selected file in the Select Project File dialog box. Open the
Properties dialog box for the file and verify that the Read-Only Attribute is not
selected.
The Controller Network Path is not set Set the Path for the project file in Logix Designer and save the .ACD file in Logix
in the Logix Designer project file. The Designer. Select the project file again in FactoryTalk Batch Equipment Editor.
Controller Network Path could not be OR
verified.
Manually select the Path in FactoryTalk Batch Equipment Editor. (See Select the
controller network path for more information.)
The Controller Network Path set in The driver specified in the Path in the Logix Designer project must also be
the Logix Designer project file could configured in RSLinx.
not be verified. Confirm that RSLinx is In the Project file, modify the Path to include a driver that is configured in RSLinx.
configured appropriately for this Or in RSLinx, configure a driver to match the driver specified in the project file Path.
Controller Network Path.
The Logix Designer project file The installed revision of Logix Designer and the revision of the selected project file is
revision does not support phases. Use lower than revision 16.0.
revision 16.0 or greater. Upgrade the revision of Logix Designer to 16.0 or higher. Open the selected project
file in Logix Designer, to convert the file to the upgraded revision.
See also
Select the controller network The controller network path is the network communication path to the controller
this data server represents. This is the controller the FactoryTalk Batch Server
path
communicates with.
If the Logix Designer project file specifies the communications Path, it is not
necessary to select it. It is automatically entered when the Logix Designer project
file is selected.
However, if the Logix Designer project file is not selected, or the selected one did
not contain a communications Path, select one before running the FactoryTalk
Batch Server.
Install RSLinx Classic must on the same computer as FactoryTalk Batch Equipment Editor
to select a Controller Network Path.
1. Complete these steps in the Add or Edit Data Server dialog box.
2. Select the Logix5000 CIP data server to set the controller network path.
4. Choose Select Path. The Browse for Controller dialog box opens.
5. Navigate to the controller, and select it. The communications path of the
controller selected displays in the Controller Network Path box at the
bottom of the dialog box.
6. Select OK to close the Browse for Controller dialog box. In the Edit Data
Server dialog box, the communications path selected displays in the
Controller Network Path box.
Tip: An asterisk (*) at the end of the Controller Network Path indicates that the
controller network path was set using Select Path instead of browse. If there is
an *, the controller network path displayed may be different from the Path
specified in the Logix Designer project file.
For a selected Logix Designer project file, synchronize the data server with the
Logix Designer project file. (See FactoryTalk Batch phases in Logix Designer
for more information).
See also
Optimize the timing of the Use these instructions to optimize the timing of the server communication
connection to the controller.
server communication
connection to the controller To optimize the timing of the server communication connection to the
controller:
1. Select Edit > Data Server. The Data Servers dialog box opens.
3. The default values are the recommended settings for these boxes. However,
adjust these values for the speed of the network.
Name Value
Timeout How often the FactoryTalk Batch Server attempts to contact the controller. The range
of valid values is 500 to 100000 milliseconds. The default is 8000.
Retries The number of times the FactoryTalk Batch Server tries to contact the controller before
dropping the connection. The valid values appear in the list. The default is 4.
Timeout * Retries = Length of time the FactoryTalk Batch Server attempts to contact the controller before losing the
connection.
See also
Edit a Logix5000 CIP data Use these instructions to edit a Logix5000 CIP data server.
1. Select Edit > Data Server. The Data Servers dialog box opens.
2. Select the data server definition to be edited, and select Edit. The Edit Data
Server dialog box opens.
3. Make any required changes and select OK to return to the Data Servers
dialog box.
Tip: After adding a data server as a Logix5000 CIP type data server, the type cannot
change. No other data server types appear in the Type selection list when editing.
To change the Type, delete the data server and add a new one.
4. (optional) To delete a data server, select the data server to delete and select
Remove.
• If the data server is not assigned to any phases, this message displays:
• If the data server is assigned to phases, the Remove Server dialog box
opens, displaying these phases and unit tags associated with the data
server.
The displayed unit tags and phases, as well as their parameter, report,
and limit tags are deleted when the data server is removed.
• Select Yes to delete the data server and remove all associated phases and
tags.
See also
Assign a Logix5000 CIP data After adding a Logix5000 CIP data server, assign it to each phase that represents a
piece of equipment connected to the controller specified in the controller network
server to a phase path of the Logix5000 CIP data server.
1. Select the phase icon in the Design View area and select Edit > Properties.
The Edit Phase dialog box, General tab displays.
2. From the Data Server list, select the Logix5000 CIP data server that
represents the controller connected to the piece of equipment defined by
this phase.
3. Select OK.
See also
Assign a data server to all When creating a unit, assign a data server to the unit. This data automatically
phases in a unit assigns to all phases subsequently created in that unit.
1. Select the unit icon in the Design View area and select Edit > Properties.
The Edit Unit dialog box, General tab displays.
2. From the Data Server list, select the Logix5000 CIP data server that
represents the controller connected to all phases created in this unit.
3. Select OK.
See also
After the Logix5000 data servers are added and assigned to phases, create the same
phases in the Logix Designer programming software by synchronizing the area
model with the Logix Designer project file.
This section describes how to synchronize the FactoryTalk Batch area model with
the Logix Designer project file when the phases in FactoryTalk Batch Equipment
Editor are created and corresponding equipment phases in Logix Designer are
needed. Phases based on these types of phases must be initially created in
FactoryTalk Batch Equipment Editor and added to Logix Designer through the
synchronization process:
The features to configure these types of complex phases are unique to the
FactoryTalk Batch product. Logix Designer does not have the configuration
features to enable material phases, control strategies, or parameter deviations. For
that reason, configure these phase classes and phases in FactoryTalk Batch first,
and then follow the instructions in this chapter to synchronize the area model
with the Logix Designer project file. When corresponding equipment phases in
Logix Designer are synchronizing, the appropriate configuration of parameters,
reports, and tags on these complex phases are automatically created on the
equipment phases in Logix Designer.
After equipment phases are created in the Logix Designer project, begin
developing phase logic for them in Logix Designer.
See also
Synchronize the area model Use these instructions to synchronize the area model with the project file.
See also
Save the area model and select Use these steps to begin synchronizing the area model with the Logix Designer
a data server project.
1. From the Edit menu, select Synchronize Logix5000 Data Servers. The
Save Before Synchronization dialog box opens.
2. Select Save to save the area model file now, or select Continue Without
Saving.
• If Save is selected, the Save As dialog box opens. Save the area model
with its existing name or give it a different name.
• After saving or continuing, the Synchronize Logix5000 Data Servers
dialog box opens.
3. Select the data server that was added for the new Logix5000 controller.
Tip: Select any column headings to sort the list of data servers.
Important: The data server selected must have the project file specified.
5. Select the phases to create in the area model. Continue to Select phases.
See also
Select phases and synchronize Select phases on the Synchronize with Logix5000: <data server name> dialog
box.
1. The left pane of the Synchronize with Logix5000: <data server name>
dialog box displays the units in the area model that contain phases assigned
to the selected data server. Only units that contain phases different from the
equipment phases in Logix Designer display. Expand a unit by selecting the
plus sign next to it, to view the phases it contains.
2. Select a unit. The phases it contains display in the right pane. Only phases
different from the equipment phases in the Logix Designer project display.
4. Select the Resolution box for the selected phase and select Create in
Project.
Tip: If the only Resolution available is Cannot Synchronize, select Details to see a
message that explains why the phase cannot be synchronized.
This dialog box shows any differences that exist between the phase in
FactoryTalk Batch Equipment Editor and the corresponding equipment
phase in Logix Designer.
In this example, the parameters and reports configured for the phase in
FactoryTalk Batch display in the Batch Configuration area on the left.
Since this phase only exists in FactoryTalk Batch Equipment Editor, the
Logix Designer side is blank.
Tip: Although the report limit tags are defined as Input tags in Logix Designer, they
display with the reports on the Equipment Phase Synchronization Details
dialog box. Other reports are defined as Output tags in Logix Designer.
7. Repeat steps 3 - 5 for each phase in the selected unit to be created in the
Logix Designer project.
8. Repeat steps 2 - 6 for each unit that contains phases to be created in the
Logix Designer project.
The phases selected are created in the Logix Designer project. Next review the
results of the synchronization and save the Logix Designer project file. Continue
on to Review results and save files.
See also
Review results and save files Use these instructions to review results and save files.
Tip: If Failed displays in the Result column, the reason displays in the Additional
Information column.
If not satisfied with the results, select No. The synchronization changes displayed
are not saved in the Logix Designer project file.
When Close is selected, the Save After Synchronization dialog box opens
if changes were made to the area model.
3. Select Save to save the area model, overwrite the area model, or save it with a
different name.
After creating the equipment phases in the Logix Designer project, begin
developing phase logic for them in Logix Designer.
See also
Results of creating equipment When synchronizing the area model with the Logix Designer project file and
phases in a project by creating equipment phases in the project, several items are created in the project.
This table shows how the elements of a phase are created for a corresponding
synchronizing equipment phase in the Logix Designer project:
Do not edit the phase tags containing a leading underscore (_) in the Logix
Designer project. If the Name, Usage, or Data Type of these phase tags in Logix
Designer are changed, synchronization cannot be used to apply changes to the
area model.
Report Limit Tags Phase Tags with a Usage of An underbar ( _ ) prepends to the
Input tag name.
Control Strategies Phase Tag named Data Type is DINT.
_CONTROL_STRATEGY with a
Usage of Input.
Material-based Phases Adds these Phase Tags with a Usage of Input:
• _MATERIAL Data Type is DINT.
• _AMOUNT Data Type is REAL.
Adds these Phase Tags with a Usage of Input if these optional
parameters exist on the phase in the area model:
• _CONTAINER Data Type is DINT.
• _LOT Data Type is STRING.
• _MATERIAL_CLASS Data Type is DINT.
• _LABEL Data Type is STRING.
Adds these Phase Tags with a Usage of Output:
• _ACTUAL_AMOUNT Data Type is REAL.
• _FEED_COMPLETE Data Type is DINT.
See also
Open an equipment phase Now that equipment phases in the Logix Designer project are created, open those
equipment phases in Logix Designer from their corresponding phases in
in Logix Designer from FactoryTalk Batch Equipment Editor.
FactoryTalk Batch
To open an equipment phase in Logix Designer from FactoryTalk Batch
Equipment Editor Equipment Editor:
1. In FactoryTalk Batch Equipment Editor, place the pointer over a phase that
was just created in the Logix Designer project. The pointer changes to the
Logix Designer equipment phase symbol.
2. Double-click the equipment phase symbol over the phase. Logix Designer
opens to the selected equipment phase in the project.
3. Next, develop phase logic for the equipment phases created in the Logix
Designer project.
See also
If the phases in FactoryTalk Batch Equipment Editor are changed and the
Project file equipment
corresponding equipment phases in the Logix Designer project need to be
phase changes updated, detect and make the appropriate changes by synchronizing the area
model with the project file.
For example, if a parameter or report changes on the phase class that a phase was
created from in FactoryTalk Batch, apply the change to the corresponding
equipment phases in the Logix Designer project.
Do not delete an equipment phase from the project file by synchronizing the area
model with the project. If deleted a phase from the area model in FactoryTalk
Batch Equipment Editor, manually delete the corresponding equipment phase
from the project in Logix Designer.
44 Rockwell Automation Publication BATCHX-UM011D-EN-P - February 2017
FactoryTalk Batch phases in Logix Designer Chapter 3
These types of changes to the phase in FactoryTalk Batch Equipment Editor can
be transferred to the corresponding equipment phase in Logix Designer through
synchronization:
• Phase name
• Equipment ID
• Addition, deletion, or modification of parameters on the phase class that
the phase is associated with
• Addition, deletion, or modification of reports on the phase that the phase is
associated with
• Enabling, disabling, or changing the parameter or report limit tags on the
phase
• Enabling or disabling Control Strategy or Material Based Recipe
functionality for the phase class that the phase is associated with
After changes to the area model in FactoryTalk Batch Equipment Editor are made,
transfer these changes to the equipment phases in the Logix Designer project.
See also
Synchronize to update Use these instructions to synchronize to update equipment phases in a project:
equipment phases in the
To synchronize to update equipment phases in the project file:
project file
1. Save the area model and select a data server to synchronize. See Save the
area model and select a data server for more information.
Tip: Only phases different from the equipment phases in the Logix Designer project
display in the Synchronize with Logix5000: <data server name> dialog box.
3. (optional) To view the configuration details of the selected phase, select the
phase and select Details to open the Equipment Phase Synchronization
Details dialog box.
4. In the Resolution box, select Update Project for each phase to update in
the Logix Designer project.
6. Review the results, and save the project and area model files. See Review
results and save files for more information.
Tip: If Failed displays in the Result column, the reason displays in the Additional
Information column.
See also
Updated project file When the updated project file in Logix Designer opens, a new Phase Tag was
creates for each new parameter or report that was added to the equipment phase
in the project as a result of the synchronization. Input tags create for parameters.
Output tags are create for reports.
In this example, these new Phase Tags were added to the WP_ AGITATE_M2
equipment phase:
• VISCOSITY
The Usage of this new Phase Tags is Input because it corresponds to the
VISCOSITY parameter in the area model.
Parameter and report limit tags are created with a Usage of Input, because they
represent data being sent from the FactoryTalk Batch Server to the controller.
See also
Deleted parameters and reports When a parameter or report deletes from a phase in the area model and
synchronizes to update the project, the Phase Tag remains in the Logix Designer
project, but the Usage changes to <normal>.
See also
View synchronization issues Under certain circumstances, a FactoryTalk Batch phase or a Logix Designer
equipment phase cannot be synchronized. When this occurs, the Synchronize
with Logix5000:<data server name> dialog box displays a Resolution of Cannot
Synchronize. No other resolutions are available to select.
2. Select Details to see a message that explains why the phase cannot be
synchronized. For a list of messages, see Cannot Synchronize messages -
create or update area model.
See also
Cannot Synchronize messages - This table lists the Cannot Synchronize messages in the Equipment Phase
create or update project Synchronization Details dialog box for phases that exist in the FactoryTalk
Batch area model:
Logix Designer Even though parameter and report names can Change the phase name in the area model,
parameter/report name contain two or more consecutive underbars, removing the consecutive underbars, and
cannot contain consecutive these names cannot be created as equipment then try synchronizing again. For example,
underbars. phases in Logix Designer through the the name ADD_AMOUNT is a valid name
synchronization process. For example, because it contains only single underbars.
ADD__AMOUNT, is not a valid name.
Logix Designer name must Logix Designer does not support the use of Change the phase class, phase, parameter,
contain only ASCII non-ASCII characters for the names of or report name in the area model to contain
characters. equipment phases, parameters, and reports. If only ASCII characters, and then try
a FactoryTalk Batch phase, parameter, report, synchronizing again.
or recipe phase the phase was created from,
contains non-ASCII characters, cannot be
synchronized.
For descriptions of Cannot Synchronize messages for equipment phases that exist
in the Logix Designer project, see Cannot synchronize messages - create or
update area model.
See also
After creating phases in the FactoryTalk Batch area model, integrate the new
machine into the plant, bring the Logix5000 controller online with the updated
Logix Designer project, and perform a warm restart of the FactoryTalk Batch
Server to include the phases in the FactoryTalk Batch control system.
This section describes how to synchronize the FactoryTalk Batch area model with
the Logix Designer project file when equipment phases are created in Logix
Designer and corresponding phases need to be created in FactoryTalk Batch
Equipment Editor.
See also
Synchronize to create Use these instructions synchronize the area model to create phases.
3. Select a phase and unit for the new phase and synchronize.
OR
Create a new phase for the phase, select a unit, and synchronize.
See also
Save the area model and select Use these steps to begin synchronizing the area model with the Logix Designer
a data server project.
1. From the Edit menu, select Synchronize Logix5000 Data Servers. The
Save Before Synchronization dialog box opens.
2. Select Save to save the area model file now, or select Continue Without
Saving.
• If Save is selected, the Save As dialog box opens. Save the area model
with its existing name or give it a different name.
• After saving or continuing, the Synchronize Logix5000 Data Servers
dialog box opens.
3. Select the data server that was added for the new Logix5000 controller.
Tip: Select any column headings to sort the list of data servers.
Important: The data server selected must have the project file specified.
5. Select the phases to create in the area model. Continue to Select phases.
See also
Select phases Select phases on the Synchronize with Logix5000: <data server name> dialog
box.
To select phases:
1. The left pane of the Synchronize with Logix5000: <data server name>
dialog box displays the phases in the project assigned to the selected data
server. Only phases that exist in the Logix Designer project, but not in the
area model display under Logix Designer-only Equipment Phases.
Tip: If other phases assigned to the selected data server exist in the area model but not
in the project file, or are different from those in the project file, they also display in
the left pane beneath the area model name, within their units.
3. Select the Resolution box for the selected phase and select Create in Area
Model.
Tip: If the only Resolution available is Cannot Synchronize, select Details to see a
message that explains why the phase cannot be synchronized. (See View
synchronization issues for more information.)
Next, associate the new phase with an equipment phase and select a unit to
contain it in the area model. Select an existing phase in the area model or create a
new one.
• To associate the phase with a phase that exists in the area model, continue
on to Select a phase and unit to synchronize.
• To create a new phase in the area model to associate with the phase, skip to
Create a new phase and select a unit.
See also
Select a phase and unit to Use these instructions to select a phase and unit.
synchronize To select a phase and unit to synchronize:
1. In the Phase Classes box, select a phase class to associate with the new
phase. Select a phase to display a list of units in the Units box.
Tip: The new phase is an instance of the phase selected. Therefore, only phases that
have the same parameters and reports as the new phase display.
Tip: Only units that do not contain a phase based on the selected phase are displayed,
unless the selected phase is a material-based phase. A unit can only contain one
phase based on a specific phase class, with the exception of material-based phase
classes. Multiple phases based on a specific material-based phase class can be
added in one unit.
Repeat steps 1 - 3 or skip to Create a new phase and select a unit to create
a new phase for the next phase.
Tip: If Failed displays in the Result column, the reason displays in the Additional
Information column.
5. If satisfied with the results, select Yes to save the Logix Designer project file.
Tip: If not satisfied with the results, select No. The synchronization changes are not
saved in the Logix Designer project file.
When Close is selected, the Save After Synchronization dialog box opens
if changes were made to the area model.
7. Select Save to open the Save As dialog box and save the area model.
Overwrite the area model or save it with a different name.
The phase has been added to the area model. View the new phase by
navigating to the unit selected in step 2.
See also
Create a new phase and select a Use these instructions to create a new phase and select a unit.
unit
To create a new phase and select a unit:
1. In the box beneath the Phases list, enter a name for the new phase. A list of
units displays in the Units box.
Tip: Only units that do not contain a phase based on the selected phase class are
displayed, unless the selected phase class is a material-based phase class. A unit
can only contain one phase based on a specific phase class, with the exception of
material-based phase classes. Multiple phases based on a specific material-based
phase class can be added in one unit.
Repeat steps 1 - 4 or see Select a phase and unit to select an existing phase
class for the next phase.
When synchronization of all selected phases is complete, the
Synchronization Results Summary For Server:<data server name> dialog
box opens.
Tip: If Failed displays in the Result column, the reason displays in the Additional
Information column.
6. If satisfied with the results, select Yes to save the Logix Designer project file.
Tip: If not satisfied with the results, select No. The synchronization changes are not
saved in the Logix Designer project file.
Incomplete Some Results were Failed, Skipped, or No was selected to not save the project file.
Never Synchronized Never been an attempt to synchronize the data server.
8. Select Save to open the Save As dialog box and save the area model.
Overwrite the area model or save it with a different name.
9. The phase class and new phase are added to the area model. View the new
phase by navigating to the unit selected in step 3.
From this new Logix5000 CIP phase in FactoryTalk Batch Equipment Editor,
open the corresponding equipment phase in Logix Designer to view and edit the
phase logic. (See Open an equipment phase in Logix Designer from
FactoryTalk Batch Equipment Editor for more information.)
See also
Phases in the area model If changes are made to equipment phases in the Logix Designer project and the
corresponding phases in the area model need to be updated, detect and make the
appropriate changes by synchronizing the area model with the project file.
For example, if a phase tag is added or changed on the equipment phase in the
Logix Designer project, apply the change to the corresponding phase classes and
phases in the area model.
Delete a phase by synchronizing the area model with the project. If an equipment
phase is deleted in Logix Designer, manually delete the corresponding phase in
FactoryTalk Batch Equipment Editor. Likewise, if a phase is deleted in
FactoryTalk Batch Equipment Editor, manually delete the corresponding
equipment phase in Logix Designer.
These types of changes to the equipment phase in the Logix Designer project can
be transferred to the corresponding phase classes and phases in the area model
through synchronization:
After any of these changes to the project file in Logix Designer are made, complete
the steps in these sections to transfer these changes to the area model in
FactoryTalk Batch Equipment Editor.
Do not edit these phase tags containing a leading underscore (_) in the Logix Designer
project: parameter and report limit tags, _CONTROL_STRATEGY, _MATERIAL, _AMOUNT,
_CONTAINER, _LOT, MATERIAL_CLASS, _LABEL, _ACTUAL_AMOUNT,
_FEED_COMPLETE.
If the Name, Usage, or Data Type of these phase tags in Logix Designer is changed,
changes are not applied to the area model through synchronization.
See also
Synchronize to update phases Use these instructions to synchronize to update phases in the area model.
in the area model
Tip: Only Logix Designer phases different from the phases in the area model display in
the Synchronize with Logix5000: <data server name> dialog box.
1. Save the area model and select a data server to synchronize. See Save the
area model and select a data server for more information.
2. Select the phase to update in the area model. See Select phases and
synchronize and FactoryTalk Batch phases in Logix Designer for more
information.
3. (optional) To view the configuration details of the selected phase, select the
phase and select Details to open the Equipment Phase Synchronization
Details dialog box.
5. In the Resolution list, select Update Area Model for the phase to update
in the Logix Designer project.
7. Select Synchronize.
Tip: If a Result Failed, the reason displays in the Additional Information column.
9. Select Close. The Save After Synchronization dialog box opens if changes
were made to the area model.
10. Select Save to open the Save As dialog box and save the area model.
Overwrite the area model or save it with a different name.
See also
View synchronization issues Under certain circumstances, a FactoryTalk Batch phase or a Logix Designer
equipment phase cannot be synchronized. When this occurs, the Synchronize
with Logix5000:<data server name> dialog box displays a Resolution of Cannot
Synchronize. No other resolutions are available to select.
2. Select Details to see a message that explains why the phase cannot be
synchronized. For a list of messages, see Cannot Synchronize messages -
create or update area model.
See also
Cannot synchronize messages - This table lists the Cannot Synchronize in the Equipment Phase
create or update area model Synchronization Details dialog box for equipment phases that exist in Logix
Designer:
For descriptions of Cannot Synchronize messages for phases that exist in the area
model, see Cannot Synchronize messages - create or update project.
See also
Important: The information in this section only applies to programming phase logic
for PhaseManager phases assigned to a Logix5000 CIP data server.
PhaseManager phases created with a Logix5000 CIP data server, use the PXRQ
instruction provided in Logix Designer as a means for the phase logic to request
data or services from the FactoryTalk Batch Server. Much of the work involved
with writing phase logic centers around defining a sequence of steps for a phase.
Some of these steps require interaction with the FactoryTalk Batch Server. For
example, the phase logic for a charge phase may perform these steps to add
material to a unit:
See also
Phase Logic programming This sequence describes the programming model that the phase logic typically
needs to follow:
model
1. Prepare for request (set reports, for example).
Tip: Allowing the phase logic to transition the phase to a terminal state (STOPPED,
ABORTED, COMPLETE) without first verifying that the Process Complete (.PC) bit
has been set to 1 (one) by the FactoryTalk Batch Server can result in future
executions of the phase logic receiving faulty parameter data and can also result in
the phase logic failing to release needed equipment.
See also
During batch execution, phase logic can send a request to the FactoryTalk Batch
Download parameters
Server to download all input parameter values, a single input parameter value, or a
(input parameters) request range of input parameter values, including phase parameter limits that exist.
The parameter values may be specified when adding a phase to a recipe using
FactoryTalk Batch Recipe Editor. If the phase parameter value is not specified
when the recipe is built, the FactoryTalk Batch Server sends FactoryTalk Batch
View a request for the value when a Download Input Parameters or Download
Input Parameters Subset request is received from the phase. FactoryTalk Batch
View requests the phase parameter value from the operator by way of an
Unacknowledged Prompt.
See also
Phase parameter tags array When an equipment phase creates in the process controller, the input parameter
tags defined in the area model are viewed by the FactoryTalk Batch Server as a
logical array. When processing a download request, the phase parameter values
write into the phase parameter array.
See also
Types of download parameter Using the PXRQ instruction, specify the Download Input Parameters external
request for these types of requests:
requests
• Download all parameters (input parameters)
• Download a range of parameters (input parameters)
• Download a single parameter (input parameter)
Specify the Download Input Parameters Subset external request for these types
of requests:
The Data Values specified for the Download Input Parameters or the
Download Input Parameters Subset request determine the type of request.
See also
Download all parameters (input Configure the PXRQ instruction in Logix Designer to download values for all
parameters) configured input parameters to the input parameter array:
If control strategies are enabled, only those parameters assigned to the recipe’s
control strategy will be downloaded. The control strategy parameter is
Parameter1.
See also
Download a range of Configure the PXRQ instruction in Logix Designer to download values for a
parameters (input parameters) range of input parameters:
The FactoryTalk Batch Server downloads the range of parameter values, starting
with the value associated with the requested parameter ID and the values of the
phase parameters with incrementally higher parameter IDs, until the number of
parameters downloaded matches the number of parameters requested. The
parameter IDs need not increase sequentially.
If a phase parameter with the requested parameter ID has not been configured
when receive a download request, the parameter ID increments by one and the
phase parameter configured with that ID is obtained. This process repeats until
the originally requested ID has been incremented up to 999. If the requested
number of phase parameters is not found after the parameter ID increments to
999, the phase request fails. In the phase logic, use the PFL instruction to fail the
batch if desired when a phase request fails.
If the phase associated with the parameter has enabled Control Strategies, only
those parameters belonging to the enabled Control Strategy are included in the
download.
See also
Download a single parameter Configure the PXRQ instruction in Logix Designer to download the value for a
(input parameter) single input parameter:
The FactoryTalk Batch Server downloads a single value for the recipe parameter
associated with the parameter ID and stores the value to the phase parameter array
at the element specified by array index 1. When it receives a download request, a
phase parameter with the requested parameter ID has not been configured, the
parameter ID increments by one and obtains the phase parameter configured with
that ID. This process repeats until the originally requested ID increments up to
999. If the requested number of phase parameters is not found after the parameter
ID increments to 999, the phase request failed. In the phase logic, use the PFL
instruction to fail the batch if desired when a phase request fails.
See also
Download the parameters To download values for input parameters configured for download on start:
configured for download on
start
External Request Data Value Array Element Value
Download Input DINT[0] 1
Parameters Subset
If the phase associated with the parameters has control strategies enabled, only
those parameters belonging to both the enabled control strategy and the specified
subset are included in the download.
See also
Download the parameters To download values for input parameters configured for download on transfer of
configured for download on control:
transfer of control
External Request Data Value Array Element Value
Download Input DINT[0] 2
Parameters Subset
If the phase associated with the parameters has control strategies enabled, only
those parameters belonging to both the enabled control strategy and the specified
subset are included in the download.
See also
Download report limits During batch execution, phase logic can send this request to the FactoryTalk
Batch Server to download report limits information for all reports or for a single
report.
Tip: A report in the FactoryTalk Batch software is an output parameter in the Logix
Designer application.
The limit configuration consists of the report’s verification method and each
configured range of limits. The verification methods are written as values to the
phase’s phase tags. The values for the verification methods are:
See also
Types of download report limits Using the PXRQ instruction, specify the Download Output Parameters external
request for these types of requests:
requests
• Download all output parameter limits information
• Download the output parameter limits configuration for a single report
The Data Values specified for the Download Output Parameters request
determine the type of request.
See also
Download all report limits To download all output parameter limits information to equipment phase tags:
information
External Request Data Value Array Element Value
Download Output DINT[0] 0
Parameter Limits
The FactoryTalk Batch Server downloads the entire phase’s report limit
configuration to the phase’s limit tags.
Download limits configuration To download the limits configuration for a single report (output parameter):
for a single report
External Request Data Value Array Element Value
Download Output DINT[0] Report ID
Parameter Limits
The FactoryTalk Batch Server responds to the request by writing the verification
method and report limits to the limit tags.
Upload report overview During batch execution, phase logic can send this request to the FactoryTalk
Batch Server to upload all report values, a single report value, or a range of report
values.
See also
Report array When an equipment phase creates in the process controller, the phase report
parameter tags defined in the area model are viewed by the FactoryTalk Batch
Server as a logical array.
When processing an upload request, the phase report values write into the phase
report array.
See also
Electronic batch record entries The report values are combined with this information and written as entries into
the electronic batch record. They are also stored in memory so they can be
referenced by transition expressions.
See also
Types of upload report requests An output parameter is the result of the execution of a sequence or procedure. Use
the PXRQ instruction to specify the Upload Output Parameters external
request for these types of requests:
Specify the Upload Output Parameters Subset external request for these types of
requests:
• Upload the output parameters configured for upload load on terminal state
• Upload the output parameters configured for upload on transfer of control
The Data Values specified for the Upload Output Parameters request determine
the type of request.
See also
Upload all reports (output Configure the PXRQ instruction in Logix Designer to upload values for all
configured reports to the report array:
parameters)
External Request Data Value Array Element Value
If control strategies are enabled, only those reports assigned to the recipe’s control
strategy are uploaded.
See also
Upload a range of reports Configure the PXRQ instruction in Logix Designer to upload values for a range of
reports:
(output parameters)
External Request Data Value Array Element Value
Upload Output Parameters DINT[0] Report ID of the first report
Example: 4
DINT[1] Number of reports to download
Example: 3
The FactoryTalk Batch Server uploads the range of parameter values, starting with
the value associated with the requested report ID and the values of the report with
incrementally higher report IDs until the number of reports for which values are
uploaded matches the number of reports requested. The report IDs need not
increase sequentially.
In the example shown above, three report values would be uploaded, beginning
with report ID 4 and including these two reports with sequentially higher report
IDs.
If, when receiving an upload request, a phase report with the requested report ID
not configured, the report ID increments by one and obtains the phase report
configured with that ID. This process repeats until the originally requested ID
increments up to 999. If the requested number of phase reports has not been
found after the report ID increments up to 999, the phase request fails. In the
phase logic, use the PFL instruction to fail the batch if desired when a phase
request fails.
If the phase associated with the report has enabled Control Strategies , only those
reports belonging to the enabled Control Strategy are included in the upload.
See also
Upload a single report (output Configure the PXRQ instruction in Logix Designer to upload the value for a
parameter) single report:
The FactoryTalk Batch Server downloads a single value for the report associated
with the report ID and stores the value to the phase report array at the element
specified by array index 1. The report ID assigns at the time a report creates within
a phase in FactoryTalk Batch Equipment Editor. The report ID is a positive
integer.
Requests to upload a report value refer to the report using a report ID. If, when
receiving an upload request, a report with the requested report ID not configured,
the report ID increments by one and obtains the report configured with that ID.
This process repeats until the originally requested ID increments up to 999. If the
requested number of reports is not found after the report ID incremented up to
999, the phase request failed. In the phase logic, use the PFL instruction to fail the
batch if desired when a phase request fails.
See also
Upload the reports configured Configure the PXRQ instruction in Logix Designer to upload values for reports
configured for upload on transfer of control:
for upload on transfer of control
External Request Data Value Array Element Value
Upload Output Parameters DINT[0] 2
Subset
If the phase associated with the report parameters enabled control strategies , only
those report parameters belonging to both the enabled control strategy and the
specified subset will be included in the upload.
See also
Upload the reports configured Configure the PXRQ instruction in Logix Designer to upload values for reports
for upload on terminal state configured for upload on terminal state:
If the phase associated with the reports enabled control strategies, only those
reports belonging to both the enabled control strategy and the Upload on
Terminal State subset will be included in the upload.
See also
Upload the reports configured Configure the PXRQ instruction in Logix Designer to upload values for reports
configured for upload on transfer of control:
for upload on transfer of control
External Request Data Value Array Element Value
Upload Output Parameters DINT[0] 2
Subset
If the phase associated with the report parameters enabled control strategies, only
those report parameters belonging to both the enabled control strategy and the
specified subset are included in the upload.
See also
Send message to the The set of possible messages that may be sent by the phase logic is configured
when the associated phase is defined in the area model using FactoryTalk Batch
operator and clearing Equipment Editor. Each operator message is configured with a message ID, a
message requests positive integer. Requests to send a message refer to the message using the message
ID. During batch execution, phase logic can make a request to the FactoryTalk
Batch Server to send a message to the FactoryTalk Batch View and place the
message into the electronic batch record.
The phase logic can also be configured to send a Clear Message to Operator
request. This request clears the currently displayed message.
See also
Send message to operator Configure the PXRQ instruction in Logix Designer to display a message to the
operator in the FactoryTalk Batch Client:
values
External Request Data Value Array Element Value
Send Message to Operator DINT[0] Message ID
See also
Clear currently displayed Configure the PXRQ instruction in Logix Designer to clear the currently
displayed message:
message to operator values
External Request Data Value Array Element Value
Clear Message to Operator DINT[0] 0
See also
Acquire resource request During batch execution, phase logic can issue a request to the FactoryTalk Batch
Server to acquire a pre-configured resource. Each resource configured with
FactoryTalk Batch Equipment Editor has an equipment ID, which is a positive
integer. Requests to acquire a resource refer to the resource using the equipment
ID.
Resources acquire when the Acquire Resources request issues. Acquired resources
release either by the Release Resources phase request or when removed the phase
step from the set of active steps in the recipe.
See also
Types of acquire requests Using the PXRQ instruction, to specify the Acquire Resources external request
for these types of requests:
The data values specified for the Acquire Resources request determine which
resources are acquired.
See also
Acquire a single resource value Configure the PXRQ instruction in Logix Designer to acquire a single resource:
See also
See also
Release resources During batch execution, phase logic can issue a request to the FactoryTalk Batch
Server to release a resource. Each resource configured with FactoryTalk Batch
Equipment Editor has an equipment ID, a positive integer. Requests to release a
resource refer to the resource using the equipment ID. Only resources that were
previously acquired with an Acquire Resources phase request can be released
using the Release Resources phase request.
See also
Types of release requests Using the PXRQ instruction, specify the Release Resources external request for
these types of requests:
The data values specified for the Release Resources request determine which
resources are released.
See also
Release a single resource values Configure the PXRQ instruction in Logix Designer to release a single resource:
The FactoryTalk Batch Server releases the resource specified by the equipment ID
if the phase had previously acquired the resource through an Acquire Resources
request.
See also
Release multiple resource Configure the PXRQ instruction in Logix Designer to release multiple resources:
values
External Request Data Value Array Element Value
Release Resources DINT[0] Equipment ID
DINT[1] Equipment ID
DINT[2] Equipment ID
See also
Release all currently acquired Configure the PXRQ instruction in Logix Designer to release all currently
acquired resources:
resources values
External Request Data Value Array Element Value
Release Resources DINT[0] 0
The FactoryTalk Batch Server releases the resources associated with the
equipment IDs if the resources had been previously acquired by this phase through
an Acquire Resource request.
See also
Phase communication Phases controlled by phase steps that belong to a synchronization group are able to
communicate with each other. In fact, this defines the role of the synchronization
group. Messages are sent between the phase steps within the synchronization
group. Each message has a unique message ID, a positive integer. Requests to send
a message to another phase through the synchronization group refer to the
message using the message ID and the number of phases that will receive the
message.
See also:
Send message to one or more linked phases and wait values on page 86
Completion of messages A Send Message Wait and a Receive Message Wait request pair is complete only
if the message IDs for each of the calls are identical. This prevents messages from
being routed to the improper request. Additionally, the Send Message Wait call
must specify the number of receives confirmed as a parameter. This number allows
for synchronization groups with more than two members.
See also
Process send and receive Upon receiving the Send Message call, the FactoryTalk Batch Server stores the
message into the message list and actively responds to outstanding or incoming
messages
Receive Message Wait calls from other phases within the synchronization group.
When receiving a Receive Message Wait call from a phase of the synchronization
group, the Server checks the message ID and completes the message if appropriate.
Upon completion of the message transfer, the Server removes the message from
the message list.
See also
Types of messages to other Use the PXRQ instruction to specify the Send Message to Linked Phase
phases external request for this type of request:
Specify the Send Message to Linked Phase and Wait for this type of request:
• Send a message to one or more linked phases and wait for a response
See also
Send message to one or more linked phases and wait values on page 86
Send a message to one or more Configure the PXRQ instruction in Logix Designer to send a message to one or
more linked phases:
linked phase values
External Request Data Value Array Element Value
Send Message to Linked DINT[0] message ID
Phase
DINT[1] number of phases to receive message
DINT[2] message value
See also
Send message to one or more Configure the PXRQ instruction in Logix Designer to send a message to one or
linked phases and wait values more linked phases and wait for a response:
The receiving partners must issue a request before the data is sent. The sending
partner may send the data at anytime. The sending phase waits for confirmation of
the responses from the total number of receivers before continuing. The data is
cached in the FactoryTalk Batch Server until the receiving partner(s) makes a
request to receive the data.
See also
Message removal The Send Message to Linked Phase call can be canceled by the phase logic that
sent the message. The phase logic can remove the message by using the Cancel
Message to Linked Phase request. Upon receiving the Cancel Message to
Linked Phase request, the FactoryTalk Batch Server removes the message from
the message queue and clears the request on the phase.
Use the PXRQ instruction to specify the Cancel Message to Linked Phase
external request for these types of requests:
See also:
Cancel a single message Configure the PXRQ instruction in Logix Designer to cancel a single message that
was sent to another phase:
The FactoryTalk Batch Server cancels the message associated with the message ID.
The message was previously issued using a Send Message to Linked Phase
request.
See also
Cancel all messages Configure the PXRQ instruction in Logix Designer to cancel all messages that
were sent to another phase:
The FactoryTalk Batch Server cancels all messages that were previously issued with
a Send Message to Linked Phase request.
See also
Receive message from The Receive Message from Linked Phase request allows phase logic to notify the
FactoryTalk Batch Server that it is prepared to receive a message or a set of
linked phase request messages from a linked phase. The Server scans the synchronization group for
pending messages with matching message IDs. Configure the PXRQ instruction
in Logix Designer to send a request to wait for a message from a linked phase:
The data value array can contain up to 97 message values. The Server copies the
messages to the receiving phase from the phase(s) that issued the Send Message to
One or More Linked Phases and Wait request or the Send Message to One or
More Linked Phases request.
Tip: In certain scenarios, a PXRQ instruction that terminates (stops scanning) prior to
completion may no longer function properly unless logic to handle the abnormal
termination conditions is provided. To detect and handle abnormal termination of
a PXRQ request, create logic in the equipment phase Resetting state routine.
For a description of scenarios that cause the PXRQ instruction to terminate
abnormally, along with symptoms of the problem and instructions on how to
implement the necessary Resetting logic, see the Abnormal Termination of
PXRQ Instruction TechNote available on the Rockwell Automation
KnowledgeBase.
See also
Important: The 7600/17600 and 7700/17700 requests are exceptions to the rest of
the requests in this category in that they do NOT require specifying the tag
to which the data will be stored. Instead, the parameter Min and Max
values are downloaded to the actual controller tags associated with the
parameters on the phase itself. Note that the Min and Max values are
downloaded for ALL the parameters on the phase without exception
(including Strings and Enumerations).
The data type of the requested item must match the data type of the specified
parameter.
See also
Generate an electronic During batch execution, phase logic can issue a request to the FactoryTalk Batch
Server to generate a Signature Request. Each Signature Template is assigned a
signature request unique ID, which is a positive integer. Requests to generate a Signature specify the
desired Signature Template ID. Configure the PXRQ instruction in Logix
Designer to generate an electronic signature request:
See also
This table displays a list of all the requests the phase logic can issue to the
PXRQ instruction values
FactoryTalk Batch Server with the PXRQ instruction:
How phase tag requests This table shows how the phase tag requests (PHASE_RQ, PHASEQ01,
PHASEQ02, PhaseQ03) correspond to the requests that can be made with the
map to PXRQ requests PXRQ instruction. Phase tag requests are used in the phase logic for OPC phases
to request data and services from the FactoryTalk Batch Server. The PXRQ
instruction is provided in Logix Designer for requesting data and services from the
FactoryTalk Batch Server for PhaseManager equipment phases.
11500 PHASEQ01 - 1 (Start) or 2 (TOC) Download Input Parameters Subset DINT[0] - 1 (Start) or 2 (TOC)
11600 Download Output Parameter Limits DINT[0] - 0
12500 PHASEQ01 - 1 (Terminal State) or 2 Upload Output Parameters Subset DINT[0] - 1 (Terminal State)
(TOC) or 2 (TOC)
13000 PHASEQ01 - Message ID Send Message to Operator DINT[0] - message ID
13100 Clear Message to Operator
14000 PHASEQ01 - Equipment ID Acquire Resources DINT[0] - equipment ID
141NN PHASEQ01 - Equipment ID Acquire Resources DINT[0] - equipment ID
(NN=number PHASEQ02 - Equipment ID DINT[1] - equipment ID
of resources to PHASEQ03 - Equipment ID DINT[2] - equipment ID
acquire)
14200 PHASEQ01 - Equipment ID Release Resources DINT[0] - equipment ID
143NN PHASEQ01 - Equipment ID Release Resources DINT[0] - equipment ID
(NN=number PHASEQ02 - Equipment ID DINT[1] - equipment ID
of resources to PHASEQ03 - Equipment ID DINT[2] - equipment ID
release)
For String parameters, the request downloads empty strings. For Enumeration parameters, the request downloads a value of zero
(0).
See also
Most of the data within FactoryTalk Batch Material Manager’s material database
is made available to the phase logic programmer for reading, some for writing,
through the PXRQ instruction provided in Logix Designer. Access to the data
requires two things: the controller ID for the database entity and the index of the
data on that entity.
Important: The information in this guide only applies to programming phase logic for
PhaseManager phases assigned a Logix5000 CIP data server.
The three classifications of data in the material database are materials, lots, and
containers.
A lot holds all of the static information about the lot, such as lot identifier,
material type, lot state, engineering units, and controller ID value. A lot has a
parent relationship to sublots, which contain the actual distributed quantity of the
lot in a container.
When PhaseManager material phases are created with a Logix5000 CIP data
server, use the PXRQ instruction provided in Logix Designer as a means for the
phase logic to request data from the Material Server.
See also
Standard attributes Standard attributes are attributes that exist by default on a data entity. The
attribute ID for a standard attribute is the index.
See also
See also
Depletion Date The time when this lot was completely String 9 Read
consumed
Material Material ID value Integer 10 Read
State The state of the lot 1 - Lot Available for Use Integer 11 Read/Write
See also
See also
Custom attributes Custom attributes are user-defined properties of materials, lots or containers.
Custom attributes can be accessed in addition to the standard attributes. Each
property that is added in the FactoryTalk Batch Material Manager material
database has a controller ID, which begins at 1000 and increments by 10. Several
types of data are made available for each attribute, which are indexes.
The attribute ID of the custom attribute calculates from the controller ID plus the
index.
See also
See also
See also
See also
Considerations for writing Writing phase logic for a material phase requires some additional consideration.
The FactoryTalk Batch Server requires that a simple protocol be followed by the
material phase logic phase logic programmer to ensure that inventory levels are properly maintained
within the material database and that the FactoryTalk Batch Event Journal
contains entries identifying the inventory that was produced or consumed.
Protocol:
Tip: When the Automatic Upload function is enabled, the FactoryTalk Batch Server
automatically uploads the appropriate report values when the batch transitions to
a terminal state. If the FactoryTalk Batch Server stops while a material enabled
phase uploads its report parameters, these report parameters upload again during
a Warm or Warm All Batch Server Restart. This also occurs when a material enabled
phase transitions to External while the report parameters are being uploaded.
When the material enabled phase transitions back to Program mode, the report
parameters are uploaded a second time. Sometimes this generates an error that
puts the batch in Hold. Issue a clear failures command, restart the batch, and
execution will proceed normally. To avoid this, disable the Automatic Upload
function and perform report parameter uploads using phase logic requests.
See also
1. The command to START the phase is issued from the FactoryTalk Batch
Server. The RUNNING program eventually begins.
5. The FactoryTalk Batch Server downloads the parameters to the phase logic.
The PCD runs its program to perform a material addition or distribution.
Tip: Hold On Split Feed is set in the Material Policy tab in the Server Options dialog
box in FactoryTalk Batch Equipment Editor.
10. Material, lot, and container data are returned to the FactoryTalk Batch
Server and recorded in the FactoryTalk Batch Event Journal.
See also
FEED_COMPLETE report parameter This table describes FEED_COMPLETE report parameter values:
values
FEED_COMPLETE HoldOnSplitFeed Explanation
TRUE N/A The addition or distribution of the step completes so the SFC continues
running.
FALSE YES The addition or distribution is not complete. The recipe is HELD to prevent the
next step in the SFC from beginning to execute. The step must be rebound to
proceed. The operator must perform an active step change away from the
unfinished step, rebind the step manually, active step change back and
restart the batch.
FALSE NO The addition or distribution is not complete. In the recipe, the material phase
step should have been built within a loop with the transitions testing the
value of the FEED_COMPLETE report as well as the value of the step.state
attribute. When FALSE, the branch looping around to rerun the phase should
be taken.
See also
Recipe execution requests Use the PXRQ instruction in the phase logic to request these types of data
available or meaningful only during Batch execution:
These commands give the phase logic programmer access to the data of the
material entities the phase logic interacts with.
The attribute ID for a standard attribute is the index. The attribute ID for a
custom attribute is the sum of the controller ID and the index.
See also
Download data from container Configure the PXRQ instruction to download material data from the container
the phase currently runs against:
currently in use
External Request Data Value Array Value
Element
Download Material DINT[0] 1
Manager Data
DINT[1] Data to download (attribute ID).
Container in Use
DINT[2] The phase parameter tag number the value downloads into.
See also
Upload container data into This request fails (without notice) if the data is read-only
container currently in use Configure the PXRQ instruction to upload container data about the container
the phase is currently running against.
See also
Download data from material in Configure the PXRQ instruction to download material data from the container
the phase currently runs against:
container currently in use
External Request Data Value Array Element Value
Download Material DINT[0] 2
Manager Data
DINT[1] Data to download (attribute ID).
Container in Use
DINT[2] The phase parameter tag number the value downloads into.
See also
Upload material data into This request fails (without notice) if the data is read-only.
material in container currently Configure the PXRQ instruction in Logix Designer to upload material data about
in use the current material inside the container the phase currently runs against.
See also
Download data from lot in This request will not download a list of data.
container currently in use
Identifying the lot
The LOT formula parameter does not need to be configured on the phase of the
running phase. If the LOT formula parameter is used, it must have the lot name
stored in it (either before or after binding occurred). This ensures that the correct
lot is referenced. If the lot name is invalid or the material does not exist, the batch
is held according to the configured hold propagation setting.
Finding the exact lot from which to get the information is simple for composite
and plug-flow containers because only one sublot is accessible at a time. Pallets
allow random access to sublots, so that when more than one lot of a material is
stored on a pallet, the FactoryTalk Batch Server does not know which lot to
retrieve data from unless there is only one lot on the pallet or the LOT formula
parameter is specified.
Configure the PXRQ instruction to download lot data from the current material
and current lot within the container the phase is currently running against.
See also
Upload lot data into lot in This request fails if the data is read-only.
container currently in use
Identifying the lot
The LOT formula parameter does not need to be configured on the phase of the
running phase. If the LOT formula parameter is used, it must have the lot name
stored in it (either before or after binding occurred). This ensures that the correct
lot is referenced. If the lot name is invalid or the material does not exist, the batch
is held according to the configured hold propagation setting.
Finding the exact lot from which to get the information is simple for composite
and plug-flow containers because only one sublot is accessible at a time. Pallets
allow random access to sublots, so that when more than one lot of a material is
stored on a pallet, the FactoryTalk Batch Server does not know which lot to
retrieve data from unless there is only one lot on the pallet or the LOT formula
parameter is specified.
Configure the PXRQ instruction in Logix Designer to upload lot data into the
current lot of the current material inside the container the phase currently runs
against.
See also
Download a container selection Configure the PXRQ instruction in Logix Designer to download the container
priority for the current binding selection priority for the material, container, feed type, and unit currently in use
by this phase.
See also
Upload a container selection Configure the PXRQ instruction in Logix Designer to upload a new container
selection priority for the material, container, feed type and unit currently in use by
priority for the current binding
this phase.
See also
Download sufficient material Configure the PXRQ instruction in Logix Designer to download information
data regarding the availability of sufficient material, across all the valid binding
candidates, to complete the addition before starting the material addition for the
step.
The FactoryTalk Batch Server downloads one of these values about sufficient
material for step:
Value Description
0 Insufficient material was available across the valid binding candidates at the time the binding query
was performed.
1 Sufficient material was available across the valid binding candidates at the time the binding query
was performed.
Tip: When the FactoryTalk Batch Server runs without the Material Server, it returns a ‘0’
or ‘1’ depending on when communication is lost.
See also
Material database requests Use the PXRQ instruction in the phase logic to request material data within the
material database. These requests provide a means for accessing or storing a value
to or from the material database. This provides the greatest flexibility for
customization of phase logic and use of the database.
Tip: The data type in the controller must match the data type of the parameter or
report ID specified in the data value array element DINT[1].
See also
Download one attribute of a Configure the PXRQ instruction in Logix Designer to download one attribute of
material a material to a specified tag. The attribute identified by the attribute ID
downloads into the parameter ID specified.
Tip: The data type in the controller must match the data type of the parameter ID
specified in the data value array element DINT[1].
See also
Upload one attribute of a Configure the PXRQ instruction in Logix Designer to upload one attribute of a
material from a specified report ID. The attribute identified by the attribute ID
material
uploads from the specified tag into the database if security and write-protections
allow. Only one value may be uploaded at a time.
Tip: The data type in the controller must match the data type of the report ID specified
in the data value array element DINT[1].
See also
Download lot attributes Configure the PXRQ instruction in Logix Designer to download one attribute of
a lot to a specified tag. The attribute identified by the attribute ID downloads into
the parameter ID specified. Only one value may be downloaded at a time.
Tip: The data type in the controller must match the data type of the parameter ID
specified in the data value array element DINT[1].
See also
Upload lot attributes Configure the PXRQ instruction in Logix Designer to upload one attribute of a
lot from a specified report ID. The attribute identified by the attribute ID uploads
from the specified tag into the database if security and write-protections allow.
Only one value may be uploaded at a time.
Tip: The data type in the controller must match the data type of the report ID specified
in the data value array element DINT[1].
See also
Download container attributes Configure the PXRQ instruction in Logix Designer to download one attribute of
a container to a specified parameter ID. The attribute identified by the attribute
ID downloads into the tag specified. Only one value may be downloaded at a time.
Tip: The data type in the controller must match the data type of the parameter or
report ID specified in the data value array element DINT[1].
See also
Upload container attributes Configure the PXRQ request in Logix Designer to upload one attribute of a
container from a specified report ID. The attribute identified by the attribute ID
uploads from the specified report ID into the database if security and
write-protections allow. Only one value may be uploaded at a time.
Tip: The data type in the controller must match the data type of the report ID specified
in the data value array element DINT[1].
See also
Download container priority Configure the PXRQ instruction in Logix Designer to download the Selection
assignments Priority of a container and load that value to a specified parameter ID. A
container's selection priority is assigned given a material, container, feed type, and
unit.
Feed type is the part of a material specification that defines how a material is to be
used from the perspective of a batch. Material additions add material to a batch.
Material distributions remove material from a batch. In the area model, the
association between a phase and a container also defines the feed types supported
between the two. In the master recipe, the feed type is defined as part of
configuring a material addition or distribution step. A material phase step within a
recipe may only be configured as an addition or a distribution, never both.
The first three parameters are defined by values in the request registers. The unit is
restricted to the unit the phase is currently running in. Only one value may be
downloaded at a time.
Tip: The data type in the controller must match the data type of the parameter ID
specified in the data value array element DINT[1].
See also
Upload container priority Configure the PXRQ instruction in Logix Designer to upload a Selection Priority
assignments for a container from a specified report ID. A container’s selection priority is
assigned given a material, container, feed type and unit. The first three parameters
are defined by values in the request registers. The unit is restricted to the unit the
phase is currently running in. Only one value may be uploaded at a time.
Tip: The data type in the controller must match the data type of the parameter or
report ID specified in the data value array element DINT[1].
See also
How phase tag requests This table shows how the phase tag requests (PHASE_RQ, PHASEQ01,
PHASEQ02, PHASEQ03) correspond to the requests that can be made with the
map to PXRQ requests PXRQ instruction. Phase tag requests are used in the phase logic for OPC and
FactoryTalk Live Data (FTD) phases to request data and services from the
FactoryTalk Batch Server, Material Server, or material database. The PXRQ
instruction is provided in Logix Designer for requesting data and services from the
FactoryTalk Batch Server, Material Server, or material database for PhaseManager
equipment phases.
Tip: The data type in the controller must match the data type of the parameter or
report ID specified in the data value array element DINT[1].
See also
You can view the Rockwell Automation End-User License Agreement ("EULA")
by opening the License.rtf file located in your product's install folder on your hard
drive.
Trademark Notices
Warranty
This product is warranted in accordance with the product license. The product’s
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
product’s 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 any time without prior notice. It is your responsibility to obtain the
most current information available from Rockwell when installing or using this
product.
Environmental compliance
C E
cancel Edit Equipment Module dialog box, General tab 32
messages to other phases 86 electronic batch record entries 73
canceling enumeration data type 41
a message 87 Equipment Editor, role in PhaseManager system 11
all messages 87 equipment ID 41
CIP 10, 12 equipment module 9, 13, 44
CIP data server, assigning to equipment module 32 synchronize in area model 54
CIP data server, editing 31 synchronizing
CIP data server, naming 23 cannot synchronize 51
CIP, benefits 15 updating in area model 61
code, open from equipment module 19 equipment module synchronization details 64
communication path, selecting 28 equipment module, assigning data server to 32
communication protocol, CIP 12 equipment module, open phase logic 19
communication watchdog protocol, settings for Logix5000 CIP data servers equipment modules, how created in project 41
30 equipment modules, selecting to create in project 38, 56
communications protocol 10 equipment phase changes 61
completion of messages 84
container heel 101
Rockwell Automation Publication BATCHX-UM011D-EN-P - February 2017 127
Index
handshake protocol 16
heel N
container 101 name, equipment module 41
network path, selecting 28
I
ID, equipment 41 O
input tags 50 OPC, compared to CIP 15
inputs 41 opening project from 44
instructions, for equipment phases 10 Optimize the timing of the server communication connection to the
controller 30
L output tags 50
outputs 41
logic, open from equipment module 19
Logix5000
synchronize data servers 37 P
Logix5000 CIP data server, adding 22 parameters, in project 41
Logix5000 CIP data server, assigning to equipment module 32 path, network communication 28
Logix5000 CIP data server, editing 31 permissive 83
Logix5000 CIP data server, naming 23 phase communication
Logix5000 CIP data server, type 23 data transfer 83
Logix5000 controller, state model 11 permissive 83
Logix5000 controllers 11 synchronization 83
Logix5000 controllers, equipment phase objects in 11 PHASE data type 10
phase logic interface 16
U
update in project 44
updating equipment modules in the area model 61
Usage, in RSLogix 5000 50
users 9
V
version, FactoryTalk Batch 8
version, Logix5000 8
version, RSLogix5000 8
W
what is PhaseManager? 9
creating new 59
selecting 57
synchronizing
cannot synchronize 51
In addition, we offer multiple support programs for installation, configuration, and troubleshooting. For more information, contact your local
distributor or Rockwell Automation representative, or visit http://www.rockwellautomation.com/services/online-phone .
Installation assistance
If you experience a problem within the first 24 hours of installation, review the information that is contained in this manual. You can contact
Customer Support for initial help in getting your product up and running.
United States Contact your distributor. You must provide a Customer Support case number (call the phone number above to obtain one) to
your distributor to complete the return process.
Outside United States Please contact your local Rockwell Automation representative for the return procedure.
Documentation feedback
Your comments will help us serve your documentation needs better. If you have any suggestions on how to improve this document, complete the
feedback form, publication RA-DU002.
Supersedes BATCHX-UM011C-EN-P - November 2014 Copyright © 2017 Rockwell Automation Technologies, Inc. All rights reserved. Printed in the U.S.A.