Professional Documents
Culture Documents
SOE Recorder Users Guide, v3.1
SOE Recorder Users Guide, v3.1
SOE Recorder
User’s Guide
Triconex
An Invensys Company
Information in this document is subject to change without notice. Companies,
names and data used in examples herein are fictitious unless otherwise noted. No
part of this document may be reproduced or transmitted in any form or by any
means, electronic or mechanical, for any purpose, without the express written
permission of Triconex.
Glossary ................................................................................................................ 71
Index ...................................................................................................................... 75
Understanding the sequence of events that leads to unsafe process conditions and
possible shutdowns may be essential to your safety application. To help you
retrieve and analyze these events, Triconex control systems offer integrated SOE
functionality using the TriStation 1131 Developer’s Workbench and SOE
Recorder.
This user’s guide explains how to set up the SOE features in your Triconex control
system. The following topics are discussed:
• Understanding the interaction of the controller, TriStation, and SOE
Recorder
• Enabling a TriStation project for event collection
• Installing SOE Recorder and using it to retrieve, save, and analyze event
data
Related Documents
The following manuals contain information related to SOE Recorder:
• TriStation 1131 Developer’s Guide for Trident Systems
• TriStation 1131 Developer’s Guide for Tricon Systems
• Trident Communication Guide
• Network Communication Module User’s Guide
• Advanced Communication Module User’s Guide
• Safety Manager Module User’s Guide
Note If you require emergency support and are not an SMP participant, please
have a purchase order or credit card available for billing.
Telephone
Toll-free number 866-PHON IPS (866-746-6477), or
Toll number 508-549-2424
Fax
Send your request to the Technical Support Manager.
Toll-free number 800-325-2134, or
Toll number 949-885-3375
E-mail
ips.csc@invensys.com
Training
In addition to this documentation, Triconex offers in-house and on-site training.
For information on available courses, please contact your regional customer center.
This chapter provides basic information about the integrated sequence of events
(SOE) functionality available in Triconex controllers.
Topics include:
“Overview of Functionality” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
“Overview of Tasks” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
“Sample TriStation Application” . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Overview of Functionality
Understanding the sequence of events that leads to unsafe process conditions and
possible shutdowns may be essential to your safety application. For Triconex
controllers (Tridents and Tricons), an event is the state change of a Boolean
variable from True to False or from False to True. A Triconex controller can collect
events and record the date, time, state, and variable name of each in SOE blocks
that reside in the controller’s memory. The following figure shows how Triconex
controllers, TriStation, and SOE Recorder work together to provide sequence of
events functionality.
Tristation 1131
Developer’s Workbench Sequence of
Events Data
File (*.SED)
SOE Blocks Snapshot
dBASE IV File
ASCII Text File
Event
Variables
SOE Recorder Online
SOE SOE
Function Definition
Blocks (.SOE) File
.SOE File
Analysis
.SOE File
Reports
Downloaded TriStation Projects
Enabled for SOE
CM CM
Tricon
N N
Node 02
M M M C C
P P P M M
A B C 1 2
MP MP
To enable event data to be detected by the controller, you must define the event
variables and SOE blocks in your TriStation project. In addition, your project must
include SOE function blocks that start event collection. After you download an
SOE-enabled project to the controller, TriStation creates an SOE definition file that
contains the SOE block definitions.
To retrieve events with SOE Recorder, you must connect the SOE workstation to
a communication port on a Triconex controller. (You can also retrieve events from
a Triconex controller with an SOE program on a non-Triconex external device.)
You must use TriStation to set the IP address of the controller and you must specify
the address in SOE Recorder.
SOE Recorder can simultaneously retrieve event data from as many as 32
networked controllers, assuming that IP addressing has been done correctly. SOE
Recorder queries all the controllers on the network to determine which downloaded
TriStation projects include SOE blocks. If a project includes one or more SOE
blocks, SOE Recorder opens the appropriate SOE definition file and begins
retrieving events from the associated controller.
While your TriStation project is running, SOE Recorder allows you to analyze
events online as it retrieves them from the controllers. You can also save snapshots
of events that cover specific periods of time before or after trips have occurred. In
addition, SOE Recorder allows you to generate reports of event data, and export
event data to dBASE IV and ASCII text files.
Overview of Tasks
To set up SOE functionality in a Triconex control system, you must complete tasks
in TriStation and in SOE Recorder. This section provides an overview of those
tasks.
Tasks in TriStation
The SOE tasks done in TriStation include:
• “Using Time Synchronization” on page 9
• “Setting Controller Addresses” on page 11
• “Configuring SOE Blocks” on page 15
• “Adding SOE Function Blocks to a Project” on page 24
• “Downloading the SOE Project” on page 29
For more information, see Chapter 2, “SOE Tasks in TriStation.”
Configure Modules
and Communication Ports
Set Up Time
Synchronization Define SOE Blocks
Specify IP Address
of Controller
Declare Tagnames
Designate a Trip Variable
Retrieve Events
This chapter explains how to set up and control event collection in a TriStation
project.
Topics include:
“Overview” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
“Using Time Synchronization” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
“Setting Controller Addresses” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
“Configuring SOE Blocks” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
“Adding SOE Function Blocks to a Project” . . . . . . . . . . . . . . . . . . 24
“Downloading the SOE Project” . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Overview
This chapter explains how to prepare a TriStation project for use with SOE
Recorder. The following tasks are included:
• Using time synchronization (Optional)
• Setting the IP addresses of controllers Required)
• Configuring SOE blocks (Required)
• Adding SOE function blocks (Required)
• Downloading (Required)
Triconex controllers have a time synchronization feature which you can set up in
TriStation to ensure synchronous time-stamping of events by multiple controllers.
In a network, you can synchronize the clock of each controller with a designated
controller, with an external device, or with both. This feature must be used if you
are retrieving events for shutdown analysis.
In SOE Recorder, you must specify the IP address of each controller from which
events are going to be retrieved. Before you can do this, the addresses must be set
using TriStation. If default addresses are used, these are set when you download
the TriStation projects (assuming the projects are configured correctly). If you
cannot use default addresses, this chapter briefly describes the available addressing
methods.
To enable event collection, you must configure SOE blocks and assign event
variables to them. You can configure SOE blocks to provide continuous event
information to external devices on a network, or you can configure them for limited
operation when your controller is not on a network. The event variables must be of
type BOOL and their states can be displayed with names and colors that you define.
You can designate one variable in a TriStation project as the trip variable which
notifies the operator that a trip has occurred.
TriStation provides function blocks you can use to start and stop event collection
for specific SOE blocks, check the status of an SOE block, and clear the values of
an SOE block. You must use the start function block (SOESTRT) to start event
collection. The other SOE function blocks are optional.
If you are downloading your TriStation project for the first time, you must use a
Download All command. If your project has already been downloaded, the type of
download command you should use depends on the type of changes made to the
SOE blocks, and whether you want to reserve memory for SOE blocks to be added
in the future. The SOE definition file is included in the download to provide
information to SOE Recorder about the SOE blocks and event variables. For more
information, see “Copying the SOE Definition File” on page 37.
Trident Defaults
In a Trident controller, you must install the CM in order to use SOE Recorder. The
left CM and the right CM have different default IP addresses, as indicated in the
following table.
Tricon Defaults
In a Tricon controller, you can install either the NCM or the ACM for use with SOE
Recorder. These modules can use the following default IP addresses:
Trinode Default
Number IP Address
01 192.168.1.1
02 192.168.1.2
03 192.168.1.3
: :
30 192.168.1.30
31 192.168.1.31
32 192.168.1.32
Method 1
If your network topology permits the use of a Triconex default IP address, specify
the default address that matches the correct Trinode number in your TriStation
project and download to set the address.
Method 2
Ask your Network Administrator to program a RARP server on your local network
with the intended address for your controller. You must provide the MAC address
of the CM which is 40-00-00-00-x-03 where x is the TriNode number of your
controller. Power up the controller or reset the CM. During initialization, the CM
requests the address from the RARP server. Make sure that your TriStation project
is configured with the correct node number and address, then download.
Method 3
Physically connect your TriStation PC to an MP port and connect the network to a
CM port. Make sure that your TriStation project is configured with the correct node
number and address, then download to set the address. If desired, you can then
physically disconnect TriStation from the MP port and reconnect it to an Ethernet
port on the CM or to the network.
Method 4
Specify the intended address when you configure an Ethernet port on the CM. Use
a default address for your Trinode definition and assign a default address to your
TriStation PC. After downloading, you must reconfigure the Trinode definition to
use the intended address, and reconfigure the address of the TriStation PC.
For detailed instructions, see the Trident Communication Guide.
Method 1
If your network topology permits the use of a Triconex default IP address, specify
the default address that matches the correct Trinode number in your TriStation
project and download to set the address.
Method 2
Ask your Network Administrator to program a RARP server on your local network
with the intended address for your controller. You must provide the MAC address
of the NCM or ACM which is 40-00-00-00-00-x where x is the TriNode number of
your controller. Power up the controller or reset the NCM or ACM. During
initialization, the NCM or ACM requests the address from the RARP server. Make
sure that your TriStation project is configured with the correct node number and
address, then download.
Method 3
Power up the controller or reset the NCM or ACM. During initialization, you can
allow the NCM or ACM to apply a default IP address which matches its Triconex
node number and physical switch setting.
For detailed instructions, see the following manuals:
• TriStation 1131 Developer’s Guide for Tricon Systems
• NCM User’s Guide
• ACM User’s Guide
! WARNING
The physical switch setting of an ACM and NCM must match the Tricon node
number specified in the TriStation project. If there are two ACMs or NCMs in one
logical slot, both must have the same switch setting and same node number. If a
Tricon controller has two logical slots each containing two ACMs and two NCMs
respectively, then all of these modules must have the same switch settings and
same node numbers.
Overview
An SOE block is a data structure that resides in the memory of the Main Processors
for the controllers. The block header contains the block type, the buffer size, and a
list of the event variables assigned to the block. The buffer stores the event entries,
each containing a time stamp and one or more data entries.
Sixteen SOE blocks are available. Using TriStation, you can configure blocks 1
through 14 with any combination of these block types:
Historical — for monitoring current events
First Out — for analyzing events that led to a process upset
External — used by external hosts
Blocks 15 and 16 are Modified External blocks that are reserved for use with the
SMM.
When a block is collecting events and one or more event variables assigned to that
block change state, the MPs write an event entry to the buffer. An event entry
includes the values of all the event variables that changed during the current scan
and a time stamp for the scan which applies to all of the changed variables in the
block. For more information, see the TSAA Quick Reference.
You determine when to start and stop collecting events from the SOE blocks by
adding start and stop function blocks to your TriStation project. For more
information, see “Adding SOE Function Blocks to a Project” on page 24.
Block Types
The following table describes typical uses for the available block types and
explains how the MPs manage the buffer-full condition for each type.
Block Operation on
Typical Use
Type Buffer Full
Historical Typically used to monitor current events. The MPs overwrite the
oldest event entries.
First Out Used to analyze events that led up to a The MPs change the
process upset. block’s status from
collecting to stopped and
discard new event entries.
External Typically used by external devices, such as a The MPs discard new
Foxboro or Honeywell DCS. When the MPs event entries.
write an event to the block, they notify the
external device. The external device requests
the data from the MPs and acknowledges the
receipt. When the MPs receive the
acknowledgment, they clear the data from
the block. For more information, see the
user’s manual for your external device and
the following Triconex manuals:
• NCM User’s Guide
• ACM User’s Guide
• TSAA Quick Guide
Modified Applies to Blocks 15 and 16, which are used The MPs discard new
External with the SMM only. When the MPs write an event entries.
event to Block 15 or 16, they notify the
SMM. The SMM requests the data from the
MPs and acknowledges the receipt. When
the MPs receive the acknowledgment, they
clear the data from the block. For more
information, see the SMM User’s Guide.
Block Size
The maximum block size you can define is 20,000 events (320,000 bytes). A
maximum size of 60,000 events (1 megabyte) is allowed across all blocks.
The block size, expressed in multiples of 16 bytes, is the amount of memory that
the MPs reserve for recording event entries. An event entry consists of an eight-
byte time stamp and one or more eight-byte data entries. Each data entry contains
the changed variable’s alias and state. The following figure shows how the MPs
store data in an SOE block:
1 1 time stamp
_ data entry
2 2 time stamp
_ data entry
_ data entry
3 1 time stamp
_ data entry
ACM
If you configure a block for use with the ACM, the Foxboro I/A Series system will
configure the event variables for this block. The only additional configuration you
can do in TriStation is to specify a type of External and an appropriate size. For
more information, see the ACM User’s Guide.
SMM
If you use SMM, blocks 15 and 16 are specified as Modified External blocks which
are reserved for use with the SMM. For more information, see the SMM User’s
Guide.
Note To change the type of an SOE block and the variables assigned, you can use
the Download Change command. To add new SOE blocks or change the buffer size
of existing blocks, you must use the Download All command.
5 Repeat these steps for the each block you want to configure.
2 Select the Trip Tag Name from the list of event variable names and choose a
Trip State of true or false.
3 Set the Time Before Trip and Time After Trip in minutes. The minimum time
for each of these limits is two minutes; the maximum time for each limit is ten
minutes. Setting these limits creates a window of time that SOE Recorder will
use to create a trip snapshot.
Note In a Trident project, the Properties dialog box for an event variable includes
only the SOE Block tab and the Monitor tab. You can make other types of changes
to event variables in the Trident Points window.
5 To save the settings, click the Confirm button. (To return to the default setting,
click the Default button.)
6 Repeat these steps to set display options for other event variables.
Every SOE function block includes the following inputs and output parameters:
Parameter Description
CI (Control Input) Enables operation of the function block.
If CI is False, there is no operation—in other words, the
outputs and internal state of the function block do not
change.
BLOCK (input) Specifies the SOE block number (1 - 16).
CO (Control Output) Indicates completion of the operation with no errors.
If CO is false, the SOE block number is out of range; a bad
parameter error results; and the STAT parameter returns a
value of 0 (zero).
STAT (output) Returns the status of the specified SOE block after
completion of the operation.
Programming Notes
To properly execute the SOESTRT, SOESTOP and SOECLR function blocks, a
program should turn the CI input On for only one scan. If you leave CI on for more
than one scan, SOE Recorder will generate another event for every scan. For more
information, see the ExSOE.pt2 sample project on the TriStation CD.
If you are programming with the Structured Text (ST) language, you must use
conditional statements to execute SOESTRT, SOESTOP and SOECLR. For more
information, see the TriStation 1131 Developer’s Guide.
Note The SOESTRT function block is executed for only one scan, which means
the resulting STAT output is only valid for that scan.
Note The SOESTOP function block is executed for only one scan, which means
the resulting STAT output is only valid for that scan.
Note The SOECLR function block is executed for only one scan, which means
the resulting STAT output is only valid for that scan.
Download Change
If you change the type, title, or event variable list of an SOE block, you can use the
Download Change command.
Before using the Download Change command, you must stop event collection
using the SOESTOP function block. Then you must copy the new SOE definition
file to the SoeConfig directory associated with SOE Recorder.
Download All
If you add new SOE blocks or change the buffer size of an existing SOE block, you
must use the Download All command.
This chapter explains how to use SOE Recorder to retrieve and analyze sequence
of event data.
Topics include:
“Overview” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
“Installing SOE Recorder” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
“Copying the SOE Definition File” . . . . . . . . . . . . . . . . . . . . . . . . . 37
“Specifying IP Addresses” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
“Setting Options for Event Retrieval” . . . . . . . . . . . . . . . . . . . . . . . . 40
“Retrieving Events” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
“Analyzing Event Data” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
“Understanding Communication Errors” . . . . . . . . . . . . . . . . . . . . . 61
Overview
SOE Recorder can simultaneously retrieve event data from as many as 32
networked Tricon or Trident controllers. You can use this event data to identify the
causes of shutdowns, define corrective actions and procedures for preventive
maintenance, and solve other process-control problems.
To use SOE Recorder, you must specify the correct IP address of each Triconex
controller from which you want to retrieve events. Before you can do this, the IP
addresses of the controllers must be set on the network. Ideally, you can get the
addresses that have been set from your Network Administrator. If you cannot, see
“Setting Controller Addresses” on page 11 for more information.
SOE Recorder accumulates events in an event file until a trip occurs or the
maximum allowable number of events occurs. SOE Recorder can also save
snapshots for periods that you specify, such as snapshots that reflect each shift of
a plant’s operation. During event retrieval, you can manually save an intermediate
snapshot of event data at any time.
To analyze the event data, SOE Recorder includes tools for finding events and
copying them to other Windows applications, filtering and sorting saved event
data, specifying the display of point properties for event data, and viewing the
properties of individual events. SOE Recorder also allows you to export event data,
either manually or automatically, to dBASEIV or ASCII text files. A report engine
and standard report are also included.
SOE Recorder tasks must be completed after your TriStation project has been
enabled for SOE and downloaded to the controller. The tasks include:
• Installing SOE Recorder
• Copying the SOE Definition File
• Specifying IP addresses
• Setting options for event retrieval
• Retrieving
• Analyzing event data
Note The Tricon model 3007 MPs do not have sufficient memory to be used with
SOE Recorder.
Communication Module
The type of communication module installed in a Triconex controller determines
whether event retrieval can be done by SOE Recorder or by a DCS application. The
following table describes which type of communication modules can be used with
SOE Recorder or with a DCS utility.
SOE Recorder is now installed on your computer. To start it, select Triconex
Sequence of Events from the Triconex shortcut of your Programs menu.
! WARNING
Do not rename the SOE definition file under any circumstances. Renaming it will
prevent SOE Recorder from retrieving event data.
Specifying IP Addresses
To use SOE Recorder, you must specify the correct IP address of each Triconex
controller from which you want to retrieve events. Before you can do this, the IP
addresses of the controllers must be set on the network. Ideally, you can get the
addresses that have been set from your Network Administrator. If you cannot, see
“Setting Controller Addresses” on page 11 for more information.
If you are using one Triconex controller and one workstation running SOE
Recorder, specifying a default address supplied by TriStation and SOE Recorder is
sufficient. If you want SOE Recorder to retrieve events from multiple controllers
on a network, you must specify the IP addresses that are used by the controllers on
the network.
To understand how Trinode names and numbers are specified, see “Setting
Controller Addresses” on page 11.
4 Change the Node Name if desired, then type the required TCP/IP Address and
click OK.
5 Repeat steps 2 and 3 for each Trinode from which you want to retrieve events.
6 Click OK to exit the Options dialog box.
7 To begin retrieving events, see “Retrieving Events” on page 48.
Options Description
Display options for point Specifies the event properties to display
properties
Periodic snapshot Specifies a snapshot based on a time period
Specifies a snapshot based on a trip event or a
Auto snapshot
maximum number of events
Event File Directory Specifies where to store the event files
Auto export to a journal file Automatically exports events to a file
TCP/IP addresses on the network Specifies TCP/IP addresses for controllers
The AutoScroll
option can only be
used with live event
retrieval, not with
saved event files.
3 To include a column in the display check it. To remove a column from the
display, clear the checkbox. To organize the columns, select the column to be
moved and click the Up or Down button.
4 If you want your event data to scroll continuously during live event retrieval,
check the AutoScroll option. This option is only available during live event
retrieval.
Periodic Snapshots
The Periodic Snapshop option allows you to determine whether a file of events is
taken during a specific time period.
From the Tools menu, select the Options command then select the Mode tab. A
screen similar to the following is displayed.
Periodic
Snapshots
Shift Snapshot
A shift snapshot retrieves events based on time periods you specify, which can
include up to three weekday shifts and three weekend shifts.
The name that SOE Recorder gives to a shift snapshot is the SED filename,
concatenated with the date and time of the snapshot and the extension “_S.SED.”
File Naming
Periodic snapshot files are SED files that include the date and time of the snapshot
and one of the following file extensions:
• _D.SED for Daily Snapshot
• _W.SED for Weekly Snapshot
• _M.SED for Monthly Snapshot
• _S.SED for Shift Snapshot
A sample filename for a weekly snapshot is Node7_19970613_10:20:15_W.SED.
The parts of the filename have the following meanings:
From the Tools menu, select the Options command then select the Mode tab. The
options are described following the screen.
Auto Snapshots
On Trip Event
If you select the On Trip Event option, SOE Recorder automatically saves a trip
snapshot when a trip occurs. A trip snapshot is a file of events that occurred x
minutes before a trip and y minutes after a trip, according to settings in TriStation.
SOE Recorder adds the extension “_T<node #>.SED” to the filename for the trip
snapshot. For information on setting the time before and after a trip, see
“Designating a Trip Variable” on page 21.
File field occurs. SOE Recorder can store a maximum of 100,000 records. You can
specify a lower number.
When the specified number is reached, SOE Recorder does the following:
• Saves an auto snapshot file with an extension of “_O.SED”
• If necessary, removes old records and adds new records
From the Tools menu, select the Options command then select the Mode tab.
Files that SOE Recorder automatically stores in this directory include periodic
snapshot files, auto snapshot files, and trip event files.
The default Event File Directory is:
<drive letter>:\Program Files\Triconex\TR1SOE\SoeData
3 Select the format for the journal file by clicking the dBASE IV or ASCII
Delimited Text option.
4 Specify the absolute path for your journal file, including a filename. Use the
browse button if needed.
To ensure that any dBASE IV application can open this file, you should limit the
filename to eight characters.
If you don’t specify a filename, SOE Recorder uses the name JOURNAL. If you
don’t specify a path, SOE Recorder uses the SoeData directory under the
directory where you installed the SOE Recorder executable.
5 To save the setting, click OK.
If SOE Recorder is already retrieving events, it begins exporting events to your
journal file every 30 seconds. Otherwise, SOE Recorder begins exporting event
data as soon as event retrieval begins.
Retrieving Events
You can retrieve events from one or more controllers by creating an event file and
using the Begin Event Retrieval and End Event Retrieval commands. When you
create a new event file, SOE Recorder looks for controllers that are connected to
the network. If the controller is connected and the SOE definition file matches the
SOE definition in the SoeConfig directory, you can retrieve events from it.
Before Starting
Before starting event retrieval, make sure the following tasks are done:
• The SOE definition file must be copied from the TriStation project directory
to the SoeConfig directory for SOE Recorder. You must do this for each
controller you want to retrieve data from. For more information, see
“Copying the SOE Definition File” on page 37.
• IP addresses must be specified for the controllers from which you are going
to retrieve events. For more information, see “Specifying IP Addresses” on
page 38.
• The options for event retrieval should be set. For more information, see
“Setting Options for Event Retrieval” on page 40.
▼ To retrieve events:
1 To create an event file, select the New command from the File menu or click the
New icon from the Toolbar. The Create New SED File dialog box is displayed:
2 Enter a name for the sequence of events data file and click Create.
If you do not enter SED as the file extension, it is automatically appended to the
file name.
The SOE Retrieve dialog box is displayed. It lists the names of controllers
(nodes) that are connected to your network, as shown here.
If a controller is not on the list, it might not be connected to the network or the
SOE definition file might be missing from the SoeConfig directory.
3 To specify a controller to retrieve events from, click the checkbox next to the
node name. You can select only those nodes that have a filename in the SOE
Configuration File column.
Note If the status is “No response” in the Status column, it means SOE Recorder
could not connect to the node. If the status is “No SOE Data,” it means SOE
Recorder is connected to the node, but no SOE blocks have been configured.
4 To begin retrieving events, go to the Command menu and select Begin Event
Retrieval or click the Begin Event Retrieval button.
Begin Event
Retrieval SOE Recorder displays events in the event file as they are retrieved from the
controller, as shown in the following screen.
If you have checked the AutoScroll option, the list automatically scrolls as
events occur. For information on setting this option, see “Display Options for
Point Properties” on page 40.
Event retrieval continues until you select the End Event Retrieval command or
at the end of a snapshot period.
5 To stop retrieving events, go to the Command menu and select End Event
Retrieval on the Command menu or click the End Event Retrieval button.
End Event
Retrieval
From the Tools menu, select Save Snapshot, specify a filename and click Save.
The node names displayed in this dialog box are the ones you checked in the
SOE Retrieve dialog box prior to beginning event retrieval. For more
information, see page 48.
2 To remove a node, clear the check mark. Event retrieval from this controller
stops.
3 To add a node (retrieve more events from a controller), check the node name.
Find Events
The Find Event command allows you to search the current event file for a single
event that occurred at or after a time you specify.
Find Event
▼ To find an event:
1 From the Tools menu, select Find Event and enter the date or date and time as
shown on the following screen.
(You do not need to enter the slashes or colons—SOE Recorder enters them for
you automatically.)
2 Click Find.
Copy Events
The Copy Events command allows you to copy selected event data and paste it to
another Windows application. You can only copy one screen of data at a time.
Copy Event
▼ To copy events:
1 Select the event or events to be copied.
2 From the Tools menu, select Copy Event. Paste the data to another Windows
application.
Filters Tab
The Filters tab allows you to limit the events which are displayed for an event file.
Leaving a field blank means that all values for that property are displayed.
▼ To filter events:
1 From the Tools menu, select Filter and Sort Events then select the Filters tab.
Wildcard Characters
Wildcard characters can help you filter events according to their Group 1, Group
2, Tag Name and Variable State properties:
• Use an asterisk (*) for any text string
• Use a question mark (?) for any single character
Sort Tab
The Sort tab allows you to determine the sort order for events as either of the
following:
• In Ascending or Descending order according to the ASCII character set
• In a customized order based on point properties by selecting properties from
the Sort By and Then By lists
▼ To sort events:
From the Tools menu, select Filter and Sort Events then select the Sort tab.
After applying Filter and Sort criteria, you can use the Save Snapshot command to
capture event data in its new presentation.
Save Snapshot
The Save Snapshot command allows you to create a snapshot from a saved event
file. This command can be used to save a copy of an event file or to save a
customized version of an event file.
▼ To save a snapshot:
1 Open a saved event file.
2 If desired, customize the event data by using the Filter and Sort command (from
the Tools menu).
3 From the Tools menu, select Save Snapshot. Specify a filename and click Save.
Export Events
You can manually export events from a saved event file to a journal file that has
one of the following formats.
▼ To export events:
1 From the File menu, select the Open command and select an event file to be
opened.
2 From the Tools menu, select the Export Events command.
3 Enter a filename for the journal file, as shown in the following screen:
Print Reports
SOE Recorder includes the Crystal Report Engine for printing, which allows you
to print a standard Sequence of Events List or any custom-generated reports created
with dBASE-compatible report tools.
Standard Report
In the standard report named Sequence of Events List, all point properties set in
TriStation are displayed.
Custom Reports
To design custom reports which are printable from SOE Recorder, you need a DBF
file exported from SOE Recorder and one of the following:
• Crystal Reports Version 5.0 or later from Seagate
• Any other dBASE-compatible report generator
For more information about report generators, see the user’s guide for the report-
generating package of your choice.
Note Triconex strongly recommends using Crystal Reports because the Crystal
Report Engine for printing is integrated with SOE Recorder.
3 Save the custom report format in a file with a name of your choice and the
extension .rpt.
4 Before starting SOE Recorder, place the report file in the SoeReports directory
to make the new report name appear automatically in the Print Reports dialog
box.
5 If SOE Recorder is already running, exit the application before placing the
report file in SoeReports. SOE Recorder will recognize the new report file when
you restart it.
6 In SOE Recorder, select the Print command to access the Print Reports dialog
box.
7 Confirm that the report filename appears in the Print Reports dialog box.
8 If desired, select the report name and click the Print or Preview button.
Lack of Response
Lack of response to SOE Recorder’s request for data is often recoverable. SOE
Recorder periodically checks each active connection to a node for time-outs. If
more than five seconds elapse after SOE Recorder sends a request to a controller
on the network, the request is considered lost and SOE Recorder re-sends the same
request. In this case, SOE Recorder is operating normally and does not notify you
of the circumstances.
Unrecoverable Errors
In the case of an unrecoverable error such as a disconnected cable, SOE Recorder
re-sends its request to the affected controller three times. If there is no response,
SOE Recorder stops sending requests to this controller and notifies you in the
message bar.
To help you retrieve and analyze event data, SOE provides a variety of tools.
Topics include:
“Menus and Submenus” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
“Table of SOE Commands and Tools” . . . . . . . . . . . . . . . . . . . . . . . 65
“Message Bar” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
“Status Bar” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Event Analysis
Find Events... Filter Tab
Copy Event Date & Time
Node & Block
Filter & Sort Events...
Group
Save Snapshot...
Tag
Export Events... Status
Options... Sort Tab
Order (Ascending or Descending)
Sort By <descriptor>
Then By <descriptor>
Then By <descriptor>
SOE Recorder also provides a message bar with a pop-up menu. In addition, the
Status Bar provides useful information about SOE operation. For more
information, see “Message Bar” on page 68 and “Status Bar” on page 69.
Shortcut Keys
In the SOE main menu, underlined characters are shortcut keys to be used in the
typical manner of Windows applications:
• For a menu item, use ALT + <UNDERLINED CHARACTER> to open the menu.
• For a command within a menu, type the <UNDERLINED CHARACTER> of the
desired command.
Note For each toolbar button, a ToolTip description is displayed if you rest the
cursor on the button.
File Menu
Command Description
New... Allows you to create a new sequence of events data (.sed)
file for retrieving events from the controller. Also allows you
to over-write existing event files.
Open... Opens a previously saved event file for analysis.
Save As... Saves the current event file under another filename that you
specify.
File Menu
Command Description (continued)
Print... Prints the current event file.
Print Setup Allows you to select a printer and modify its settings.
Exit Closes the current event file and exits SOE Recorder.
Command Menu
Command Description
Begin Event For the current file, starts the retrieval of event data from the
Retrieval selected controllers.
End Event For the current file, stops the retrieval of event data from the
Retrieval selected controllers.
Add/Remove During event retrieval, allows you to add or remove Triconex
Nodes nodes for event polling.
Window Menu
Command Description
Cascade Cascades all open windows and displays the title bar for
each. To bring a window to the top, select it from the list
on the menu or click on the window’s title bar.
Tile Horizontally Displays any open windows horizontally on the screen.
Useful for showing several windows simultaneously.
Tile Vertically Displays any open windows vertically on the screen.
Useful for showing several windows simultaneously.
Close All Closes all open windows. Prompts you to save any
elements that have been changed since they were opened.
Show/Hide Displays or closes the message bar, which provides useful
Message Bar information during event retrieval.
Help Menu
Command Description
Help Topics Opens the Help dialog box with tabs for Contents, Index
and Find.
About SOE Displays the current version number of SOE Recorder and
registered owner information.
Message Bar
During event retrieval, SOE Recorder displays useful information in a message bar
(labelled Messages) at the bottom of the window. Usually, the message bar informs
you of circumstances affecting event retrieval that you could not learn through any
other means. Examples of message content are:
• Oct-17-1997 13:00:07 : TRINODE13 (Node# 13) clock out of sync
(10/17/97 12:52:41).
• Oct-17-1997 13:12:17 : Create Max-Events file
'test1_19971017_131211_O.SED'.
• Oct-17-1997 14:56:12 : TRINODE13 (Node# 13) connection is lost. Node
will be closed.
Note If the connections to all controllers on the network have been lost, SOE
flashes a message about this in the middle of the screen, as well as noting the
information in the message bar.
Shortcut Menu
To display the shortcut menu for the message bar, place the cursor in the message
bar and press the right mouse button. The following commands are available:
Command Description
Find... Finds any text in the message bar
Save As... Saves all text in the message bar to a text file
Print... Prints all text in the message bar
Clear... Clears all text in the message bar
Hide Message Bar1 Closes the message bar
1. This command is also available on the Windows menu.
Status Bar
The Status Bar, always displayed at the bottom of the SOE Recorder screen,
provides various types of information depending on whether you are retrieving
events or analyzing event data.
.sed file A sequence of events data file. For more information, see event file.
ARP Address Resolution Protocol. A TCP/IP protocol used to obtain the physical
address of a node on an Ethernet network. A client station broadcasts an ARP
request onto the network with the IP address of the target node it wants to
communicate with. The node with that address responds by sending back its
physical address so that packets can be transmitted to it.
Auto Export An SOE Recorder option that automatically exports events to a journal file every
30 seconds.
Auto Scroll An SOE Recorder option that allows continuous scrolling of event data during live
mode event retrieval.
autosnapshot A snapshot of events that SOE Recorder saves automatically either when a trip
event occurs or when the maximum of events per file is reached.
buffer That part of an SOE block in which a Triconex controller stores event entries.
Daily Snapshot A type of periodic snapshot that starts at 12:00 midnight and ends at 12:00
midnight the next day.
event A state change of a BOOL variable that has been assigned to an SOE block.
event retrieval Events are retrieved by SOE Recorder by reading the event data detected by one or
more controllers and storing it on a workstation.
event detection A Triconex controller’s action of storing event data in a buffer for later retrieval by
SOE Recorder.
event variable A BOOL variable defined in a TriStation project whose state changes are detected
by a controller’s Main Processors and retrieved by SOE Recorder.
event file A file which stores events that SOE Recorder retrieves from one or more
controllers. Event file is an abbreviation for sequence of events data (.sed) file.
exporting events An SOE Recorder feature that exports events to a journal file either manually for a
previously saved event file, or automatically while event retrieval is taking place.
External block A type of SOE block that is typically used by an external host, such as a DCS.
First Out block A type of SOE block used to analyze events that led to a process upset. The Main
Processors change the block’s status from collecting to stopped and discard new
event entries.
Historical block A type of SOE block that is typically used for monitoring current events. The Main
Processors overwrite the oldest event entries in the block.
IP address The unique 32-bit address of a computer attached to an Ethernet network. Every
client and server in an Ethernet network requires an IP address which is either
permanently assigned or dynamically assigned at startup.
journal file A file having the dBASE IV (.dbf) or ASCII text (.txt) format which contains
events exported by SOE Recorder.
MAC address The unique physical address of a network device that is burned into the Network
Interface Card (NIC) of the device when it is manufactured.
manual export A feature that allows manual export of events from a previously saved event file to
a journal file.
manually saved An intermediate snapshot of event data saved by the user during event retrieval.
snapshot
Modified Blocks 15 and 16 which are used with the SMM only.
External blocks
Monthly A type of periodic snapshot that starts at 12:00 midnight the first day of the month,
Snapshot and ends at 12:00 midnight the first day of the next month.
node Any machine on a network. In this user’s guide, node usually refers to a Triconex
controller.
periodic A type of snapshot that SOE saves automatically at the end of a daily, weekly or
snapshot monthly time period.
point A variable in a TriStation project that represents a physical instrument in the user’s
industrial process.
point property A property assigned to a point using the Configuration editor in a TriStation
project. Examples are the tagname, alias and description properties.
Sequence of A standard report that SOE Recorder can print for any event file.
Events List
shift snapshot A snapshot of events that occur during a time shift of a plant’s operation, based on
user-specified time periods. Three weekday shifts and three weekend shifts are
available.
snapshot A file of event data saved by SOE Recorder according to options set by the user.
There are several types of snapshots: auto snapshots, periodic snapshots, shift
snapshots, manually saved snapshots, and trip event snapshots.
SOE definition A file with the extension .SOE, created by TriStation when an SOE-enabled project
file is downloaded to a controller. The SOE definition file contains SOE block
definitions and point properties for the block’s event variables. Before events can
be retrieved using SOE Recorder, the SOE definition file must be copied to the
SOE workstation.
SOE function Function blocks used in TriStation projects to control and verify event collection
blocks for SOE blocks. The function blocks include: start (SOESTRT), stop (SOESTOP),
clear (SOECLR), and status (SOESTAT).
SOECLR An SOE function block that clears the buffer of the designated SOE block, removes
function all entries from the block, and writes an SOECLR time stamp into the buffer.
SOESTRT An SOE function block that starts event collection for the designated SOE block.
function
SOESTAT An SOE function block that returns the status of the designated block, the number
function of eight-byte entries that are used, and the number of eight-byte entries that are
free.
SOESTOP An SOE function block that stops event collection for the designated block, writes
function an SOESTOP time stamp into the buffer, and changes the state of the block from
collecting to stopped.
trip snapshot A snapshot saved automatically by SOE Recorder when the trip variable in a
TriStation project changes state. A trip snapshot contains events that occurred x
minutes before the trip and y minutes after the trip.
trip variable An aliased tagname of type BOOL whose state transition causes SOE Recorder to
automatically create a trip snapshot.
Weekly A type of periodic snapshot that starts at 12:00 midnight on Sunday and ends at
Snapshot 12:00 midnight the following Sunday.
N S
NCM Safety Manager Module. See SMM.
node number switch 13–14 sample TriStation project 6
using with SOE Recorder 34–35 Save Snapshot command
Network Communication Module. See creating snapshot from saved event file
NCM. 56
node number, physically setting manually saving a snapshot 51
address plug on MP Baseplate (Trident) tool description 66, 67
12 sequence of events functionality
switches on NCM or ACM (Tricon) diagram 3
13–14 overview 2
nodes (controllers) Sequence of Events List report 59
adding and removing 52 Shift Definition options 43
lost connection 68 Shift Snapshot
extension 43
O specifying time periods 43
On Trip Event option 44 standard time period 42
Options command shortcut keys 65
for event analysis 67 shortcut menu for message bar 69
for event retrieval 66 Show/Hide Message Bar command 67
size of SOE blocks 17
P SMM
periodic snapshot using with Blocks 15 and 16 16–17
mode displayed 69 using with DCS utility 34–35
table of options 42 SOE blocks
point properties assigning variables 20
changing column display 58 block header 15
filtered and sorted in display 67 BLOCK input 24
in SOE definition file 37 changing buffer size 29
setting display options in TriStation 22 defining block properties 19
downloading 29
trip snapshot 21
Trip State option 21
TriStation project
examples of SOE features 6
list of SOE-related tasks 4
major version number 37
minor version number 37
U
uninstalling SOE Recorder 36
unrecoverable errors 61
V
version number
of SOE Recorder 68
of TriStation project 37
W
weekly snapshot, standard time period 42
wildcard characters 54
workstation. See SOE workstation.