Adding an Event
D ETAILS T AB Event Details
Name This is a name utilized by the administrator to refer to
this Event. This name should reflect the rule being implemented by this event. i.e. SHIFT1_PROD to provide production values for shift one to date.
Item Type This Item Type will be monitored to determine the
event’s state: MQ item, Virtual Item, Timed Item
Trigger Item
This is the Item that the Event will monitor. This field is filtered to display the available items based on the Item Type selected.
For an Event utilizing an Item type of
UNSIGNED/SIGNED WORD, BIT, BYTE or LONG, an additional field of Bit appears. Select the specific Bit from the UNSIGNED/SIGNED WORD that you wish to
Marquee Manager GWMQ SERIES V9
Page 40 of 81 evaluate, or ALL to evaluate the data as an integer.
Test Select the Test type that will be performed on this
event. The interface updates the available fields based on Test type. (See table below for a list of the available bit options and what fields are available to the user when various tests are selected)
Bit Test Fields Enabled
ALL = Value
ALL < Value
ALL > Value
ALL <> Value
ALL change Precision
ALL range Minimum, Maximum
ALL offline
0-x = Value
0-x <> Value
0-x change Precision (defaults to 1)
Bit values range from 0-x where x is 0 for an item type of Bit, 7 for an item type of Byte, 15 for an item type of Unsigned/Signed Word and 31 for an item type of Unsigned/Signed Long.
If an MQ SERIES collected item is offline then the event test against that item will be false and an action won’t be taken, unless the test is offline.
2. When a connection is lost between your MQ SERIES Client and the MQ Server:
◦
If you have selected “Honor Quality” when configuring your Item, the tag is reported as bad quality.◦ If you have left “Honor Quality” unselected, the tag is reported as good. The last value collected before the item went offline, will be shown.
When the item is configured incorrectly (ie. misspelled):
◦ If “Honor Quality” is selected, the tag is reported as bad quality.
◦ If “Honor Quality” is unselected, the tag is still reported as bad quality, as it was never able to make the initial connection.
3. Click on the Actions tab to configure the actions that will occur when this event is triggered. The following screen is displayed:
Configuration Page 41 of 81 ACTION TAB Status Marquee, Tune, Virtual, Controller
Choose the action that will be taken when the event is
triggered. i.e. display a message on a marquee that has been configured in Marquee Manager, play a tune, manipulate text in a virtual item or send a message to a Controller template. (See next section for further screens when each item is selected) Default is to only send a message to a marquee display. All others are set to No Operation.
Configuration
Priority Priority determines the order that messages sent to the sign
will be displayed. High priority messages are a priority of 1 and low priority message will be a priority of 9. Default Priority is set to 9.
Marquee, Distribution List
An Event action may be sent to a Marquee or a distribution list that has been configured in Marquee Manager Administrator
Text The text that will be displayed on the Marquee/Dist list.
Foreground This field has two methods of choosing your color. You can
either chose a color from the drop-down list of predetermined colors, or you can click on the color swatch to the right of the drop-down list and create a custom color.
Background This field has two choices. You can either choose a color from
the drop-down list of predetermined colors, or you can click on the color swatch to the right of the drop-down list and create a custom color.
Scrolling Scrolling options are Default, No Scrolling, Slow Speed,
Medium Speed, or Fast Speed.
Font The Font options are Default and Small.
Mode The drop-down contains the choices of Static, Flashing, Fast
Flashing, Strobe, Reverse, Reverse Flash and Reverse Fast Flash. This establishes how your information will display on the marquee.
Marquee Manager GWMQ SERIES V9
Page 42 of 81 The message can be right-aligned, left-aligned, or centered on the marquee.
4. Click the Save icon in the toolbar to save the new Event.
Sample Event Details
Marquee Manager GWMQ SERIES V9
Page 43 of 81
Marquee Display
The following are steps required if the selected Action is to Change Display:
Marquee – Change Display
1. Select the Priority for the message. The Priority is the Marquee Manager Server message priority that determines the order that messages sent to the sign will be displayed. High priority messages are a priority of 1 and low priority message will be a priority of 9. Default Priority is set to 9.
2. Select the Marquee where the message will be displayed. The list of available marquees, are those marquees that have been configured in Marquee Manager Administrator. You may also send the message to a Group that has been configured in Marquee Manager Administrator by selecting the Groups option to display a list of available groups.
3. The Text: field may contain regular text as well as MQ Items, Timed Items and Virtual Items. To obtain a list of the configured Items, enter { which opens up a drop down list of available Item Types.
4. This first pop-up menu allows you to select which Item type you wish to retrieve: MQ_ITEM, TIMED_ITEM, VIRTUAL_ITEM, FUNCTION rule, TYPECONV, MATH, DTIME, STRING or EVENT variables. Selecting the Item Type will open another pop-up menu to select the trigger item. The final menu allows you to select the cumulative, current or previous values of the selected item.
5. The following is a list of data elements and options available for each Item Type:
Item Type Data Elements Options
MQ_ITEM Configured MQ Items Cumulative, Current,
Previous Snapshots FUNCTION Configured Function Rules N/A TIMED_ITEM Configured Timed Items Current VIRTUAL_ITEM Configured Virtual Items Current
TYPECONV STRFLT Returns the specified
string data as a float
MATH ROUND Rounds the specified item
to the specified number of digits
DTIME FMTSEC Returns a string
representing the seconds contained in the item as a string in the specified format
STRING STRTKN Pulls a string portion from
a larger string that is using a delimiter such as a space, or other symbol such as ‘/’, ‘#’ etc. (See example below)
EVENT START DATE – 2010/01/30
(yyy/mm/dd)
TIME – hh:mm (does not insert a.m. or p.m.) TIME24 – hh:mm in 24
Marquee Manager GWMQ SERIES V9
Page 44 of 81 hour format
TIMESEC – hh:mm:ss (does not insert a.m. or p.m.)
TIME24SEChh:mm:ss in 24 hr
Ex. {EVENT.START.DATE} displays as 2010/01/30
EVENT ACTIVE HR - hh MIN - mm SEC - ss HRMIN- hh:mm MINSEC – mm:ss HRMINSEC – hh:mm:ss Ex. {EVENT.ACTIVE.HRMINSEC} displays as 4:23:45
If an Item has been misconfigured or does not exist, the message will display *NOT_FOUND* for that item. If the quality of an item is “Not Good”, any item triggered by the event should be turned off and any virtual items should be invalidated if it uses the item.
6. Select the display attributes that the message will be displayed with including
Foreground Color, Background Color, Font, Justification, Scroll, and Mode. If only one attribute is available (i.e. only Color Red available on the selected marquee) the field will default to this. All other fields will display {Default}.
7. A maximum length parameter in the format of {CLASS.XXX[:max-length]} allows you to specify the number of characters that will be displayed for that Point value. The valid range for this maximum length parameter is 0 to 1024 and is optional. 8. Click the Save icon in the toolbar to save changes.
Marquee Manager Gateway for MQ Series allows you to configure additional insertion items to the default message. See Appendix A – Insertion Tags for a list of currently available tags. The insertion items must be included in brackets and must be all upper case.
Sample STRING Function Usage
The STRING function uses the following syntax:
{STRING.STRTKN[<VALUE>,<INDEX>,<TOKEN>]} Where:
<VALUE> = an Item of type String
<INDEX> = string portion that will be pulled from the Item String <TOKEN> = the delimiter which can be a space, multiple spaces or any
character(s) such as /,or # and must be in double quotes. If the delimiter does not match or the index is outside the string range, than a NULL string will be returned.
Marquee Manager GWMQ SERIES V9
Page 45 of 81 Example:
{STRING.STRTKN[“This is a number 12.34 with a string”,5,” “]} Would return:
“12.34” as a string value
{STRING.STRTKN[“This is a number 12.34 with a string”,12,” “]} Would return:
(NULL string) as a string value as 12 is outside the range of items in the specified string.
Configuration
Page 46 of 81
Change a Tune
The following are steps required if the selected Action is to Change a Tune:
Tune – Change Tune
1. If you choose to change a tune, select the Change Tune option then click on the speaker icon . The following screen is displayed:
2. Select the Priority that the tune will be played with. The Priority is the Marquee Manager Server message priority that determines the order that the tune will be played. High priority tunes are a threshold of one and low priority tunes will be a threshold of nine. Default Priority is set to nine.
3. Select the Speaker that the tune will play on. The list contains all speakers that have been configured in Marquee Manager Administrator. You may also play the tune on a group of speakers that have been configured in Marquee Manager Administrator by selecting the Groups option to display a list of available groups.
4. Select the tune to be played from the Tune #: field. You may choose to play the tune continuously or to play for any duration of time by selecting the Play for option and entering in the number of seconds that the tune will be played for.
You may also select “Function” and use a Function Rule set up under Tools. This is covered later on in this chapter under “Configuring Function Rules”.
Marquee Manager GWMQ SERIES V9
Page 47 of 81
Populate Text
The following are steps required if the selected Action is to Populate Text:
Virtual – Populate Text
1. If you choose to populate text, select the Populate Text option then click on the text icon . The following screen is displayed:
2. Select the Item that you wish to populate. This Item must be a Virtual Item created with a type of Event Text. Use this feature to string the multiple results of your Virtual Item on a marquee.
See section in this chapter entitled “Adding a Virtual Item” for details on creating a Virtual Item of type Event Text.
Configuration
Page 48 of 81
Sample Event Detail to Populate Text to a Virtual Item
Sample Event Action to Populate Text to a Virtual Item
3. The events CHECK_W1_ROD, CHECK_W2_ROD and CHECK_W3_ROD monitor if the welder states are not equal to 0 (require welding rod).
4. In the example above, three events have been created to monitor the state for each of three welders. The Text field on the Actions tab includes the message that will be added to the event text virtual item if the welder state = 1, thus requires a rod.
Configuration
Page 49 of 81 5. A Virtual Item of WELDROD_NEEDED has been created to contain the list of welders
that require a welding rod, else it will display the default message of NO ROD REQUIRED.
6. An Event of SHOW_ROD_NEEDED has been created to monitor any changes to the Virtual Item, thus any changes to each of the three Welder States and display the current state on the marquee selected.
Sample Event Detail Monitoring an Event Text
The Event SHOW_ROD_NEEDED monitors the Virtual Item WELDROD_NEEDED for any changes to the states of the three welders.
Configuration
Page 50 of 81
Marquee Manager GWMQ SERIES V9
Page 51 of 81
Display a Template
The following are steps required if the selected Action is to display a Controller template:
Controller - Template
1. If you choose to populate text, select the Populate Text option then click on the text icon . The following screen is displayed:
2. Select if you wish to display a template or a cycle. The drop down will update based on which option is selected. Available Templates and Cycles are those that have been configured in Marquee Manager Administrator.
Configuration
Page 52 of 81