Home

RollMap User Manual

1. 000 ee eee eee 118 9 5 2 Inserting a User Component 0 0 0 ees 118 2 6 Contr Ol ODleClS iweb eset Se dies eee een ar ewes eee aD ROR 120 9 6 1 Control Objects and Addressing 0 0 e eee eee 122 9 7 Adding ActiveX ODJeCiS 24 a A be dee AAA A 123 9 7 1 Inserting an ActiveX Object 0 0 0 0 eee eens 123 9 0 Snell ACliVeX ODJEC asadas oem ew eu ae ee eee ee 125 9 8 1 Snell State LED ActiveX Object 0 0 0 0 eee 126 9 8 2 Snell General Button 0 0 ees 128 9 8 3 Snell Slate Text soii Geers oud even heen ae 137 9 8 4 Snell State Frame ee eee 139 9 8 5 Snell State Meter 0 0 nets 142 9 8 6 Snell Check Box coi rae eee 145 9 8 7 Snell Roll Clock Object 0 0 0 0 cc eens 153 9 8 6 Snel XY Router Panel culiacan ada ds 155 9 8 9 Snell BPX Router Panel 0 0 cc ees 159 9 8 10 Snell Dial up Router Panel 0 0 0 0 ccc ee 162 Appendix A RollMap Command Line Parameters 166 A 1 Replacing a schematic variable 0 ccc eee 168 Appendix B SNMP Setup for RollMap lt lt 170 B 1 Installing SNMP Services for Windows XP 00000 cence eee 170 B 2 Installing SNMP Services for Windows 7 2008 o o o oooooooo 173 Appendix C Deferred Addressing 0 0 0 0 0 cece ees 176 C t lerarchicsPrincipl situacion dees da ote bones eo we as 176 C 2 Set the
2. Menu System Alarms Window Schematic Window Toolbars Se BAHO Network nee Tree User Tree History x 35 21323 oo te E r 7 Tool Bar Tr A F Miri Dardo Teran cbr AE E perna LE EAE A T A ii oppa aAA pn TEE E BIT a a r Wa EE 0004 1108 E AT PU Pe A fee 0000 40 03 00 03 14 1007117663040 BOPA 004000 MSE hoe imitans Te T Datir ha EN an Haas iia rad 1Se Aa i Bodies OEA O am Figure 3 Main Window e Network Tree The Network Tree displays a physical view of the units on the network e User Tree The User Tree is used to create a customized display of selected units allowing easy access to units of particular relevance e History Tool Bar The History Tool Bar displays tabs providing a means of viewing and saving previous states There are two type of tabs current status and history Current status tabs display events as they occur and history tabs display a record of events that have occurred e System Alarms Window The System Alarms Window is a table made from units in the system and their alarm headers Each entry in the table is a trigger event for an alarm e Schematic Window The Schematic window allows you to compose a graphical representation of the system using the drawing tools provided Certain drawing components can be connected to alarm events enabling them to dynamically display system state information for example display a red border when an error st
3. Top Left Top Right 0 Stretch to fit background Centre 5 Tile Bottom Left Bottom Right 1 Align to Schematic Figure 118 Background Picture Properties 9 2 4 5 Address Properties The Address tab sets the highest address level for this schematic If components or objects have deferred addresses they are finally resolved by this address It takes the standard RollCall unit address format Issue 6 Rev 1 Page 93 2015 SAM RollMap User Manual 9 2 4 6 Issue 6 Rev 1 Schematic Window Document Properties General Default Schematic Address Figure 119 Default Schematic Address The Default Schematic Address can also be set by dragging and dropping a unit from the Network Tree to the Schematic Workspace Properties The Workspace settings enable the size of the schematic window to be defined Select Size to fit objects to have the window dynamically adjust to fit all the objects in the schematic This option ensures that the whole document is always visible within the schematic window This removes all scroll bars from the window The aspect ratio of the original document is always maintained If the schematic window is larger than the original document then the zoom ratio is set to 100 and aligned with the top left corner of the window Alternatively select Fixed page size and enter width and height values to specify an exact window size Document Properties General O Size to fit
4. 0 00 cee eens 21 4 2 2 Special Keyword Headers 0 eee eens 22 4 3 Set the Global Time Format 0 0 0 eee eee 24 4 4 Manage USCIS ses ic A oe Ras 24 AAA ACO QIUSCR cios erica ral e ada td asa dt td tate len S 24 442 Edit a Usar e ri a at ard ee odo ini 26 4 4 3 Delete a User 3 20d iS li a li aida 27 4 5 RollMap Client Logging n nannaa 0c eee eens 27 40 Shap SNO IDSs na enie dsk lara pidas db di 28 Page 3 2015 SAM RollMap User Manual Contents A Enable SNMP oxida 28 4 8 Set up Global Alarm Triggers and Actions 000 eee eee 29 4 8 1 About Alarm Triggers 0 cee eee eee 30 4 8 2 About Alarm Actions 0 2 0 0 00 ees 30 4 83 Add an Alarm TIE ss coi rias ida shee 31 4 8 4 Configure Alarm Triggers oooocoooocooo eee ees 32 4 eo Adan Ala MACI N ir e A ED AOS 34 4 8 6 Alarm Action Operations 0 0 0 0 0 eee ene 34 AS 7 nigger Operations 4 05 to tad wit ce et oe ek Gee ae ee 34 4 8 8 Multi Alarm Triggers 0 eens 34 4 8 9 Configure Alarm Actions 00 cc eee eens 35 4 8 10 Global Alarm Actions Versus Object Auto Command Actions 52 4 9 Configure Email MessageS nannaa cc eee ees 53 4 9 1 Create a Transport Profile 0 0 0 eee 53 4 9 2 Create a Message Profile 0 ce ees 54 4 10 Specify the Location of the Home Schematic o o oooooooo 56 A Wil CUD Searcy Raiissa raid iris aus aces 57 4 12 Multi wind
5. 0456 04 030 Reset Toolbar Figure 9 Add and Remove Toolbar Buttons Issue 6 Rev 1 Page 16 2015 SAM RollMap User Manual General Operation To add buttons back in to a toolbar 1 Clickon atthe right of a toolbar Click on Add or Remove Buttons Select the toolbar to customize A i A From the list of buttons that displays check the buttons required or click on Reset Toolbar to add all buttons When using Reset Toolbar a prompt display asking for confirmation of the reset 3 3 3 Seta Color Theme Color themes are available from the drop down list at right hand side of the main toolbar Select from Dark Theme or Light Theme Dr ROS TEA IEEE risa Po n b 1013200348 es E5D0O A DE Lira Hara q Uni Tip Hattie Ur MarTre Unai Tepe Uri Adrere Tira dag ate Gunton Toreecced A E Hipercor HEY 1160 0843 Tut Dec 17 09 08 38 2003 UBA aran E De Hrein HPS 1100 1603 Tit Dee IAB AAA AE E A Ds Hype La HPSS LIED AG Tut Dee IT ABIT AE T aa 0000007 De Hp DADE LiL Ls Tie Dee 170463 3 STELT H AA aa 0500100017 Hype i ADO 1150 1944 Tue Dee IT ABI I a TH Hyper EL HPOJ Lieb AG Tut Dec ITO IL OS APL FREED PAI Pree tue Hypa aL DADANE LOGS Tue Dee ITA 2003 M L FREE En FAFE TaT Hypa i OH 1160 1044 Tue Dee ITAA 2003 ELT PRE UL Free OHH Hena NOHO IGU Tue Dee Tone a TE TES z bi i bethany sd a a Pon r j cal a A e y y por mar eet E me Gig AAA A rE Bio e Mis ORAD
6. Figure 69 Mask Setup Select either Use Local masks from alarm files or Use Server masks from RollLog e In local mode items that are masked are saved to the Alarm File Changes saved locally are not reflected in other RollMap clients e On the other hand remote masking from the LogServer allows all other RollMap clients to see the same masking information This option only functions when using the RollCall V4 suite or higher The unit masking options described below are accessed by right clicking on a unit in the System Alarms window Mask Unit Unmask Unit This sets and clears the mask of an item If an item is masked then no alarms are generated for it and its state displays as UNKNOWN to schematic and component objects Mask Unit Until Green Mask Unit Until Green masks the unit until its status returns to green or it is unmasked by means of the Unmask Unit option This option behaves as though the unit using local masks from the alarm file even if using server masks Mask Unit Until Time Mask Unit Until Time masks the unit for the specified period of time either preset or custom Once the time has elapsed the unit is automatically unmasked by the LogServer This feature is accessible from all menus where the current unit can be masked Mask Cell Unmask Cell This sets and clears the mask of an individual cell To mask unmask a cell click on a unit in the System Alarms window to select it click on the cell right c
7. Actions Ed State Trigger Title RollMap QC Report Properties i e QC Report Source History or Status tab Only show tabs with log file enabled Filtering 5 All Addresses Specific Addresses 2 Html htm xml om csv csv Filename Type G Fixed Timebased Filename OE Paths Folder Browse Resolved Path Notification Export Settings Open RollMap manual Figure 47 QC Report This action allows an HTML XML or CSV file to be created from the data of any of the status tabs current status or history tabs in the form of a report Filtering and styling features are provided for the report Specify a report title and the source of the data for the report Define which addresses are to be used in the report either All or Specific Addresses selected by checking the appropriate checkboxes in the Filtering window Apply any rules as required See Rules Engine on page 183 Define the output format and filename for the report Click on the Properties button next to the report name to display the Report Properties window From here the styling of the report is set Page 46 2015 SAM RollMap User Manual Configuring RollMap Report Properties Theme a Sub title Description Highlighting FAIL LOST ERR UNIT LOST NOT WARN INIT NONE UNKNOWN FFFFOQ Add Delete Logo Custom Parameter Arguments Delete Custom arguments are user defined properties which
8. Issue 6 Rev 1 RollMap Parameterization The other place variables can be overridden is when a component is included in a schematic The component properties window also shows the variables tab which is automatically populated with all variables defined in the component This dialog only allows existing values to be changed it does not allow variables to be created or deleted this must be done in the component itself Hame vaise COMPONENT VARI Diliai Valier COMPONENT VARJ Lee VARLIADLE_HMAME to incida tha tke mio bahamano dhi Figure 3 Component object variables overriding Using this feature a single component can be created and then used in multiple schematics or multiple times within the same schematic but customized to work with a different set of data For example it can use a different trigger list or stream URL To revert to the original values click the Reload Component button on the Component Tab Reloading after a change to the component retains existing overrides To pass a schematic variable to a component use the schematic variable name as the component override For example type IP into the value box to pass the IP value defined at schematic level to the component Variables work well in combination with dynamic log field inserted parameters and allow entries such as this INPUT_ SOURCE NUM VALUE Here the SOURCE_NUM is resolved first to a number and then the field is resolved using the l
9. Alam Triggers Addressing Position Fonts General Value and Ranges Zone Commands Colours Ranges ore ore ore ore 50 Bo __ freo_ Min Min hd a Pel ar Danger arming safe one Warming Danger Block Size Figure 198 Value and Ranges Properties Issue 6 Rev 1 Page 143 2015 SAM RollMap User Manual Schematic Window 9 8 5 3 Commands Properties The Commands properties allows Alarm Triggers and Alarm Actions to be configured Click the Edit Actions button to open the Actions window The following triggers can be specified for a Snell State Meter e Object State Trigger actions initiated when the state of the assigned unit changes e Button Press actions initiated when the button is pressed e Meter Zone Change actions initiated when a change in value causes a change to a different meter zone for example from a safe zone to a minimum warning zone e Meter Value Change actions initiated when the value of the meter changes For details of the attributable alarm actions see Configure Alarm Actions on page 35 9 8 5 4 Colors Properties The colors for the background foreground danger warning and safe area colors can be set from the Colors properties Object Properties Alarm Triggers Addressing Position Fonts General Value and Ranges Zone Commands Colours Display Colours Max Danger sample Text Font Colour Fill Colour Figure 199 Colors Properties 9 8 5 5 External Properties Thi
10. Figure 169 ActiveX Object Menu The context menu for an ActiveX object has more options The Properties menu brings up the property box for the object dependent on object Issue 6 Rev 1 Page 124 2015 SAM RollMap User Manual Schematic Window 9 8 Snell ActiveX Objects The Snell ActiveX objects are a subset of the ActiveX objects available to RollMap They are included in the Insert ActiveX object menu but are also available from the Alarm Objects toolbar The Snell ActiveX objects are e Snell State LED e Snell General Button e Snell State Frame e Snell State Text e Snell State Meter Snell Check Box e Snell Roll Clock e XY Router Panel e BPX Router Panel e Dial Up Router Panel Each ActiveX object has a selection of triggers that can be attributed See the relevant section for details of the triggers available All ActiveX objects can have actions added based on a trigger The actions available are the same for all object triggers See Actions on page 165 Object Properties Alarm Triggers Addressing General Commands Position Address Methods Properties for State Defer Net C Unit C Port Trigger Figure 170 Alarm Triggers Properties Use the editing buttons to Add Update and Delete alarm triggers The current object on the schematic may be hidden during specific circumstances using the check boxes at the bottom of the screen If an item is checked and the described situation is true t
11. Hirit Urat Hanie Unit Ty Lina Adare Tima Sarg ironia A 0001105 Men Mor VA 080533 013 Ms Local Mebiork Rollbap Local User Neterork 0600 10 01 Mon Mor 18 07 44 14 2013 NEW FILTERED GROUP Le PAN Local Mebrark RellbMap local Ue Hetencrk 6001 0401 Mon Mor 18 07 44 17 2013 TEST LAB FAL Agyregabe Sk Qh C IOMSTE 4000 0505 His How IA 07 44 14 2017 INPUTS OST 2 IQ GSC HOHE am Mica Mor 16 074414 2015 LOST OS HSE IONS 400000 Misa Mer 18 OP MA o DAI ARCOS DARTH ACS Bisa Ho 1A 074 14 2002 IPT oT mi 1 353 A a p Em pes a LF D aff TEn e Figure 90 Network Tree Window The Network Tree displays a physical view of the units on the network To add a unit to the lower portion of the Network Tree drag and drop it from the top portion The order of the two sections can be changed by using the User Tree above Network Tree menu option this requires a restart of RollMap Units that are online can be renamed Right click on a unit and from the menu that displays select Rename Issue 6 Rev 1 Page 75 2015 SAM RollMap User Manual Network Tree Units can be dragged to a schematic automatically adding the unit s information The Network Tree toolbar specifies the behavior of drag and drop options as follows Insert as Front Component miu Insert as Rear Component o Insert as Device Component Insert as Graphics Object Always Browse for Component ooo Assign Address to Object There are additional i
12. Snell Advanced Media User Manual RollMap www s a m com RollMap User Manual Information and Notices Information and Notices Copyright and Disclaimer Copyright protection claimed includes all forms and matters of copyrightable material and information now allowed by statutory or judicial law or hereinafter granted including without limitation material generated from the software programs which are displayed on the screen such as icons screen display looks etc Information in this manual and software are subject to change without notice and does not represent a commitment on the part of SAM The software described in this manual is furnished under a license agreement and can not be reproduced or copied in any manner without prior agreement with SAM or their authorized agents Reproduction or disassembly of embedded computer programs or algorithms prohibited No part of this publication can be transmitted or reproduced in any form or by any means electronic or mechanical including photocopy recording or any information storage and retrieval system without permission being granted in writing by the publishers or their authorized agents SAM operates a policy of continuous improvement and development SAM reserves the right to make changes and improvements to any of the products described in this document without prior notice Contact Details Customer Support For details of our Regional Customer Support Offices pleas
13. operator 4 Click Insert Rule Editor x Name Log Logic r Rule 0000 00 00 LOG_COUNT 1300 00 00 LOG_COUNT A v Compiled RPN 0000 00 00 LOG_COUNT 1300 00 00 LOG_COUNT Clear Rule Rule Builder Join Unit Header Operator Value OR H GH Network 01 ADDRESS CO O String Number amp AND E y Network 1000 ES 4 multiple character wildcard Network 1100 IDNAME tn single character wildcard E 2 Network 1111 gt Note Endose strings in quotes MSG gt Network 1200 PSU_1_STATE gt Y Network 1300 SESSIONS EA U m A niahunro 1222 v Address 1300 00 00 Insert Figure 7 Valid Rule 5 Select the second unit and the appropriate header 6 Manually edit the rule to remove the trailing Addition operator 7 Click OK Issue 6 Rev 1 Page 186 2015 SAM RollMap User Manual Rules Engine The rule is displayed in the Log Field Logic screen Input Log Fields e Ouput Log Field Simple Query N Adnin Log Hechas iF gt 0000 00 01 MAME r Binary Logic Use Binary Logie Dita when expressions TRUE Dada when expression is FALSE o Advanced Query ACI OD LOG COOLANT TADO O Woes COUMTA gt Ailes Logi Lge Fule Cutpui Logic Edit Fule Ajam ACCION Alam Actions E Delete ih Cancel Figure 8 Log Field Logic Screen with Rule The rule may be manually edited within this screen 8 Select the Use Rule Output
14. 0 0 0 0 Error Warning Good Warning Error Failure Red state keyword s Default State Good Green Delete OK Cancel Figure 72 Override Keyword Headers Log Field Logic Log Field Logic outputs a value to a Log Field that depends on the value of two or more input Log Fields Input Fields can be added or logically compared To access the Log Field Logic dialog e Right click on a log field in the System Alarms window and select Log Field Logic from the menu Page 65 2015 SAM RollMap User Manual System Alarms Window Log Data Logic x Input Log Fields r Output Log Field Simple Query Address Log Header Unit Name Address Log Header AA ass TUL Z r Comparison Logic Use Comparison Logic Data when all log data are EQUAL Remove Data when any log data are NOT EQUAL Advanced Query A r Summation Logic O Use Summation Logic lue H lues rAlarm Actions Create State Trigger Alarm Actions Delete OK Cancel Figure 73 Log Field Logic Screen Within the Log Field Logic screen there are shortcut buttons at the bottom of the screen allowing quick access to create a State Trigger and to open the Alarm Actions screen Example Log Field Logic is used to compare the Input PID to the Output
15. 0 All users Top Level menu Write 250 Administrator only Read 100 Administrator and Engineer Engineering Settings Write 100 Administrator and Engineer o Read 0 All users System Monitoring Write 100 Administrator and Engineer Table 3 Example Schematic Read Write Authentication Levels The range of numbers used to allocate both access levels and schematics read write abilities can be as simple or complex as necessary to ensure each user has the right access Schematic authentication levels are set in the Schematic Document Properties See Authentication Levels Properties on page 95 4 4 2 Edit a User 1 From the Configuration menu select User Authentication gt Manage Users The Authentication Required screen displays Authentication Required Username Password Cancel Figure 20 Authentication Required An Administrator Username and Password must be entered to edit a user 2 Enter a Username and password and click OK The Users screen displays 3 Select the user to edit and click the Edit selected button The Edit User screen displays Page 26 Configuring RollMap RollMap User Manual Configuring RollMap 4 Amend the details as required and click OK 4 4 3 Delete a User 1 From the Configuration menu select User Authentication gt Manage Users The Authentication Required screen displays Authentication Requir
16. 2 Add a Button Press trigger with a Play Sound action Issue 6 Rev 1 Page 135 2015 SAM RollMap User Manual Schematic Window Actions E Button Press Sod lt Play Sound SROLLCALL RollCall EXES plalarm wav 7 Property Substitutions Sa Address M Net U Unit 94P Port oi State 0 3 s State Black Green Yelow Red Sp ExecutablePath c CauseString Sot CauseHeader Repeat Every 30 seconds Open RollMap manual Figure 186 Enter Command Line Loading a Document Any document available on the computer can be loaded by a General Button The exact syntax of the command line depends on the document and application required Object Properties Fonts Alam Triggers Addressing General Picture Button Style Command line Command Actions Figure 187 General Button Setup For example to load the RollMap User Manual Assuming it is located in the RollMap installation directory 1 On the General tab click Command Actions button 2 Add a Button Press trigger with a Command Line action 3 Inthe Command Line enter ROLLMAP RollMapManual pdf Issue 6 Rev 1 Page 136 2015 SAM RollMap User Manual Issue 6 Rev 1 9 8 3 Schematic Window Actions Command Line ny Command Line SROLLMAP 5 RollMapManual pdf Property Substitutions Sba Address M Net SU 0nit 94P Port 5i State 0 3 s State Black Green Yellow Red ssp ExecutablePath c CauseString Sot CauseHeader
17. 2015 SAM RollMap User Manual Schematic Window Actions E CheckBox Un checked Press Units to Mask UnMask mask Unit m E Network 00 El y CheckBox Checked Press E C y Network 01 48 UnMask Unit w 4P Network 1000 Network 1100 e 4 Network 1111 mL Network 11F0 a _ 9 Network 1200 9 Network 1300 a QP Network 1333 A Makhan mnan Mask for Period of Time Duration Days Hours Minutes Seconds Open RollMap manual Figure 202 Actions The following triggers can be specified for a Snell Check Box e Object State Trigger actions initiated when the state of the assigned unit changes e Button Press actions initiated when the button is pressed e Auto actions are initiated when either e aschematic containing the object with the auto trigger is loaded or goes into Run mode from Design mode e RollMap starts if in global alarm e CheckBox Checked Press actions are initiated when a checkbox is pressed when in checked state e CheckBox Un checked Press actions are initiated when a checkbox is pressed when in unchecked state For details of the attributable alarm actions see Configure Alarm Actions on page 35 A check box can have an un checked and a checked state action defined by the state of the check box In the example above when the box is in an un checked state and then pressed to check then it will mask the selected unit Similarly when the checkbox
18. All other tab controls should be left as default The SNMP Trap Service is not required by RollMap The SNMP Service can be manually stopped or re started but must be running in order for RollMap to generate SNMP traps Both the SNMP Service and SNMP Trap Service can be manually stopped or re started Issue 6 Rev 1 Page 175 2015 SAM RollMap User Manual Deferred Addressing Appendix C Deferred Addressing C 1 Hierarchic Principle On assigning an alarm trigger for an ActiveX object the entry for the address can be deferred to the next level A hierarchy of address exists for the schematic document down through a component and then to an individual ActiveX object Schematic Document Address ActiveX Object Address Component Address Alarm Trigger Address ActiveX Object Address Alarm Trigger Address Figure 1 Hierarchic Principle All RollCall addresses have 3 parts The network unit and port address At each stage of address entry each part of the address can be left blank and deferred to a higher level The topmost level of the schematic does not have a deferrable address This allows components to be created without the need to assign the actual addresses until its use in a schematic document For example Schematic Document Address 2000 00 00 Component Address Activex Object Address B RAMA OOOO XAA 60 03 Activex Object Address A Alarm Trigger Address XXAAXX 01 XAXAAXAIXK Alarm Trigger Address
19. All windows can be resized whether docked or floating by clicking on the edge of a window and dragging to a new size Docked windows can only be resized and repositioned within the confines of the RollMap application screen If a window is dragged to a new position without docking it stays as a floating window To move a window to a different docked position 1 Click on the title bar of a window and drag Several position markers show the possible docking positions 2 Drag the window over the position markers that display in the centre of the screen and at the edges denoting the available positions A colored rectangle indicates the destination position of the window if it is docked at the current marker Release the window to dock it in the required position Ae Eit er Configurston Window Help 3H 080088 ea Bana PE ES mr E OE IIA ACACIA mp 11 11 EADC geai f J Chahal 1 F a _ EJ ta Phasca Meter j k eet Hara nil Tyge Uni ddr Time np F Nepusge Duration a E i LE E a Ez of und 0 30 Wed Cec 04 12 37 57 DEGAS Ada 0000013 Wed Dec H 1230 15 a Polis Local Wed One 04 12 17 57 MG 040005000 Wited Dene H LATAS Hetuecik L UE Legherver a Meir M011 VE RollTep Ca de Metvecsk HI ig UK Lab Log er 4 Gland Alghemi gt Stand Kahuna igh Netverk 2000 Ariventk O j La E a ERE Tail a 3 ej ay D o aia 4 A i 3 7 E El O mt ay ott Ey TRE Tg o CE al Se a la m ee S A E Itai
20. IQH3UM4 5 Ey 03 Hyperion IQHIPOO Eg 05 HD Synchronizer IQSYN22 Eg 08 Hyperion IJQSDA02 Figure 99 Unit List Other options include Show all contents of frames with this enabled if a card or a frame is matched by the rule then all the other cards within that frame are added Also the option Show cards in their frames adds the frame of a matched card and shows the card within it Issue 6 Rev 1 Page 81 2015 SAM RollMap User Manual History Tabs 8 History Tabs 8 1 8 2 8 2 1 8 2 2 Issue 6 Rev 1 Description The history tabs provide a means of viewing and saving previous states There are two type of tabs current status and history Current status tabs display events as they occur and history tabs display a record of events that have occurred Unit Name Unit Type Unit Address Time Stamp Y Message Duration Ti A E 04 1QSDA02 IQSDA02 2000 2A 04 Wed Nov 20 07 50 11 2013 INPUT_1_STILLISH FAIL Stillish 0 01 40 43 A 04 1QSDAD2 IQSDAD2 2000 2A 04 Wed Nov 20 07 50 11 2013 NAM 0 01 40 43 AY 04 1QSDAD2 IQSDA02 2000 24 04 Wed Nov 20 07 50 11 2013 MASE 0 01 40 43 04 1QSDA02 IQSDA02 2000 2A 04 Wed Nov 20 07 50 11 2013 INPUT _1_HYPERION SUMMARY FAIL 0 01 40 43 04 IQSDA02 IQSDA02 2000 24 04 Wed Nov 20 07 50 11 2013 INPUT_1_FREEZE FAlL Freeze 0 01 40 43 A 04 1QSDAD2 IQSDA02 2000 2A 04 Wed Nov 20 07 50 11 2013 DIDSIS SSE al al ssid ese een isan 0 01 40 43 A 04 1IQSDA02 IQSDAD2 2000 24 04 Wed Nov 20 0
21. NAME Column2 Unit Type IDNAME Column3 Unit Address ADDRESS Column4 Time Stamp UCT Column5 Message MESSAGE Column6 Duration DURATION Issue 6 Rev 1 Page 85 O 2015 SAM RollMap User Manual Issue 6 Rev 1 8 2 7 History Tabs History Column1 Unit Name NAME Column2 Unit Type IDNAME Column3 Unit Address ADDRESS Column4 Time Stamp UCT Column5 Message MESSAGE Column6 Duration DURATION Column7 Time Cleared TIMECLEARED Column8 Timecode TIMECODE Column9 Timecode Cleared TIMECODE History Tab Properties To display the History Tab Properties window at any time right click on a tab and select Tab Configuration gt Properties History Tab Properties Window Name Window Type Non Masked O Masked All selected Address Hangels start 0000 00 00 FFFF FF FF Cancel Figure 104 History Tab Properties Page 86 2015 SAM RollMap User Manual History Tabs 8 3 History Tab Example Issue 6 Rev 1 This section illustrates how History Tabs and Complimentary tabs work together In the following sequence a Hyperion IQSDAO02 card is monitoring its input while the input goes from 100 Color Bars to Black and then back to 100 Color Bars again Thus in terms of the field state the INPUT_1_ BLACK field goes from OK Green to WARN Black Amber to FAIL Black Red then back to OK Green The Complimentary Tab shows the current active event When an event is deemed OK for example the state is Green the
22. Object Properties Position Unit Address RollCall Commands Meter Rollcall Command Channel Min Range Max Range Step Size Divisor Figure 152 RollCall Commands Properties Issue 6 Rev 1 Page 114 2015 SAM RollMap User Manual Schematic Window RollCall Commands settings need to match the settings of the particular item being monitored these can be found by enabling the Show Command Numbers preference in the RollCall Control Panel Meter tab can be used to turn on a Peak Marker to display a peak audio level The fall time determines how quickly the Peak Marker falls down to the current audio level Object Properties Position Unit Address RollCall Commands Meter Figure 153 Meter Properties 9 4 8 Exception Monitoring Widget A This is the exception monitoring tool Use this tool in order to create a widget which displays a dynamically updating list of alarming units and an optional history of alarms This provides a very visible way of informing an operator of an alarm and the current state of the system When in assign address mode you can drag and drop units including virtual units from the network tree onto the widget to build up a list of items to monitor Figure 154 Configuration mode run mode ltems can also be added though the exception monitoring properties window as shown below Object Properties Monitoring List Positio
23. The border width is in arbitrary units 3D shading puts shadow effects on the borders of the frame The Transparent checkbox makes the inside area of the frame transparent and hence allows any drawing objects behind the frame to become visible The borders can be made to flash or flash only on RED state The Caption property may be replaced by external trigger events Page 139 2015 SAM RollMap User Manual Schematic Window Object Properties Alam Triggers Addressing General Commands Pictures Colour Position Style Options Rectangle 4 3D Shading Round Rectangle O Green Transparent Roundness 2 Yellow ES Dl Flash O Red AQUA Flash On Red ans setto zero for automatic O Ellipse Line LF Line R gt L Border Width Figure 192 General Properties 9 8 4 2 Commands Properties The Commands properties page allows Alarm Triggers and Alarm Actions to be configured Object Properties Alam Triggers Addressing General Commands Pictures Colour Position Figure 193 Commands Properties Click the Edit Actions button to open the Actions window The following triggers can be specified for a Snell State Frame e Object State Trigger actions initiated when the state of the assigned unit changes e Auto actions are initiated when either e aschematic containing the object with the auto trigger is loaded or goes into Run mode from Design mode e RollMap starts if in global alarm For details
24. UCT Send SNMP This action sends a parameter value set via SNMP when the alarm trigger occurs Actions El State Trigger pSend SNMP OID Community o O Value Numerical values can be either decimal or hexadecimal use Ox prefix Open RollMap manual Figure 40 Send SNMP In this window enter the details of the SNMP message to be sent Dynamic data insertion can be used on the Agent Address OID and community fields See Dynamic Data Insertion on page 191 Get SNMP This action gets a value via SNMP when the alarm trigger occurs The log unit and header destination for the value can be specified Page 40 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap Actions Get SNMP Number of retries WP seconds Result processing for State Result processing for Display of Value f 4 Ignore state EN Use raw data Handle state Use procesed data OK Format Warning use VALUE for result substitute Fail operators amp l lt gt use VALUE for result substitute operators 81 re lt gt Log Unit 0000 00 01 Write to Log C Log Header Open RollMap manual Figure 41 Get SNMP In this window enter the details of the SNMP data to be requested Dynamic data insertion can be used on the Agent Address OID and community fields See Dynamic Data Insertion on page 191 The results can be processed into states by entering lists of possible values to be m
25. into the caption field displays the actual unit address when the schematic is run e Line Border Style Color Use these options to specify the outer border of the text object Fill background color Use these options to specify the fill and background colors of the text object Issue 6 Rev 1 Page 100 2015 SAM RollMap User Manual Issue 6 Rev 1 Schematic Window 9 3 8 2 Text Fonts Properties Object Properties General Forts Unit Address Position styles Horz Alignment Sample Text Vert Alignment Change font Change font colour Escapement Horizontal left to right O Highlight Change highlight fort Figure 126 Text Fonts Properties Styles These settings allow the horizontal and vertical alignment of the text within the text object to be specified The escapement options specify the direction in which the text is displayed Horizontal text runs left to right Vertical Down text runs from top to bottom Vertical Up text runs from bottom to top Change font Click Change font to specify the font type style and size for the text The font options specified by this setting determine the font that is normally displayed in run mode Highlight Change highlight font lf required a different font can be specified as a highlight font The specified highlight font is displayed in run mode when the mouse pointer passes over the text object a rollover To use a highlight font se
26. the schematic Fle Edt View Configuration Window He f X 198 9009 0098 B5 BODDIA Po PRE m Physical Meteor tE Ek a iP UK Lab Logberver and Proxy conta E inserter ON sr x i 1 Dieta Output OF IQHOUME SOQHUME S E Th M132 HOU E 23 IQHIU RC OHI M IQHOUMG E Nike Test 0k E i IQHIUMS NQHSUME E po neshe ij E OH UE HAUTE Inserter 2 2 OPUS Tim L Test 00H InputsiDis play gt BR 2A OHMS DOHA Names E 78 Hu pHa l Doma dats a 20 QHIU RC ggu l en E OHRT POHI E santas Contre E E ABLA AL E E iF IGHAU RC Agha EE a a 8 Stand Alchemist 2300 inserter A Control a A FIABLE IAH EJ inperter CH Fr A Ep 1 1EAQOMEE QOMT 2 Detsult Gueput lem in gt inserter A da segment Pur Pair 2 Cheer Mive A hi mae giji dr E E E l air J air a a Eg Test Room 55 eas dl e WHE 5 Tira Fran POH i F 5 Channel 2 r ma LA Rack 1 CER ggi ggi E 00 Pack 2 CRG My 00 Rack 7 JOCAR l w y 00 Racks OCHRE By 00 Reck d POCBRG History A gt Channel 1 Unit Mame Let Type Durata A TID AVM EM DANA LA lt A TS E HIDMSEC HONS Tue Dec 10 100119 2013 INPUTELOST ARA Wein k Eoia IODMSEC 0000505 Tue Dee 10 1011 3 2013 EXTREFSLOST ORHAN 05 ODE IODMISEC 4000 05 06 Tue Dec 10 101120 2013 PO dde MAAR IQARCOO HOHIA Tue Dec 10 1011 9 20179 IMPUTSLOST DA MARC KARO HS Tut Dee 10 100113 2013 AT DSH PAO DAC ODA 2000050 Tue Dec 10 1
27. 0 0 0 ees 74 Gi INGTWONK NOG ie sits i ger ai A A ee edhe eh a San 75 6 1 DESCAplON ett daa aa dara 75 6 2 AUTO DISCOVER dd AS add 76 6 3 L0ad COnWOl Sc Nina ad radio gout eee De 77 TUS WCC ida ae eal wea a a bores 78 Te WS SCI A A a a ad bdr on ae Sh 78 Fe AREO GOUS cc cd A ale oe OS De eee i 79 9 HIStory Tabs iii tee ole aac ee bea hie ee eid ee 82 B21 DESCKIDUOM ue curra tana a ea ade ADA 82 8 2 Managing History Tabs o o ooooococon eee 82 8 2 1 Create Complimentary Tab o o o ooococoooconona ees 82 8 2 2 Create New Tab bas tdo a a RAS a a 82 8 2 3 Move Tab Order Left Right o o oooooooooonooonoo 83 8 24 Delete lao 2 oe din ea eee ee eee ed ee eee Se ee eee a 83 8 2 5 History Tab Log File Setup cros 2 0 0 cc ee 83 622 6 COMWMNS wives ct hed ek eRe Ree eee a RSS 84 8 2 7 History Tab Properties 0 0 0 ee eens 86 8 3 History Tab EXample daa ia teense bi A ed ake ee is 87 9 Schematic Window iia ii pies AA AS 90 dul CS CMOUO sentis io a a dar 90 9 2 Working with Schematic Documents 0 0 0 0 0 eee 90 9 2 1 Starting a New Schematic Document 0 0 00 c eee eee 90 9 2 2 Run and Design Modes 0 0 cc eee eens 91 9 2 3 Full Screen Navigation 0 eee ees 91 9 2 4 Setting Document Properties 0 0 ees 92 9 2 5 Basic Editing FUNCHONS www etek orto te e as 96 9 2 6 Viewing Item Properties 0 ccc eee 96 9 2 7 Ordering Items i
28. 0 255 25 Roundness 0 100 35 Border Thickness Border Color M Font Family Select Color Scale Enable Width Height Keep aspect ratio Clear image Draw behind T Clear all images Figure 221 Panel Style Properties From within this properties screen the button color text font and scaling can be adjusted Images may also be imported to some buttons if required Any of the items in the Define Styling section of the Configuration tab may be selected whilst this format styling screen is open The properties change according to what is selected Additional buttons may be added to or removed from the panel for example Undo Destination Protect Panel Lock and Take Also tally displays showing the current source and destination may be included in the panel Source and destination buttons may display left to right or up and down Select the desired layout either vertical or horizontal from the Layout section Routing Properties In this tab set up the source and destination buttons The Source Value and Routing Commands are used to perform the routing It is also possible to define how buttons are named either queried from the unit or using a fixed button name Use a combination of the drop lists and the Next and Previous buttons to navigate to each button and allocate a name command as required Page 157 2015 SAM RollMap User Manual Schematic Window Object Properties Al
29. 34 2080 INPUT el OST i z mi M A 5 EEES Charne nelHi i s j rs ra E i ae iF loa lc BM aos OEA OA i af ne F L eee Tr W H k 18 65 1 1 Figure 91 User Tree Window The User View can be customized to display selected units allowing easy access to units of particular relevancy E Expands all units and other sub components in the User Tree Collapses all components in the User Tree Ta Expands the selected unit only Collapses the selected unit only Each of these show an aggregated state of all the components contained within them This aggregated state is added as a header to a virtual unit see Appendix E The address of the virtual unit can be specified on a per item basis by right clicking on the item selecting the Virtual Unit menu option Issue 6 Rev 1 Page 78 2015 SAM RollMap User Manual User Tree User Network Expand All Selected Contract All Selected Edit Virtual Unit Address Example Location Virtual Unit Address OK 4 5310 Playout Frame 10 QH3UM4 S 0001 01 01 E 01 Hyperion 5 IQHIPOO Ey 02 Hyperion 6 IQHIPOO et 04 Hunerion 7 TOHTPOMN Figure 92 Virtual Unit Cancel If no virtual unit address is specified then the default address is used from the setting UserTreeVirtualUnitAddress in Configuration cfg Headers are created with names made up of the path to the tree item For the example below the virtual headers would be Test Room Test Room Channel 2
30. 34 O 2015 SAM RollMap User Manual Configuring RollMap multi P State Trigger y Logserver Lost Trigger y Macro Figure 31 Multi Alarm Triggers 4 8 9 Configure Alarm Actions When an alarm action either global or object is added its configuration parameters display on the right side of the Actions window e Command Line The Command Line action allows the execution of programs via the command line interpreter Actions E ing State Trigger Command Line fee ny Command Line lt Property Substitutions ba Address M Net SU 0nit 9 6P Port i State 0 3 s State Black Green Yellow Red ssp ExecutablePath c CauseString Sot CauseHeader or CauseTrigger ActiveX objects s6h CauseHeader ActiveX objects Sor UserSstring 0 5 wj Masked State 0 3 HEADER value of a log field header Other H hide command execution Date Time Sy vyy year as 4 digit oMM month as 2 digit s6dd day as 2 digit oddd short day name sdddd lng day name 25414M56 short month name 2oMMMMo long month name Soro time zone wH 24 hour For Yo minute cs second Open RollMap manual Figure 32 Command Line To configure a command line action enter the command to be run in the text box The Command Line action supports several property substitutions which are listed in the dialog Macro The Macro action allows you to select a pre configured macro command to be run As well the dialog provides
31. 9 8 6 4 Check Box Style Properties There are a number of ways the appearance can be altered these can be done via the Check Box Style properties page Issue 6 Rev 1 Page 147 2015 SAM RollMap User Manual Schematic Window Object Properties Fonts Alam Triggers Addressing General Picture Check Box Style Position Top coe Thickness i Bight Press confirmation Bottom Colour E 4 Lock box to frame Border colour fal Size Fit picture Text on left Design preview Normal Fill Colour A owe Fill Colour B 2 Fill Style Vertical Gradient Figure 205 Check Box Style Properties 9 8 6 5 External Properties This object exposes many properties Only the ones listed below should be used as alarm trigger properties Properties read and write variables External Name Type Valid Values State VT_12 16 bit integer 0 Black 1 Green 2 Yellow 3 Red Caption VT_BSTR text string null terminated string c field UserString VT_BTSR text string r substitution field Table 10 External Properties Check Box Example 1 This example shows how to create a check box to turn a LAN port on and off and report the state to a virtual unit FO00 36 00 under the header LAN PORT ADMIN STATE With the check box checked the port is Up and OK 1 Open anew schematic 2 Add a check box and double click on it to open the Properties 3 From the General tab click the Command Actions button 4 Inthe Actions
32. 9 al W 39 Management and Moritoring Tools 1 9 MA O a Message Queuing 0 0 kS E Wi MSN Exciarer 112M8_ Descoption includes Windows Accos ores and Litibies ior your computer Total disk space required 56 8 MA Space salsble on disk 563187 8 HE Details l Cancel Figure 1 Windows Components From the selection box select the Management and Monitoring Tools component To view more details about the component click the Details button Management and Monitoring Tools To add or remove a component click the check box A shaded box means thet only part of the component will be installed To see what s included in a component cick Details subcomponents of Management and Monitoring Tools O e Simple Network Management Protocol A Swell SNMP Provider Description includes agents that monsor the atiet in network devices and repon to the network console workstation Total disk space required 56 6 MB Space available on disk 531878 MB Dr Cancel Figure 2 Management and Monitoring Tools Page 170 2015 SAM RollMap User Manual Issue 6 Rev 1 SNMP Setup for RollMap Ensure both the Simple Network Management Protocol SNMP sub component is selected Click OK to continue and install the components To configure the services use the Service Manager under Control Panel gt Administration Tools gt Services de Services Fle Acton Mew Help moras A Pe Services Local
33. ARAA AROAN Figure2 Example Addresses The value X represents a deferred address The alarm trigger address for ActiveX object A resolves to 2000 50 01 The alarm trigger address for ActiveX object B resolves to 2000 60 03 Note that components may contain a compound of other components and ActiveX objects so the deferred addressing scheme may be extended to many more levels Issue 6 Rev 1 Page 176 2015 SAM RollMap User Manual Deferred Addressing C 2 Set the Schematic Address With no items selected select the Properties option from the menu This brings up the Document properties box Select the Address tab Document Propertes Defaut Schematic Address Figure 3 Address Properties The Default Schematic Address can be over ridden by the use of a Schematic Link using Address Replacement See Schematic Link Tool on page 103 C 3 Set the Address of a Component Tool or ActiveX Object Select the item Only a single item may be edited at a time Select Properties from the menu and select the Address tab Enter values as required Object Properties Component Addressing Position Object Address Hex Defer Unit Report Status Defer Port 0 Show as Icon Figure 4 Component Address Issue 6 Rev 1 Page 177 O 2015 SAM RollMap User Manual Deferred Addressing C 4 Setting the Alarm Trigger Address Select the ActiveX object required Select Alarm Triggers from the menu Enter the address as required Note t
34. Active Link Use State Colours Replace Schematic Address 0000 00 00 Link tool mode Schematic Link O Back Button O Forward Button Figure 131 Schematic Properties The Report status checkbox indicates whether the state of this schematic object should be included as part of the overall status of all objects in the current schematic Disabling this option makes the state of the object display as UNKNOWN to the current schematic For correct and intuitive operation with a set of linked schematics the Report status checkbox should be set as follows assuming that schematic A is being edited and includes a link to schematic B e If schematic B represents a true child or sub set of schematic A then Report status should be checked e If B represents a peer or parent of A then Report status should not be checked The on screen rectangle representing the schematic link displays the border color appropriate to the state of all the objects on the linked schematic whether Report status is checked or not Uncheck the Use State Colours check box if this is not required The Replace Document Address option allows a single schematic containing monitoring and or control elements for a particular product type to be used for multiple units of the same type This option is useful in instances where there are unit detail screens for a group of units that all need to be identical except for the unit address that they relate to Iss
35. Alarm Artan Laialt Stasi Triggir Alan Aans Laima or Lance Figure5 Log Field Logic Screen 1 Open the Log Field Logic screen right click on a system alarm and select Log Field Logic from the menu Issue 6 Rev 1 Page 185 2015 SAM RollMap User Manual Rules Engine 2 Select the Advanced Query radio button and click on the Edit Rule button The Rule Editor displays Rule Editor x Name Log Logic Rule 0000 00 00 LOG_COUNT A v Compiled RPN 0000 00 00 LOG_COUNT Clear Rule r Rule Builder Join Unit Header Operator Value OR F e Network 00 ADDRESS al String Number l amp AND y Network 01 IDNAME it multiple character wildcard Y Network 1000 IP_EVENT E lt single character wildcard Network 1100 IPADDRESS gt Note Endose strings in quotes i IPCONNECT gt 5 E y Network 1111 IPNAME Date Time w GH Network 11F0 LOG COUNT 2 mE LOGIPSESSIONS PRIMARY 3 243 Network 1200 y LOGIPSESSIONS SECONDARY y v a Nethunark 1200 ene ee rcltrcteretered erctasctesctarcpeceteredaneterct ester Sose Address 0000 00 00 ee A OK Cancel Figure 6 Rule Editor When used in Log Logic the Rule Editor screen has an extra Unit field allowing a unit address to be selected 3 Select a unit that contains the first numeric field to add and select the Addition
36. Bielec 1100 10 04 110010015 Figure 14 System Alarms Setup Issue 6 Rev 1 Page 20 O 2015 SAM RollMap User Manual Issue 6 Rev 1 4 2 1 Configuring RollMap The address of each unit must be added to the Units to View list The addresses that display in the current status file are displayed on the left You can select all or a sub set of addresses available The AutoSel button selects only those items currently present on the network The Add button adds all the selected items To delete an item select the item in the Units to View list and select the Delete Item button Only units that are present in the Units to View list are displayed by the System Alarms The display order is set by the list order which can be changed by pressing Sort sorts numerically by address or by using the Up and Down buttons to move individual units Set up Keyword Headers Keyword Headers are the column headings that display at the top of the unit list Keyword headers are identical to those used by the RollCall Log Viewer RollView Changes made to these settings also affect settings in the RollView package Each column is listed by position number The first column is numbered O To delete add or modify the keyword headers column headings e From the Configuration menu select Keyword Headers gt Edit Headers The Headings dialog displays Headings x setup F
37. Cancel Figure2 New Rule Screen 1 Select INFORMATION1 from the header list select the Equal to operator and enter Channel 1 in the String Number field Rule Editor a Name Channel 1 2 Verto crit adren Goana 4 Show all contents of frames Show cards in their frames Rule A v Compiled RPN INFORMATION 1 Channeli INFORMATION2 Channel Clear Rule Rule Builder Join Header Value OR ID amp AND IDNAME INFORMATION2 INPUT INPUT_1_ANCILLARY_TIMECODE_STATE String Number Channel 1 multiple character wildcard single character wildcard Note Enclose strings in quotes Date Time 11 201 i gt EYVANA INPUT_1 BLACK INPUT_1_ BLACKISH INPUT_1_C_BIT_DEPTH v Th OK Cancel Figure 3 New Rule Part 2 Click Insert The expression is added to the rule 3 Select the OR join operator select INFORMATION2 from the header list and change the String Number field to Channel 2 Issue 6 Rev 1 Page 184 2015 SAM RollMap User Manual Rules Engine 4 Click Insert Rule Editor x Name Channel 1 2 Virtual unit address 00x20 xX V Show all contents of frames Show cards in their frames Rule INFORMATION1 Channel 1 FINFORMATION2 Channel 2 A v
38. Check Box Style Position Caption LAN PORT_ADMIN_STATE Command line Command Actions Check when 7 0 States Unknown Error O Unitis Masked O Unit s Not Masked O Locked O Unblocked Figure 209 Check Box Example General Properties e Inthe Alarm Triggers tab select an address from the drop down list and click Add or defer the address using the Defer checkboxes Issue 6 Rev 1 Page 150 2015 SAM RollMap User Manual Schematic Window Object Properties Alarm Triggers Addressing General Picture Check Box Style Position Address Defer 4 Met M Unit 4 Port Methods Propen Trigger List 0000 00 00 P State 7 Hide on Green 7 Hide on Not Set 7 Hide on Cyan 7 Hide on Waming A Hide on Magenta Hide on Error Figure 210 Check Box Example Alarm Triggers After running this schematic if a new header is chosen you will need to create all headers See Set up Keyword Headers on page 21 Check Box Example 2 This example shows how to create a check box to add a Panel Lock Unlock feature to a schematic When the panel is locked the screen will grey out not allowing any input other than clicking on Unlock to give back access to the panel MIO oo A Control amp Monitoring El snell Welcome to Snell Panel Locked Panel Unlocked Figure 211 Check Box Example Panel in Locked and Unlock State 1 Open a new schematic 2 Add a check box and doub
39. Color Scale Buttons Enable are ap wf Width D Maximize Size Height o Keep aspect ratio Clear image Draw behind E Clear all images Figure 227 Panel Style Properties From within this properties screen the button color text font and scaling can be adjusted Images may also be imported to some buttons if required Any of the items in the Define Styling section of the Configuration tab may be selected whilst this format styling screen is open The properties change according to what is selected Page 161 2015 SAM RollMap User Manual 9 8 10 9 8 10 1 Issue 6 Rev 1 Schematic Window Additional buttons may be added to or removed from the panel for example Undo Destination Protect Panel Lock and Take Also tally displays showing the current source and destination may be included in the panel Source and destination buttons may display left to right or up and down Select the desired layout either vertical or horizontal from the Layout section Snell Dial up Router Panel PRE This object allows a Dial up router panel to be added to a schematic window The dial up router panel can be configured and the display of the panel adapted as required Figure 228 Default Dial up Router Panel In addition to the normal alarm triggers addressing and position properties there are three properties tabs relating to the setup of the router panel e Presets quick setup for each of
40. Configuration Routing Position Source Panel Destination Panel Caption sal Caption DESTINATIONS Size Columns Define Styling Click to edit de Dest valid for 1x1 grids 9 Vertical Source First Source Enable Panel Src Dest Display s O Vertical Destination First estination Backgroun E Hari a es nt Chen Enable Panel Lock Horizontal Source First Control Button Group 5 Horizontal Destination First Destination Button Group Enable Dest Protect Take Button ae Undo Button Undo Take Jew a toco Immediate Take Preselect with Take button le Timeout secs 0 O No timeout Figure 220 XY Panel Configuration For both sources and destinations define a title caption and set the number of rows and columns of buttons to display for each By default the Total number of buttons adjusts in line with the number of columns and rows selected However this can be overridden if required The number of columns and rows defines the area allocated for the buttons If the total number of buttons is subsequently reduced the buttons do not spread to fill the allocated space In the Define Styling section click on any of the items in the list to display the format styling properties for that item Issue 6 Rev 1 Page 156 2015 SAM RollMap User Manual Issue 6 Rev 1 9 8 8 3 Schematic Window Widget Properties Style Normal Color E Selected Color A Transparent T Opacity
41. File name y Schematic components cpt 7 Figure 160 Open Component File Issue 6 Rev 1 Page 118 2015 SAM RollMap User Manual Schematic Window Use the Open dialog box to select a component file The component displays as one object and can be move and edited just like any other drawing object A component has Component Addressing and Position tabs in its properties box Object Properties Component Addressing Position Component file name el Bilt Figure 161 Component Properties e Click the Re load Component button to refresh a component Object Properties Component Addressing Position Object Address Hex Defer Unt 7 Z Report Status Defer Port Cl Show as Icon Figure 162 Addressing Properties Objects inside the component may have deferred addresses assigned These deferred addresses can be assigned at this level or left so that it is assigned by the next level schematic document See Deferred Addressing on page 176 The settings on the Position tab define the placement and size of the Component Issue 6 Rev 1 Page 119 2015 SAM RollMap User Manual Schematic Window Object Properties Component Addressing Position I Left 5 e Right 370 7 Figure 163 Position Properties 9 6 Control Objects The Load Control Screen contextual menu item downloads a selected unit s template enabling any control from the template to be embedded in a schematic U
42. LOG_COUNT Up time PSU 1 Name PSU 1 State PSU 2 Name PSU 2 State Temp 1 Name Temp 1 State Temp 1 Celsius Voltage 1 Name Figure 137 Select Headers Select the headers to be displayed by the control and then click OK Issue 6 Rev 1 Page 107 2015 SAM RollMap User Manual Schematic Window 9 4 3 Thumbnail Tool The Thumbnail tool displays Thumbnails from Hyperion by inputting the RollCall address of the Hyperion card whatever the Hyperion card is monitoring at that time is displayed in the Thumbnail window A number of Thumbnails can be added to the schematic window Figure 138 Add Thumbnail To set the general object properties double click on the background of the Thumbnail or if the properties box is already visible just click on the background of the Thumbnail Object Properties General Address Control Position Line Border Style Colour Fill background colour Weight Figure 139 General Properties To connect to the Hyperion card manually either Uncheck the Defer check boxes and enter the card s RollCall address in the three boxes RollMap uses the IP Address and IP Port from the frame s log fields to connect to the Hyperion card or Issue 6 Rev 1 Page 108 2015 SAM Issue 6 Rev 1 RollMap User Manual Schematic Window Check the Use manual IP address checkbox and enter the IP Address and IP Port Object Properties Address Control Position Object Address Hex IP Addr
43. Logic radio button in the Rule Logic section and ensure that the Raw Values radio button is also selected 9 Click OK The result displays in the main alarms window of RollMap Test Header Address If required text string formatting can be added to the result by editing the rule e Open the Log Logic window and add some text as shown in Figure 10 COMBINED RESULT 0000 00 00 L0G_COUNT 1300 00 00 LO0G_COUNT A PE r Rule Logic Use Rule Output Logic a Raw Values O Hexadecimal Values Edit Rule Figure 10 Edit the Rule In this instance brackets are required around the numeric part of expression so that it is evaluated before it is converted to a string value Issue 6 Rev 1 Page 187 2015 SAM RollMap User Manual Rules Engine Test Header Address Figure 11 Alarm Window Display with Text String The Create State Trigger and Alarm Actions buttons provide a convenient means of creating a global action on the logic driven field Taking a different example where two input fields INPUT1 FAIL and INPUT2 FAIL are aggregated together by a Log Logic rule into a new field AGG_INPUT the Create State Trigger button can be used to generate a state trigger on this field and the Alarms Actions button provides a shortcut to the global alarm actions dialog where a standard action can be configured Only when both fields go to FAIL will the trigger be fired Issue 6 Rev 1 Pa
44. MEA Services Local SNMP Service Description Log On As y Smart Card Manages a Manual Local Service Stop the service Smart Card Hel Enables su Manual Local Service Restart the service SNMP Serios Anto made Local System a SAMP Trap Ser Receives tr Started Automatic Local Service TSSOP Discover Enables ds Started Manual Local Service Description Sy oyster Evert Tracks syet Started Automatic Local System includes agents that monitor asvstem Restor Performs Started Automatic Local System the activity in network devices Tak Scheduler Enables au Started Automatic Local System and report to the network Gu TCR F NetBIO Enables su Started Automatic Local Service console workstation a Telephony Provides T ManLval Local System Figure 3 SNMP Services Right click on SNMP Service and click Properties Select the Agent control tab and enter a contact name and location SNMP Service Properties Local Computer Generel Log On Recovery Agent Traps Security Dependencies Internet management systems mey request the contact person system location and network services forthis computer irom the SMMP service Conect Supersol Location CHa Denice e Physical Applications 7 Datalink and subnetwork le Interriet EncHo end Figure 4 SNMP Service Agent Properties Select the Traps tab The default community name is public If required add a
45. Med E HEX ir Figure 7 Docking Windows Page 15 2015 SAM RollMap User Manual General Operation Docking a window directly over an existing window causes the two windows to be tabbed allowing selection of either of them Docked windows can be pinned to the edge of the screen so that they become tabbed windows e To pin a window to the edge of the screen click the 1 button User Network E E PS Test Lab PA 5C unit gt Example Location ES Channel 1 T y sn Oo pl T 5 MOVIN 48877 Figure 8 Pinned Windows e To restore the window click the a button 3 3 2 Customize Toolbars The buttons on the toolbars at the top of the screen can be customized to remove or add buttons as required To remove buttons from a toolbar 1 Click on atthe right of a toolbar 2 Click on Add or Remove Buttons 3 Select the toolbar to customize 4 From the list of buttons that displays uncheck the buttons not required in the toolbar h E f y Meal ME Add or Remove Buttons General G New Ctrl4n Foom Display ie wal Open Crl o E m Save Ctrl 5 val Time Unit Type y Copy Ctrl c Paste Ctri y E Print Ctrl P Back one level Forward one level Home Schematic Edit schematic Ctrl Alt Enter Login Lock Yunlock views Log Logic Cascade 1 Had Horizontally Tile Vertically Tile Minimise all windows H Restore all windows L
46. Name Local Time Address nit Name Local Time A lt ill lt ull gt lt Ul gt QVIGDMSDS 3000 34 01 ERROR due to INP 1 4 O 44 453 90 i 33 502 l Figure 85 New Alarm The faulty unit now displays in the Active window This indicates that a new change of status has occurred and action needs to be taken Hide the Mask Window The Mask window can be reduced or made hidden by dragging the centre splitter pane to the right hand side Address Unit Name Local Time Unit Type Version Units Address lt Il gt lt ill gt O110DMSDS 3000 39 01 ERROR due to INPLU 1 O 4 o4 043 00 90 8 502 Figure 86 Hide Mask Window Print the User Alarm window The page setup is similar to that in the System Alarms window except that you must select either the active or masked window to print or preview Print Alarm List J Active Alarm List lett window Figure 87 Print Alarm List Page 72 2015 SAM RollMap User Manual 9 11 5 11 1 Issue 6 Rev 1 System Alarms Window Configure Headers Any of the column headers available from the System Alarms window can be added to the User Alarms windows Columns can also be deleted if not required A header can be selected and dragged to a new position with the mouse The Edit menu provides access to Copy Paste and Select All options Unit entries can be copied to the clipboard for use in the User Alarm window Items in this window can be dragged
47. OST m3 a OIE IQOM EC 0000500 Bion Mor 16 074414 2015 EXTRA LOST ES OA DQO IDOE 40000505 Mier Mer 18 07 44 14 MA 0 Deaf IQABCOO le y gir JA OF ai i GACH IARCDO OOO 50d Misa Mos LA 074 14 2003 IPT eT f more w tt ul 3 a 7 ek gl i al BAAL oa as ORD O em 1 SS Ret legged Aule Dorey Ol Hor Mey 18 0820634 201 Fig 68 System Alarms Window Configuration 5 2 Connect to Units RollMap can connect to the RollCall Control Panel and open a specified unit s template or if the unit has an IP Address log field connect to its Web based management interface e To open a unit in the RollCall Control panel right click on the unit in the System Alarms window and from the menu select Connect to RollCall Panel The unit s template displays in the RollCall Control Panel e To open a unit s Web based management interface if the unit has an IP Address log field right click on the unit in the System Alarms window and from the menu select Connect to URL The unit s management interface displays 5 3 Mask Units 5 3 1 Mask Setup The Mask Setup option specifies whether item masks are saved locally or received from a server To change the Mask Setup e From the Configuration menu select Mask Setup The Mask Setup dialog displays Issue 6 Rev 1 Page 62 2015 SAM RollMap User Manual Issue 6 Rev 1 5 3 2 5 3 3 5 3 4 9 3 9 5 3 6 5 3 7 5 3 8 System Alarms Window Mask Setup Mask information
48. PID on an IQSDAO2 and raise an alarm if the values differ 1 Create a new Keyword Header for the comparison output See Set up Keyword Headers on page 21 Headings x Setup File CurrentHeaders ctg Column Selection Colurnn Number 3 COMPARE_PID_H aa Enable SNMP trap on change Header keyword COMPARE_PID_HOUSE_ID 2 Show only on Warning or Failure Display Title Miss COMPARE_PID_HOUSE_ID Exclude keyword s OUCT Field Number Field Text Field Good Green state keyword s Universal Coordinated Time Field y Cyan display keywords if state is Good lise Global Time Format Del Fane Magenta display keywords if state is Good Display Format TAN SAA Warning Yellow state keyword s S Failure Red state keyword s Number Field gt Default State Error Waring Good Warning Error Good Green gt Ly New Delete OK Cancel Figure 74 Example Screen 1 2 Inthe alarm list select the COMPARE PID HOUSE _ID field for the IQSDA02 module to be monitored Right click in the field and select Log Field Logic Issue 6 Rev 1 Page 66 2015 SAM Issue 6 Rev 1 RollMap User Manual 3 then click Add Log Data Logic Input Log Fields Simple Query 0000 24 04 04 1QSDA02 Log Header INPUT_1_PID_HOUSE_ID Input1 Add System Alarms Window In the Log Field Logic dialog sel
49. RollCall Control Panel to the network Check the Use TCP IP Log server checkbox to make a TCP IP connection to a RollCall Log Server This has significant speed improvements over the polling status file method above When using a TCP IP connection to the Log Server the File Input parameters are ignored In the Log Server IP Address field enter the IP address or name of the Log server If the Log server program is running on the same PC as RollMap the IP localhost address of 127 0 0 1 can be used Note For RollCall Version 3 3 set AllowSockets 1 in the RollLog section of the ROLLCALL INI file in the Windows directory and then restart the Log Server The default Log Server port is 2052 but a different port can be specified as lt ipaddress port gt 4 1 1 TCP IP Input and is recommended for all installations or any of the other allowable IP formats Issue 6 Rev 1 All IP address fields can be input as any of the following formats ipaddress port ipaddress port port ipaddress or port ipaddress Page 18 2015 SAM RollMap User Manual Issue 6 Rev 1 4 1 2 Configuring RollMap A Connection Retry Time of 5 seconds is the default This retry time can be changed if required using the up and down arrow buttons File Input If using a current status file the file must have been previously generated by the Log Server Click on the Browse button and navigate to the location of the status file RollMap reads data fr
50. Screen 3 D equal and when the log data is not equal Page 67 In the Comparison Logic section enter the text to be displayed when the log data is 2015 SAM RollMap User Manual System Alarms Window Input Lag Fields Output Log Field Simple Query Address Log Header COMPARE_PID_HOUSE_ID Address Log Header 0000 24 04 04 10SDA02 OUTPUT_1_PID_HOUSE_ID Out Add 0000 24 04 COMPARE_PID_HOUSE_ID 0000 24 04 04 10SDAD2 INPUT_1_PID_HOUSE_ID Input 1 PID House Comparison Logic 10000 24 04 04 1QSDA02 OUTPUT_1_PID_HOUSE_ID Outp Use Comparison Logic Data when all log data are EQUAL OK Remove Data when any log data are NOT EQUAL Advanced Query WARNING PID CHANGED Summation Logic Use Summation Logic Alarm Actions Create State Trigger Alarm Actions Delete OK Cancel Figure 77 ExampleScren4 ee 6 Click OK to close the dialog and save the changes The COMPARE _PID_HOUSE _ ID displays e OK when the Input PID and Output PID match e WARNING PID Changed when the Input PID and Output PID do not match 5 8 View Unit Details The Details option brings up a popup dialog box showing only the headers and fields for the selected item This box also allows drag operations onto ActiveX objects in the schematic and component windows for trigger assignment e To open the Details dialog right click on a unit in the System Alarms window and select Det
51. Tab Configuration gt Move Tab Order Left Delete Tab To remove a tab right click on it and select Tab Configuration gt Delete Tab History Tab Log File Setup Use this option to enable or disable log file creation for a tab and to specify the location and file naming convention to be used for the log file To enable log file creation select Enable log file The log file is created according to the parameters specified To use an automatically generated file name which is based on time and date select Use automatic filename based on Time Date Then in the Automatic filename section specify the path to the directory in which the generated log files are to be stored This must be in a local or network accessible directory The file name is in the format dd mm yy log When using automatic file names the following variables can be used to add additional information to the file name e a Abbreviated weekday name 3 characters e b Abbreviated month name 3 characters e d Day of the month as a decimal number 01 31 e H Hour in 24 hour format 00 23 e Y l Hour in 12 hour format 01 12 e j Day of the year as a decimal number 001 366 e m Month as a decimal number 01 12 Page 83 2015 SAM RollMap User Manual History Tabs e M Minute as a decimal number 00 59 e Y p Current locale s AM PM indicator for a 12 hour clock e S Second as a decimal number 00 59 e U Week of the year as a decimal number w
52. Tabs on page 181 The system is now ready to use See Working with Volicon Observer on page 181 Configuring Shortcut Links After Volicon Observer is set up and running the RollCall Links menu must be set up to access Observer To configure the Links menu edit the Configuration cfg file which is located in the installation directory By default the location of this file is C Program Files SAM Rol1lMap Configuration Configuration cfg or Ce Program Files 66 SAM ROLI Map Conftigqguretion Contigquratlionm cro Open this file in a text editor such as Notepad and in the AlarmViewRightClickAllUnits section add an entry similar to this Iteml View video in Volicon Observer C Program Files Internet Explorer iexpl ore exe 192 168 50 90 monitor php ch Information2 amp time UCT Where View video in Volicon Observer is the name the that displays in the links menu E AProgram Files Internet Explorer iexplore exe is the link to the Internet Explorer Program This can be set to another type of browser if required LAS 3090 is the IP address of the Volicon Server PC This can also be a DNS recognizable name monitor php ch Information2 amp time UCT is the text required by the Volicon Server This text should always be exactly as displayed here Page 179 2015 SAM RollMap User Manual For example Integrating RollMap with Volicon Observer AlarmViewRightClickAl1lUnits Item0 System H
53. Trigger Get RollTrack as ny Get RollTrack Object Address Hex Defer Net Command to a command Type Defer Port Poll Every seconds Result processing for State Result processing for Display of Value C Ignore state Use raw data 6 Handle state Use procesed data Mode Format oo Warning use VALUE for result substitute Fail operators amp lt gt use VALUE for result substitute operators 8 1 lt gt Log Unit 0000 00 01 Write to Log C Log Header Delete Open RollMap manual Figure 38 Get RollTrack Issue 6 Rev 1 Page 38 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap To handle the state of a unit define the values for the OK Warning and Fail States To display the results in a meaningful format process the received data converting to an actual value with the appropriate unit for example mV C Use the Test button to apply values to the definition and check for the expected results Define the address for the unit to which Get RollTrack is sent Also define the Log Header address The log unit and log header fields are used to specify the destination of the Get action It will populate the field on the specified unit with the processed data This can be either an additional field on an already existing live unit or on a virtual unit by choosing an unused address Send Message This action sends an email to a specified recipient or re
54. a TER p T 10 Playout Frame 10 IQH3UM4 5 p T 11 Playout Frame 11 IQH3UM4 5 4 e Channel 2 E 08 0 4 im 10 Playout Frame 10 IQH3UM4 5 E 01 Hyperion 5 IQHIPOO Ey 02 Hyperion 6 IQHIPOO Bru 03 Hyperion 7 IOHIPOO Figure 93 Default Headers Using the popup menu items in the User Tree can be reordered by using the move up down options expand and contract 7 1 1 Filtered Groups Filtered groups are an auto generated group of units based upon user defined rules Rules are defined using the Rules Engine See Rules Engine on page 183 The following example shows how to create a rule which adds all units that have Channel 01 OR Channel 2 in their INFORMATION2 header field 1 From the User Tree popup menu select New Filtered Group 2 Choose whether the new filtered group is added to the Test Room location or be the Start of a new tree RollMap Figure 94 New Filtered Group Location 3 Select No a Ea Test Room p E 10 Playout Frame 10 IQH3UM4 5 p T 11 Playout Frame 11 IQH3UM4 5 Via Channel 2 New Fitered Group i Figure 95 Add Filtered Group Name 4 Click on the new filtered group icon and the Rule Editor screen displays Issue 6 Rev 1 Page 79 O 2015 SAM RollMap User Manual Issue 6 Rev 1 Rule Editor Name New Filtered Group 2 Virtual unit address Rule Rule Builder XXXX XX XX T User Tree Z Show all contents of frames 4 Show cards in th
55. an activity indicator only Full Screen expands the System Alarm window to fill the monitor screen Show text on Tool bars places the function name of a tool icon under the icon Hide When Minimized hides the RollMap icon in the bottom right system tray RollMap System Alarms File Edit View Configuration Window Help of Physical Network Tree Panel pay Ki F a User Metwork Tree Panel J Physical Networ History Panel Unit Me is E Status Bar RollMap Full Screen Alt Enter gt A Network Toolbars W UK Logs Show Text On Tool Bars gt Network gt y4 UK RollT gt A Network Aggregate State b ch UK Lab Highlight Frames b gt y4 Stand Al gt y Stand Kz b Nefwork Auto arrange Column Widths p sh Network Show Error State in Network tree gt AH Network Hide When Minimized Highlight Changes i Open Schematic Links in Same Window Figure 71 View Options Aggregate State The display can be set to show the total aggregate of a unit based on the states of all its triggers This shows the unit as a single colored line Turning off the aggregate state displays each trigger field as its actual state color Highlight Changes When Highlights are enabled recent changes are shown in a different color The duration and reset mode can be changed in the Configuration gt Highlights menu Auto arrange Column Widths Selecting this option automatically adjusts the column
56. are to be sent must be created See Create a Transport Profile on page 53 By default RollMap includes the Open Source SMTP tool blat exe for sending mail messages The arguments for this tool can be configured in the Configuration gt Message Configuration gt Transports dialog For full details refer to the online documentation at http www blat net syntax syntax html 2 A message profile which specifies the email recipients and structure must be created See Create a Message Profile on page 54 3 A Send Message alarm action must be created To access the email configuration dialogs From the Configuration menu select Message Configuration The Profiles dialog displays Profiles Edit New Delete Transports Cancel Figure 56 Profiles 4 9 1 Create a Transport Profile e From the Profiles window click Transports The Transports dialog displays Transports New Delete Edit Figure 57 Transports To add a new profile click New or to modify an existing profile select the profile and then click Edit The Transport window displays Issue 6 Rev 1 Page 53 O 2015 SAM RollMap User Manual Configuring RollMap Transport Application Parameters o 265 Subject Som Message 4 First line of message f Temporary File containing message Sot Recipient 4 Supports Multiple Recipients Cancel Figure 58 Transport Window In the Transport window e Give the profi
57. be changed using the parameters within the Check Box Style tab Images can be added to the display as an additional aid to indicate when the checkbox is locked or unlocked in this example an open or closed padlock displays to show the current state of the check box Add images in the Picture tab Object Properties Fonts Alam Triggers Addressing Position General Picture Check Box Style Unchecked Picture LIBRARY GenericGraphics lcons Unlocked gil Checked Picture LIBRAR Y GenericGraphics lcons Locked gif WlKeep Aspect Ratio Paths Wl Show Caption On Picture 4 Show Button Bevel 4 Show Button Background Figure 215 Check Box Example Pictures 9 8 7 Snell Roll Clock Object This object allows an alarm trigger event to be represented as a clock item in a schematic window The global system registered name for this ActiveX object is Snell Clock 9 8 7 1 General Properties The initial state is set in the General properties The clock object has two basic styles analogue or digital Issue 6 Rev 1 Page 153 2015 SAM RollMap User Manual Schematic Window Object Properties Fonts Alam Triggers Addressing Position General Commands Clock type mal Figure 216 General Properties From the Clock type drop down list select Analogue or Digital An offset either plus or minus may be added to the time by selecting the appropriate values from the drop down lists To resize the clock click on
58. be selected Colors specifies the state and system colors used in the System Alarms window To change the state and system colors from the Configuration menu select Colors To change the color for an item select the item from the drop down list and click Change A color selection palette box displays Any custom or predefined color can be selected The system can store up to 16 custom colors To reset any field click Default Highlights configures the highlight behavior displayed when a field in the System Alarms window changes When a fields changes it can be highlighted using a Highlight Color To change the highlights settings from the Configuration menu select Highlights The color can be set from the Color menu The highlight duration can be set from 1 to 32000 seconds If the Manual reset checkbox is selected the highlight remains on the field To manually reset the highlight from the View menu select Highlight Changes gt Clear All or Clear Line Time Format configures the time format used by RollMap To specify the time format from the Configuration menu select Time Format Specify whether the time should be displayed as Greenwich Mean Time or Local Time and using the parameters shown in the dialog construct the desired time display format The time and date are displayed at the bottom of the RollMap main window and also displayed in the System Alarm window under the Network Time heading Auto Disc
59. by dragging the item from the right hand window to the left hand window Address Unit Mame Local Time Address Unit Mame Local Time gt a D 93502 a gt lt iil 0410 CBRG 0000 0F 04 ERROR due to RECON 453 04 44 1 90 Figure 82 Masking Unmasking Units This masking effect allows you to remove unwanted items from the Active window so that known faults can be put aside for action With a combination of viewing masks the Active window can be made to show only new errors that have not been masked Set Viewing Mask Set viewing mask to Errors and Warnings only Remove check for Unknown and OK states Address Unit Mame Local Time A Address Unit Mame Local Time lt Il 44 a1 ao ao sa 502 4 Figure 83 Set Viewing Mask Move Faulty Units Now we can move all the known faulty units to the mask window by selecting all the units and then dragging them across to the mask window Address Unit Mame Local Time Address Unit Mame Local Time 90 sosi 02 10D1DAC 0 4000 05 02 ERROR due to INPL O 0 O 4 44 454 00 Figure 84 Move Faulty Units The left hand Active window is now free of unwanted information and only new changes to error or warning states display If a previously good unit develops a fault then it changes from its OK state to an ERROR state Page 71 2015 SAM RollMap User Manual Issue 6 Rev 1 5 10 6 5 10 7 5 10 8 System Alarms Window New Alarm nit
60. can be used in the HTML generation Theme Cancel Figure 48 Report Properties Select the theme This is a style sheet used to create the report Additional style sheets can be referenced from Install Directory Configuration Configuration cfg and then selected from this drop down box Add a subtitle and description as required The Highlighting section defines the colors to be used for highlighting the report rows containing the specified keywords A custom logo can be added to the output report Click on the browse button and navigate to the folder containing the logo User defined arguments can be passed to the style sheet For example in Figure 48 a parameter custom_arg is defined with a string value The theme Default Layout is rendered using the style sheet Install Directory Configuration DefaultReport xslt This file can be edited using a text editor to make use of the custom parameter Click on the Notifications button to define an action to take place after the report is generated Notification Settings Fre run settings Prompt for Report Properties Tite Description etc Post un settings Perform the following action when processing is complete 5 None O Alert me with a popup message box 5 Open HTML report using default web browser Cancel Figure 49 Notification Settings Select from None Alert with a popup message box or Open the report using a web brow
61. elements of the panel Object Properties Alam Triggers Addressing Presets Configuration Routing Position Source Panel Destination Panel Number of Sources Number of Destinations Define Styling Options Click to edit Enable Undo Background z ckg Timeout secs 0 No timeout Enable Panel Lock Enable Dest Protect Invert Keypad Up Down Buttons Figure 230 Dial up Panel Configuration In the Define Styling section click on any of the items in the list to display the format styling properties for that item Widget Properties Style Normal Color a Selected Color Transparent El Opacity 0 255 Roundness 0 100 Border Thickness Border Color Font Family Select Color Keep aspect ratio Clear image Draw behind T Clear all images Figure 231 Panel Style Properties From within this properties screen the button color text font and scaling can be adjusted Images may also be imported to some buttons if required Any of the items in the Define Styling section of the Configuration tab may be selected whilst this format styling screen is open The properties change according to what is selected Issue 6 Rev 1 Page 163 2015 SAM RollMap User Manual Schematic Window Additional buttons may be added to or removed from the panel for example Undo Destination Protect and Panel Lock The dial up panel numeric buttons may be inverted 9 8 10 3 Routing Propertie
62. fields Rules that evaluate to True False are typically used for filtering data for example when used in filtered groups and QC reports however rules may also be defined that evaluate to a string or decimal which are often used in log field logic for the creation of new log fields from existing ones F 2 Rule Editor The Rule Editor is shown in Figure 1 Rule Editor x Name Virtual unit address xxxx xx xx V Show all contents of frames 4 Show cards in their frames Rule v Compiled RPN Clear Rule Rule Builder Join Header Operator Value ADDRESS Mm gt AES E E a AFD_CONFLICT z fo maradi wildcard ANALOG_1L single character wildcard ANALOG _1R gt Note Endose strings in quotes ANALOG_2L gt ANALOG _2R AUDIO s j AUDIO_A_LEFT AUDIO_A_RIGHT v OK Cancel Figure 1 Rule Editor The Rule Editor provides the following features e Syntax checking of rules in each key press e A rule builder for inserting queries into the rule e Operators Equal to Not equal to Less than Less than or equal to greater than greater than or equal to addition subtraction multiplication and division e Query on string number decimal integer RollMap unit address or date and time The name of the filtered group This name can be edited For QC reports and Log Logic this field is unused Virtual Unit Ad
63. new community name For each community required add one or more IP addresses for the trap destination location of the SNMP manager If a SNMP manager is to be run on the same computer as RollMap then add the name localhost or the IP address 127 0 0 1 to the list The corresponding SNMP manager must have the same community name configured to receive traps from RollMap Page 171 2015 SAM RollMap User Manual SNMP Setup for RollMap SNMP Service Properties Local Computer General Log Un Recovery Agent Traps security Dependencias The SNMP Service provides network management over TCRIF and IPSSPX protocols Wraps ane required one or more comunity names musk be speciied Trap destinallons may be host names IP addresses or lP addresses Comrriiinity neame dew F Remonre irom list Trap destinations Add Edit Remove Figure5 SNMP Service Traps Properties The Security tab sets up the access modes of the SNMP variables and which sources to accept messages from for SNMP managers SNMP Service Properties Local Computer General Log On Recovery Agent Traps security Dependencies lv Send aulhenticabon trap Accepted community names Community Rights public READ ONLY dev READ ONLY Add Edit Remove le Accept SNMP packets from any host C Accept SNMP packets from these hosts O O er Figure 6 SNMP Service Security Properties All RollMap SNMP trap variables a
64. ny Streaming Control Target Stream Location URL or File rtsp 172 19 77 45 stream1 Action 5 Play O Stop Pause Open RollMap manual Figure 53 Streaming Control This action takes the stream URL and a command When triggered it finds the player controlling that stream and invokes the action on it Because the streams are shared between objects with the same location pausing has the affect of pausing all objects Page 51 2015 SAM RollMap User Manual Configuring RollMap VLC Requirement This feature requires VLC player If you have not got VLC player installed then it will popup a dialog when you use the tool for the first time VLC Player Required This feature uses the open source VLC SDK To use this feature you must install this SDK separately You can download it from http www videolan org vic If this is already installed enter the VLC installation directory below C wic_player Browse Note This location will be stored in Configuration cfg VLCInstallPath Figure 54 VLC Player Required You can enter the location of VLC player It should be the directory which includes the libvic dll RollMap A Could not load required libraries from C wlc_player Check that the path and version of the VLC library is correct 2 1 2 minimum Continue with this path Figure 55 VLC Library Enter a bad directory and you will get the dialog in Figure 55 The code has tested that
65. objects 6 Fined page size 800 lt em Schematic skin definition file only affects new objects being added to this schematic Figure 120 Workspace Properties Page 94 2015 SAM RollMap User Manual 9 2 4 7 9 2 4 8 Issue 6 Rev 1 Schematic Window Control Level Properties The Control Level properties are for enabling and disabling the interactive controls on the schematic This is a page wide setting that can be overridden on an individual basis To set the default for the schematic to be enabled click on the Control enabled radio button Document Properties Control enabled Control disabled Reset all children to enable control Reset all children to disable control Reset all children to inherit control level Figure 121 Control Level Properties The three buttons on the screen allow for the resetting of all interactive control objects on the schematic This also allows the enabling of features on controls on schematics which were designed in previous versions Reset all children to enable control Reset all interactive control objects on the schematic to be enabled Reset all children to disable control Reset all interactive control objects on the schematic to be disabled Reset all children to inherit control level Reset all interactive control objects on the schematic to inherit from the selection above Authentication Levels Properties The Authentication Levels allow
66. of the attributable alarm actions see Configure Alarm Actions on page 35 Issue 6 Rev 1 Page 140 2015 SAM RollMap User Manual Schematic Window Log fields can be used with a Snell State Frame See Dynamic Log Field Insertion on page 191 9 8 4 3 Pictures Properties A picture may be assigned to each state of the object If a single picture is required regardless of state then the Use Default Picture Only checkbox should be checked If a picture has not been assigned to a particular state when that state occurs the Default Picture is used Object Properties Alam Triggers Addressing General Commands Pictures Colour Position Default Black Picture Po gt Green State Picture Po E fellow State Picture Po e Sa a UM Embed Picture Paths Keep Aspect Ratio Use Default Picture Orly Property Substitutions as Commands Figure 194 Pictures Properties The Embed Picture checkbox is available for embedding all picture files into the schematic The content of the picture files are stored in the schematic itself and hence do not require the link to the picture file afterwards This feature should be avoided as the schematic files can become very large in size and changes to the pictures are reflected until the picture is reselected and re saved The Keep Aspect Ratio checkbox maintains the original aspect of the picture 9 8 4 4 Colors Properties This sets the colors for the Foreground Color Object Prop
67. onto the User Alarm windows for faster editing operations Right click on the header bar in the System Alarms window to display a context menu and select the required option Select Columns De select Columns After Pin Edit Header Create All Headers Sort Headers by Name Delete Unused Headers Fix Header Position Auto arrange Column Widths Figure 88 Headers Menu The User Alarms window has a similar menu but with a subset of these features Select Columns Selecting this option brings up a dialog box with all the available column headers on the left and the currently used headers in the order that they display in the system alarms screen on the right ON columns Address Unit Name Address Unit Name Local Time COMPARE PID _HOUSE_ID Unit Type Version Unit State Information CELLMASES IP Address IP Name LOG_COUNT Up time PSU 1 Name PSU 1 State PSU 2 Name PSU 2 State Temp 1 Name Temp 1 State Temp 1 Celsius Voltage 1 Name Move Up Move Down Sort All Information CELLMASKS IP Address IP Name Sort Selected Delete Cancel Figure 89 Select Columns To add a new header 1 Select a header name from the left column and click on gt 2 The new header is added to the bottom of the list Use the Move Up and Move Down buttons to position the new header where required This dialog can be resized if required Page 73 2015 SAM RollMap User Manual 9 11 2 9 11 3 5 11
68. screen add an Auto trigger and add a Get SNMP action This will poll the SNMP field on the unit to get the current value 5 Enter the Get SNMP details and Polling as required Issue 6 Rev 1 Page 148 2015 SAM RollMap User Manual Schematic Window Actions E a Auto Get SNMP Eu y Get SNMP Agent Address 192 168 50 82 OID 1 13 6 1 2 1 2 2 1 7 065540 Community Number of retries Fi EE seconds Result processing for State Result processing for Display of Value C Ignore state 6 Use raw data Handle state Use procesed data OK 1 Format Warning use VALUE for result substitute Fail 2 operators amp lt gt use VALUE for result substitute operators 81 rw lt gt Test Debug Raw 0 Proc 0 State WARN Shown in Log Header WARN 0 Log Unit FO00 36 00 Write to Log C Log Header LAM_PORT_ADMIN_STATE Open RollMap manual Figure 206 Check Box Example Actions 6 Click on the Handle state radio button 7 From the mode drop down list select Match by List and enter the following parameters OK 1 The value received by the virtual unit when the check box is set to On Warning 0 No action Fail 2 The value received by the virtual unit when the check box is set to Off 8 Inthe Actions screen add a CheckBox Un checked Press trigger and add a Send SNMP action 9 Enter the unit details and a Value of 1 This sets the check box such that when checked t
69. the basic router types e Configuration define the number of buttons and the layout and style of the panel e Routing configure individual source and destination button operation Presets Properties When a new panel is added to a schematic the default Custom type is selected To start the configuration using one of the preset routers select the relevant radio button according to the router type connected to This will configure the correct commands and numbers and will display a default grid size according to the router selected Object Properties Alarm Triggers Addressing Presets Configuration Routing Position Select a router type O Vega Sirius 800 Family 16x16 Default VIQSPI Router Ctrl Driver 16x16 Default Options O IQDMX4 IQSRT20 4x1 Reset grid sizes 0 IQOMX8 TOSRT21 8x1 4 Reset button command offsets O IQ6RTS IQORTS 8x8 O IQBRT6 IQORTE 6x4 5 IQSRTOO 5x2 O IQSRT10 8x2 Figure 229 Router Presets Page 162 2015 SAM RollMap User Manual Schematic Window Two option checkboxes one to reset the button grid size according to the selected router and one to retain the router command numbers are both checked by default These can be unchecked if the functions are not required 9 8 10 2 Configuration Properties In this tab set up the number of sources and destinations required for the panel and define the format of the router panel layout and the style of each of the
70. the control screen template into the schematic Control screen templates must first be cached before they can be selected for inclusion into a schematic See Load Control Screen on page 77 9 5 Components 9 5 1 Component Documents The general facilities for a component document are the same as for a schematic document The exception is that a component document does not have a Run mode A component document must be included into a schematic document for it to become active The idea of a component is to enable you to build a library of re usable objects that represent more complex pieces of equipment The alarm triggers for ActiveX objects can have deferred addressing and hence can be assigned at the schematic link level User Alarms User selectable alarm list alm schematic Editable schematic sheet sch Component Editable schematic component cpt Figure 159 New Component Refer to the Schematic Window section for details of menu options The file options for a component are similar to those of the schematic with the exception that the default file extension is CPT 9 5 2 Inserting a User Component This allows the selection of a user created component file with the extension CPT A component is similar to a schematic document with the exception that it cannot be made to Run by itself lt must be included as part of a schematic document This gives you the ability to create re usable o
71. v History Unit Name Unit Type Unit Address Time Stamp 7 Message Duration Timecode E Hyperion IQHIP00 1100 16 03 Wed Dec 11 12 14 18 2013 INPUT_1 BLACK FAIL Black 0 01 40 21 a Figure 107 Complimentary Tab Black FAIL Black History Tab 1 Hyperion sch tJ Details 1100 16 03 Hyperion Sort by Header History Unit Name Unit Type Unit Address Time Stamp Y Message Duration Timecode A Hyperion IQHIPOO 1100 16 03 Wed Dec 11 12 14 18 2013 MN 0 01 40 21 Figure 108 History Tab Black FAIL Black When the state changes from INPUT_1_BLACK WARN Black Amber to INPUT_1_BLACK FAIL Black Red the active event INPUT_1_BLACK FAIL Black is displayed on the Complimentary Tab The event that has just completed INPUT_1_BLACK WARN Black is now displayed on the History Tab Page 88 2015 SAM RollMap User Manual Issue 6 Rev 1 History Tabs State INPUT_1_ BLACK OK Complimentary Tab ms Hyperion sch E Details 1100 16 03 Hyperion Sort by Header History Unit Name Unit Type Unit Address Time Stamp 7 Message Duration Timecode DE Hitoy Figure 109 Complimentary Tab Black OK History Tab ms Hyperion sch E Details 1100 16 03 Hyperion Keyword lt History Unit Name Unit Type Unit Address Time Stamp 7 Message Duration Timecode E Hyperion IQHIPOO 1100 16 03 Wed Dec 11 12 14 18 2013 INPU
72. wed Se eae BO dee sodio 12 3 27 OcE Ci Schema oid tigate ora io Susie ra Rd aera ohare 12 32 UT MOG erae ade Ged eee eet Wo th a Ade Ghat aM hon Seti Ee hed AE 13 3 2 12 LOCK UNIOCK VIEWS secs 24 raid dae eee A e A 13 A OC OG IG trace dens Mice tice sled A a wean 2 13 S2 l4 CasCaCe arcs ere ania tas Guetta ated ue a iio ward ee ee de 13 3 2 19 PIG TAOMZOMTANY buat Gare naa Reel A Ream eae a DRA A 13 3216 NE NCMICAIY sage ciars hsm Sob ach ice oR hed dee e hy Barend kh AAA e 6 14 3 2 17 Minimize Un Minimize 0 0 0 ce eee 14 REMO ZOOM sss Bas ah ao See he bso U et e Ba baat eee 14 3 2 19 Scale to Fit Window 0 0c eens 14 32 20 FUNSCKECI YG oid tad errar Rb eee dad ote we Rh oan ta ee RA 14 3 2 2 MPYEVIOUS INGXE ud eG ect ae Se eee es ee ee le A eee oe 14 3 3 Customize Screen Layout and Color Theme 00000 e eee 15 3 3 1 Docking WINDOWS aari Ae e A RAI AA a A 15 33 2 CUSIOMIZe TODAS said ra ari dea kD BM Re od 16 3 3 0 Seta Color Theme seriada codi 17 4 Configuring RollMap S25 3 05 dc Sewer as antic bed kb oi Eh ee eh eae ee ants 18 4 1 Set the Log Server Connection 0 ccc cee eens 18 Ma O NIE NOUL sseie sas RN 18 PE kA Wee MAQUI de enie ave tects Scan tnd atc Ae watt dpc tala bn betel deme ed ake gece ete Cerda te oda 19 Ao COnroliGOnnecion srt lara Rd 19 4 1 4 Thumbnail Server Connection 0 0 0 0 0 ce 20 4 2 Set up the Unit List 2 0 eee eee 20 4 2 1 Set up Keyword Headers
73. window is targeted by a Details schematic these fields are replaced with the unit s NET and UNIT address components Rules for Opening Schematics Schematics can be set to automatically open and run in different windows in the following ways e Check the Open details schematics in a separate window checkbox to ensure that schematics containing N and U in the path are detected and opened in the details window by default e A schematic filename or the folder in which a schematic resides can be checked and upon matching a rule opened in a window as defined in the rule e Specify a target window directly from a schematic link defined in the schematic properties dialog Full Screen Options The following options are available for controlling which screens can show as full screen Disable full screen for released windows The main application screen can be set to full screen but other windows remain as pop ups which can be placed over the main screen Disable full screen for released windows if more than one displayed Allows the main screen and one other to be displayed as full screen In the event of there being more than one released screen only the main screen can be displayed full screen Enable full screen for released windows always In this case only one of the released windows will be displayed along with the main screen but both will be full screen Manually Display Schematics Outside of the RollMap Window
74. 0 591 LU week of year as decimal number with sunday as first day of week 00 53 vow Weekday as decimal number 0 6 Sunday is 0 vou Week of year as decimal number with Monday as first day of week 00 53 7x Date representation for current locale 2 Time representation for current locale voy Year without century as decimal number 00 99 vey Year with century as decimal number vez Either the time zone name or time zone abbrewiation depending on registry settings Cancel Figure 17 Time Format Configure the time format as per the on screen instructions and click OK Changing this time format does not change the time format in the status bar at the bottom of the screen Manage Users Setup user types and control user access Users can have differing levels of read and write access to schematics in the system Also an Administrator can have full user management Capabilities The system works on a hierarchical scale with two scales one for read and one for write allowing different users to have unique access to schematics within a RollMap System User access is also controlled by the authentication level set for each schematic See Authentication Levels Properties on page 95 Add a User To add a user 1 From the Configuration menu select User Authentication gt Manage Users The first user added must be an Administrator user and be used for adding editing and deleting further users A U
75. 011932003 PUTS LOST Cinta Le MM OH0D1 DAC HADAT AO Tie Dec 101001 33003 1 k Figure 165 Add Control Continue using this method to place all of the required controls on the schematic Once a control has been placed on the schematic it can be resized or moved like any of the other drawing objects The control can be set to be live enabled or read only disabled This can be set once for the whole schematic See Control Level Properties on page 95 To disable or enable an individual control double click on the control and select the desired behavior from the Control Level tab Object Properties Unit Address Position Labels Control Level Design State Actions Control disabled 5 Inhert from container Figure 166 Control Level Properties Page 121 O 2015 SAM RollMap User Manual Issue 6 Rev 1 9 6 1 Schematic Window When the schematic is switched to Run Mode the control becomes active on the screen and can be used to monitor and adjust the module s settings as necessary If the unit is not present at runtime a red border displays around the control Control Objects and Addressing The RollCall addresses of Control Objects are relative to the network point identified by the Control Connection specified in the Log Server Connection settings See Set the Log Server Connection on page 18 In some configurations this may not be the same address that is seen by the Log Server and consequ
76. 15 SAM RollMap User Manual Issue 6 Rev 1 Schematic Window If using a command auto fill can be used to set commands for a number of subsequent buttons as defined in the auto fill screen The Name Command Base Offset Source and Destination fields specify the RollCall command number to use to obtain a name Depending on the router type the Base Command Number is added to the Source Value to obtain the full command number or in the case of routers where they have the same command number this value specifies what the command number is Whichever of these is applicable is determined automatically Set up Destination Buttons 1 Select the first destination button button 1 2 Define the full command number in the Command Base Offset field The offset is automatically calculated from this value Alternatively define the Routing Base and define the Routing Command Offset the number to add to the Routing base to obtain the full command number Each destination will have a different command offset incremental from 0 or 1 typically 3 Enter the value in the Base Protect field for the base command that defines the destination protect function applicable routers only 9 8 9 Snell BPX Router Panel BPX 9 8 9 1 This object allows a BPX router panel to be added to a schematic window The BPX router panel can be configured and the display of the panel adapted as required Figure 224 Default BPX Router Panel In addit
77. 4 5 11 5 5 11 6 5 11 7 5 11 8 Issue 6 Rev 1 System Alarms Window Deselect Columns After Pin This function can only be performed after fixing a header See Fix Header Position on page 74 Select to remove all columns to the right of the fixed header from the alarm window Edit Header See Set up Keyword Headers on page 21 Create All Headers Headers are created dynamically However if a new unit is added which contains new header information stored in the Information field selecting this option creates the new headers from that header data The header data from the Information field is deleted after the headers have been created Once the new headers are created they are updated in the normal way along with all other headers Sort Headers By Name When a fixed header is set this function sorts all headers after the fixed header into alphabetical order See Fix Header Position on page 74 Without a fixed header all headers may be sorted into alphabetical order A dialog displays asking for confirmation that all columns are to be sorted Delete Unused Headers When units are removed the header information for the units remains It is good practice after removing a number of units to delete the headers from these units that are no longer used Fix Header Position Select to fix the current header A pin in the header indicates the current fixed header position a position after which a
78. 50 11 2012 INPUT 1 FREEZES PAIL Freeze 9 9 IQHIUNG E OQHGUMG E O4IQSDAD2 1QSDA02 2000 20 04 Wed Nov 20 07 5041 2013 TEET a lS 11 LLIQUADC MIQBADC DAJQSDADZ JOSDADZ OA Wed Now 20 07 50 11 2013 SE ah DAIQSDADZ IQSDAO2 2000 2404 Wed Nov 20 07 50 11 2013 CEA A A 1950402 1OSDADZ 2000 2494 Wed Now 20 07 5011 2013 ITA A ah M4 1Q5DA02 1050402 D000 2A04 Wed Now 20 07 5011 013 i nenas ane aos As sises onen seso cnan IPENSENS wes e ETIA Channel Onelh p a W pan E a qu T za lt e mm Sa QA A AOS A A ea e Mit 0 mAT O YVON mr Figure 144 Web Page 9 4 5 Streaming Control Tool a This function inserts a video stream control into the schematic window 1 Click on the Streaming Control tool in the tool bar 2 Click on the schematic window and expand out the required area for the Streaming Control as shown in Figure 145 Figure 145 Add Streaming Control 3 With the streaming control selected right click with the mouse and select Properties Issue 6 Rev 1 Page 111 2015 SAM RollMap User Manual Schematic Window Object Properties Address Position Object Address Hex The IPADDRESS log field of the resolved address can be Defer Unit 7 substituted by using the ic Unit Y va able in the URL OR use Defer Port HField Location Type O File 5 Network Stream Figure 146 Streaming Control Properties 4 Enter an IP address to connect directly to external servers or URL or file
79. 7 50 11 2013 MIAMI 0 01 40 43 A 04 1QSDAD2 IQSDA02 2000 2A 04 Wed Nov 20 07 50 11 2013 MANERAS 0 01 40 43 A 04 1QSDAD2 IQSDA02 2000 2A 04 Wed Nov 20 07 50 11 2013 MIAMI 0 01 40 43 04 IQSDA02 IQSDA02 2000 2A 04 Wed Nov 20 07 50 11 2013 MARA a 0 01 40 43 04 IQSDA02 IQSDA02 2000 24 04 Wed Nov 20 07 50 11 2013 INPUT_1_BLACKISH FAIL Blackish 0 01 40 43 9 04 1QSDA02 IQSDAD2 2000 2A 04 Wed Nov 20 07 50 11 2013 INPUT _1_BLACK FAIL Black 0 01 40 43 ES 04 1QSDA02 IQSDA02 2000 24 04 Wed Nov 20 07 50 11 2013 INPUT _1_ANCILLARY_TIMECODE STATE FAIL No ANC TC 0 01 40 43 v lt m gt Channel One Channel One H Figure 100 History Tabs Managing History Tabs To configure the history tabs right click on a tab to display the following menu options Create Complimentary Tab This option creates a tab that is the opposite of its originating tab That is if you create a complimentary tab to a history tab it is a current status tab and vice versa To create a complimentary tab right click on a tab and from the menu that displays select Tab Configuration gt Create Complimentary Tab Create New Tab This option creates a new history tab To create a new history tab right click on a tab and from the menu that displays select Tab Configuration gt Create New Tab Then in the History Tab Properties window specify the following e Window Name In the Window name field type a name for the tab e Window Type To specify the type of informa
80. 83 General Button Setup 1 On the General tab click Command Actions button 2 Add a Button Press trigger with a Command Line action 3 Inthe Command Line enter S ROLLMAP RollMap EXE sys Issue 6 Rev 1 Page 134 2015 SAM RollMap User Manual Schematic Window Actions Command Line SROLLMAP SRollMap exe sys Property Substitutions ba Address N Met 941 0nit SP Port i 5tate 0 3 s State Black Green Yellow Red ssp ExecutablePath c CauseString bt CauseHeader or CauseTrigger ActiveX objects Soh CauseHeader ActiveX objects Sor UserString o 4j Masked State 0 3 HEADER value of a log field header Other 6H hide command execution Date Time Soyyyy oo year as 4 digit 25 MM96 month as 2 digit s6dd day as 2 digit oddd short day name ssdddd lng day name 25 MMM36 short month name wMMMM l0ng month name cz 9b time zone wH gt 24 hour fom Yo minute 265 second Open RollMap manual Figure 184 Enter Command Line Playing sound WAV files through RollMap RollMap is capable of playing standard sound WAV files through the system sound device Only file names with the extension WAV are played For example RollMap exe sound file wav ROLLCALL RollCall EXE p alarm wav Object Properties Fonts Alam Triggers Addressing General Picture Button Style Position Command line Command Actions Figure 185 General Button Setup 1 On the General tab click Command Actions button
81. Compiled RPN INFORMATION1 Channel1 INFORMATION2 Channel2 Clear Rule Rule Builder gt Join Header Operator Value FAULT a ERE O String Number Channel 2 f ANO multiple character wildcard HARDWARE_VERSION lt single character wildcard ID gt Note Enclose strings in quotes IDNAME gt O z INFORMATION1 di TOA INPUT sE gt INPUT_1_ANCILLARY TIMECODE STATE w Insert imat ki OK Cancel Figure 4 Rule Added The editor automatically wraps the existing expression in brackets and inserts the new expression 5 Click OK The changes are saved The rule can be manually edited within the edit box to remove brackets or to change the rule If the edit box displays red instead of green the rule is invalid and the syntax should be checked F 3 2 Example 2 The following example creates a rule within Log Field logic to add two separate numeric log fields and display the result formatted as a string riipu Lag Fields Output log Field A simple Query Address Log Header Unit Hama Addos g Log Header A A A A A A _ asa pooo NAME o o Comparison Logic D Use Companson Logic Lala hon all log date sane EULALI Remove Dela wher any log date ore MOT EGUAL Achvanced Quen J r Summation Logic Jee Suenmaten bonic
82. Deferred Addressing on page 176 Page 122 2015 SAM RollMap User Manual Issue 6 Rev 1 Schematic Window 9 7 Adding ActiveX Objects 9 7 1 Registered ActiveX objects are globally available to any program Many default objects are pre installed by MS Windows itself such as Bitmap Image WordPad document MS Office installs other objects such as Word document Excel Chart and PowerPoint Slide Several RollMap ActiveX objects are installed for the specific use with the Schematic document and are available on the custom tool bar These objects contain special properties variables and methods function calls that allows events from the System Alarm window to be passed into the object The two primary events are 1 State property This can be a property or a method of numeric type The object s property can be a character 16 bit integer 32 bit integer a floating point value or a long floating point value The object s State property is set to one of the following values when in Run mode 0 State is UNKNOWN 1 State is OK 2 State is WARNING 3 State is ERROR 2 Caption property This can be a property or method of ASCII text type The object s property must be a text value made from 8 or 16 bit characters UNICODE The object s caption property is set to the text as displayed by the Systems Alarms window for the assigned trigger Inserting an ActiveX Object To add an ActiveX object into the schematic select the Edit gt Ins
83. L macro is expanded at run time For example C RollCall RollCall EXE u 0000 10 01 or C Program Files SAM RollCallSuite Control Panel Rollcall Control Panel exe u 0000 10 01 or C Program Files x86 SAM RollCallSuite Control Panel Rollcall Control Panel exe u 0000 10 01 Issue 6 Rev 1 Page 133 2015 SAM RollMap User Manual Schematic Window Actions Command Line SROLLCALLS RollCall exe fu Sa Property Substitutions ba Address N Met 941 0nit 9 P Port i 5tate 0 3 s State Black Green Yellow Red ssp ExecutablePath c CauseString Sot CauseHeader or CauseTrioger ActiveX objects s4h CauseHeader ActiveX objects Sor UserString o j Masked State 0 3 FHEADER value of a log field header Other H hide command execution Date Time Soyyyy o year as 4 digit oMM month as 2 digit Sodd day as 2 digit Sddd short day name ssdddd lng day name MMM short month name wMMMM l0ng month name Sor time zone 96H S 24 hour yom minute 553 second Open RollMap manual Figure 182 Enter Command Line Operating the System Alarms Window from a Schematic To add a button that loads the Systems Alarms window set the General Button to call the RollMap application itself using the sys command line parameter to specify the Systems Alarm window Object Properties Fonts Alam Triggers Addressing General Picture Button Style Position Command line Command Actors Figure 1
84. O a a 044050402 KDA 2000 24 04 Wed Nov OSA 2013 EAE TAE lt 0 gt mu a ah amp CAIGA AMAIA CREADO YO Amar PPP cies sxe A 12700005 A NA RI K Figure 111 Schematic Window 9 2 Working with Schematic Documents 9 2 1 Starting a New Schematic Document To start a new schematic document from the File menu click New The New File dialog displays User Alarms User selectable alarm list alm Schematic Editable schematic sheet sch Component Editable schematic component cpt sp Figure 112 New File Issue 6 Rev 1 Page 90 2015 SAM RollMap User Manual Issue 6 Rev 1 9 2 2 9 2 3 Schematic Window Select Schematic and then click OK A default blank schematic displays Figure 113 Blank Schematic The Schematic and Custom Objects tool bars are activated These provide a selection of the most often used features In this state the schematic is in Design mode Run and Design Modes The Edit Schematic button Ku in the toolbar toggles the schematic between Run mode and Design mode Full Screen Navigation The Full Screen button El in the toolbar switches the current schematic whether in Run mode or Design mode to display full screen Once in full screen a navigation bar is available by hovering at the bottom left of the screen Figure 114 Full Screen Navigation Bar Exit full screen gt Step back to the previous schematic Step to the nex
85. OR Figure 11 Bright Theme Example Issue 6 Rev 1 Page 17 2015 SAM RollMap User Manual 4 Configuring RollMap Configuring RollMap 4 1 Set the Log Server Connection In order for RollMap to have any functionality it must be connected to a RollCall Log Server which is in turn connected to and monitoring a RollCall enabled network To configure RollMap s connection to the Log Server e From the Configuration menu select Log Server Connection The Log Server Connection dialog displays Log Server Connection rLog Server Connection Thumbnail Server Connection Use TCP IP Log server Mo aac Log Server IP Address localhost localhost i Y Enable Redundancy Connection Retry Time seconds 5 K Secondary Address 127 0 0 1 Used Shared Current Status File Priority Primary Priority None Current Status File Status File Timeout multiples of poll time 2 status File Poll Time seconds Control Connection Primary Address 172 19 39 30 gt 3 rec Retry Time seconds 3 Enable Redundancy secondary Address localhost r OK Priority Primary gt Priority None Cancel Figure 12 Log Server Connection The configuration for the current status file allows selection of saved file for input or by direct TCP IP input The Control Connection is the address of the RollCall Network proxy or chassis That is the same address used to connect the
86. Properties 9 2 4 2 Fonts Properties Issue 6 Rev 1 The font properties enable the text style and font to be specified Document Properties General Fonts Grid Settings Background Picture Address Workspace Control Level Authorisation Levels Styles Horz Alignment d Sample Text Vert Alignment Change font Change font colour Horizontal left to right Figure 116 Fonts Properties Page 92 2015 SAM RollMap User Manual Schematic Window 9 2 4 3 Grid Settings Properties In design mode you can changed the size of the drawing grid show or hide the grid and select whether items placed should snap to position The grid size value is arbitrary and has no units Document Properties General Fonts Grd Settings Background Picture Address Workspace Control Level Authorisation Levels Grid size Ea Snap to grid Show grid Show grid over objects Grid colour a Change Save as Default for new Schematics Figure 117 Grid Settings Properties 9 2 4 4 Background Picture Properties A background picture can be used for the schematic Select the picture file from the Background Picture tab of the property box The picture displays relative to the window and not to objects placed within it and hence it should not be used as part of the schematic content Document Properties General Fonts Grid Settings Background Picture Address Workspace Control Level Authorisation Levels Picture Filename Display Mode
87. Schematic Address 0 ccc eee eee 177 C 3 Set the Address of a Component Tool or ActiveX Object 177 C 4 Setting the Alarm Trigger Address 0 00 cee eee 178 Appendix D Integrating RollMap with Volicon Observer 179 DT OV CIWIOW se sna toe oie tee a NY a it it ade dia Sed 179 D 2 Configuring Shortcut Links 2 0 0 0 0 eee 179 D 3 Setting up the INFORMATION2 Log Field o o o ooooooooo 180 D 4 Setting up the RollMap History Tabs 2 0 00 ees 181 D 5 Working with Volicon Observer u s saana 0c eee ees 181 Appendix E Virtual Units 0 0 0 0 0 cc eee 182 E OVEIVIEWa senesan pae bears rd IE AA O A BBS 182 E 2 TOUblESNOOINO resmi eia ai A a he ee 182 E 2 1 Cannot see virtual unit in User Alarms View 182 E 2 2 Cannot see the virtual header in User Alarms View 182 Appendix F Rules Engine 0 0 ccc ees 183 POV EIVICW oeri aaa o dadas ri aria 183 A es ace Be al tee ence ie a ane ate Dae acne ease ial eee aed 183 F221 ule Editor Seung S aiea iia tate oh a aac Be a tee a SARS 183 Ra Example Rules a 184 o AMMO TM dd ccf penthouse Sette habe sich dor SU de ita le pata oido 184 Pio EXaMple 2 at wham rar sae ed EA a berks sate eae 185 Appendix G RollMap Parameterizati0N o oooooooo 189 G Relative Pals as ds ii di tai A la 189 Issue 6 Rev 1 Page 6 2015 SAM RollMap User Ma
88. Sername and Password must be entered Page 24 2015 SAM RollMap User Manual Configuring RollMap The Users screen displays Users Create new user Figure 18 Create User 2 Click on the Create new user button The Edit User screen displays Edit User Username admin J Password Run authorisation level 250 0 250 Edit authorisation level 250 0 250 User allowed to manage users 0 no auth required Figure 19 Edit User Screen 3 Type a Username and Password 4 Enter a Run authentication level 0 250 the higher the number the higher the access level for running schematics 5 Enter an Edit authentication level 0 250 the higher the number the higher the access for editing none some or all schematics 6 If this user is expected to manage users usually limited to an Administrator check the check box 7 Click OK Issue 6 Rev 1 Page 25 O 2015 SAM RollMap User Manual Issue 6 Rev 1 Table 2 An example of a user access structure using the hierarchical authentication levels Username Access levels Manage users Run 250 Administrator Yes Edit 250 Run 150 Engineer No Edit 150 Run 50 Operator No Edit 50 Table 2 User Access Levels Table 3 An example of how to setup schematics so that they can be read and or written to by some user levels and not others Schematic Name Read Write User access to Schematic Read
89. T_1 BLACK FAIL Black 0 01 40 21 A Hyperion IQHIPOO 1100 16 03 Wed Dec 11 12 14 18 2013 HS 0 01 40 21 Figure 110 History Tab Black OK Finally when the state returns to OK Green because there are no longer any active events the Complimentary Tab displays nothing The History Tab now displays both completed events INPUT_1_BLACK WARN Black Amber and INPUT_1_BLACK FAIL Black Red Table 4 summarizes the above example State Complimentary Tab displays History tab displays OK Green Nothing Nothing WARN Amber INPUT_1_BLACK WARN Black Nothing FAIL Red INPUT_1_BLACK FAIL Black INPUT_1_BLACK WARN Black INPUT_1_BLACK WARN Black OK Green Nothing INPUT_1 _BLACK FAIL Black Table 4 History Tab Displays Page 89 2015 SAM RollMap User Manual Schematic Window 9 Schematic Window 9 1 Description The Schematic window allows you to compose a graphical representation of the system either in its logical or physical layout Special ActiveX objects from a library can be placed on the screen to receive alarm events configured from the System Alarms window An alarm Trigger event is a table entry in the System Alarms list uniquely identified by the unit address and the keyword header column All Trigger entries contain a state and a caption text message associated with it The schematic document contains some simple drawing tools for editing of the schematic The schematic window is an ActiveX container whic
90. The initial state and caption can be set in the General properties The meter object has three basic styles elliptical rectangular bar or digital numeric In elliptical mode the meter can be made to maintain its circular aspect ratio and show its range values in numbers In rectangular mode the meter is represented as a bar meter If the width dimension is greater than its height then the bar is drawn as a horizontal bar meter else a vertical bar meter Page 142 2015 SAM RollMap User Manual Schematic Window Object Properties Alam Triggers Addressing Position Fonts General Value and Ranges Zone Commands Colours Caption State Style Options Black O Elliptical meter Meter value taken from a Wl Circular i Green i State show Ranges O Yellow Rectangular meter Value Field O Red Digital display Decimal Places Figure 197 General Properties The displayed value can be taken from the absolute value as set by its Value or ValueString property or from its general State value In digital display mode the number of decimal points can be set The caption can be split over several lines by using n as a line break Line one nLine two nLine three n 9 8 5 2 Value and Ranges Properties Up to five separate ranges can be set up By default the minimum and maximum danger zones are shown in red the minimum and maximum warning zones are in yellow and the safe zone is shown as green Object Properties
91. To display the current schematic outside of the RollMap window right click and from the menu select Release Window To release a schematic it must be in Run Mode not Design mode To return a window to the main screen right click and from the menu select Restore Window Page 59 2015 SAM RollMap User Manual Configuring RollMap 4 12 5 Edit Released Windows Released windows can only be edited in the main application screen To edit a released window right click and from the menu select Restore Window to Edit The window is placed back into the main application screen and Edit Mode is selected 4 13 Configure Shortcut Links The links menu provides a set of shortcut links that can be configured if desired After configuring the links menu the links menu shown below can be used Address Unit Mame Local Time ID Unit Type Version Unit State Connect to RollCall Panel Load Control Screen Mask Unit Mask Unit Until Green Query State Highlight Frames View Details Page for this unit Highlights View Top level page Select All Crl s Launch RollCall Control to encdosing gateway Copy to Clipboard Ctrl Full Screen Alt Enter Edit Header iM lt 02 IQCBRG 0000 0F 02 State is OK 4 49 Qo 0 Qo 0 0 y aw eta a An Unit Name Unit Ty Window t Unit Address Time Stamp 7 Message 164 10 10DAVM B M IODAVM M 0000 0F 04 Mon Nov 18 11 14 22 2013 INPUT LOST Figure 67 Shortcut Links To add the links option add the
92. access control settings for schematics defining which users may or may not access a particular schematic Set read and write settings in a hierarchical scale to allow the level of user permitted to access the current schematic These settings must be used in conjunction with the user access settings See Manage Users on page 24 Page 95 2015 SAM RollMap User Manual Schematic Window Document Properties General Fonts Grid Settings Background Picture Address Workspace Control Level Authorisation level to run Authorisation level to edit po Figure 122 Authentication Levels Properties 9 2 5 Basic Editing Functions 9 2 5 1 Cut Copy Paste Delete Undo and Redo These are standard editing features Draw items and objects can be selected and copied to other schematics via the clipboard Standard select operators are implemented when in Select mode e Left click to select item e Right click for drop down context menu on item e Shift left click to select deselect of multiple objects e Ctri left click drag for copy of selected item e Ctrl C for copy to clipboard of selected item e Ctrl V for paste from clipboard Del key to delete item e Ctrl Z to undo the last operation e Ctrl Y to redo the last undo 9 2 6 Viewing Item Properties When an item is selected its properties can be edited via the properties box Depending on the item type different property pages display See properties for individual
93. access to the Macro Commands Setup dialog from which new macros can be created and existing macros can be edited Issue 6 Rev 1 Page 35 O 2015 SAM RollMap User Manual Configuring RollMap Actions oy State Trigger Select Macros to be run Emo ny Macro OO GENERIC EMAIL _ CONTROL_PANEL OCReportStylesheet OCReportstylesheetl Open RollMap manual Figure 33 Macro To specify the macro to be run select the corresponding check box More than one macro can be selected To edit the existing macros or to create a new macro click Edit Macros The Macro Commands Setup dialog displays Macro Commands Setup Macro Name Command Line GENERIC_EMAIL ROLLMAP 1SENDMAIL BAT t c a edit_recipient host com edit_smtps CONTROL_PAN CONTROL runonce u a OCReportStylesh DefaultReportxsit OCReportStylesh HyperianVideoReportxslt New Modify Delete Cancel Figure 34 Macro Commands Setup The Macro Commands Setup dialog displays all of the macros that have already been defined e To edit an existing macro select it from the list and then click Modify To create a new macro click New In both cases the Command Macro Setup dialog displays Issue 6 Rev 1 Page 36 2015 SAM RollMap User Manual Configuring RollMap Command Macro Setup Macro Hame Command Line substitute Search Paths Figure 35 Command Macro Setup In the Macro name field enter or modify the nam
94. ails from the menu Details 0000 24 04 04 105DA02 Sort by Header La _ a 2 Figure 78 Viewing Unit Details At the top of the unit details screen is a drop down list allowing the screen information to be sorted Details can be sorted by e Header This is the default sort and is based on the system alarm window order and then alphabetically by name e Keyword Alphabetically by name Issue 6 Rev 1 Page 68 2015 SAM RollMap User Manual System Alarms Window e Data Alphabetically by data e Status Errors are reported first followed by warnings followed by everything else e Mask Masked cells followed by unmasked cells 5 9 Printing The current state of the System Alarms window can be printed 5 9 1 Page Setup Options To change the page setup options e From the File menu select Page Setup The Page Setup for Printing dialog displays Page Setup for Printing Always re size horizontally to fit paper Use black and white only Cancel Figure 79 Page Setup There are two print setup options available in this dialog Always resize horizontally to fit paper configures RollMap to print all headers across a Single page re scaling if necessary If this option is not selected only the fields that fit on the first page using the current font are printed Use black and white only produces a clearer monochrome gray scale output on a black and white printer 5 9 2 Printe
95. all device but multiple log viewers like RollMap can connect to a server RollMap has the facility to generate V1 Simple Network Management Protocol SNMP Trap events These traps are sent to co operating SNMP Managers and can be used as an additional alarm monitoring system RollMap relies on the Microsoft SNMP and SNMP Trap services to be installed on the computer These services are available on the Windows installation media as standard For more information about installing and configuring SNMP for use with RollMap See SNMP Setup for RollMap on page 170 Install RollMap RollMap is installed by means of a Windows installation executable file To install RollMap run the installation executable and follow the on screen instructions When installing on a PC running Windows 7 Vista or Server 2008 it may be necessary to set the User Account Control settings to Never notify This is set from the Windows control panel Setup Type After accepting the Licence agreement and installation directory you will be asked which type of install you would like RollMap InstallShield Wizard Setup Type select the setup type that best suits your needs Where do vou want the configuration stored Per User Local Per User Roaming All Users In application folder for legacy support Back Next gt Cancel Figure 1 Setup Type Per User Local Each user has their own configuration and is stored in their local us
96. am Triggers Addressing Presets Configuration Routing Position Destinations Routing Command Offset po Auto Fill Command Base Offset Fix button name Fix button name Source Value 1 TC Name Command Base Offset Command Bases Source Routing Base lo Destination Protect Base Figure 222 Routing Properties Set Up Source Buttons To set buttons numerically using auto fill al 2 Select the first source button button 1 Set a source value from which the routing should begin either O or 1 depending on the router type being configured Click on the Auto Fill button The Auto Fill screen displays Auto Fill Start Value Increment after button s h na we Increment by Figure 223 Auto Fill 4 oF 6 The source value displays as was set in the source value on the main screen and cannot be edited on this screen Set the Increment after value to define how many buttons are to be set with the current fill attributes Set the Increment by value to determine how much the value increments after each button allocation Click OK All buttons are setup sequentially from the starting source value To use fixed button names 1 2 Issue 6 Rev 1 Check the Fix button name checkbox Either enter text to fix the button name or select the command radio button and enter a command number for a command that will be queried from the unit Page 158 20
97. ap User Manual 9 4 8 2 Latched Error Dismissal Schematic Window Latched errors can be dismissed by right clicking on an item and selecting one of the clear options Prisa Alarma Figure 157 Latching dismissal The following options are available e Clear latched error Removes just this error from the list e Clear all latched errors Fully clears the list e Clear all latched errors for unit Clears the item clicked on plus any other errors for the same unit address 9 4 8 3 Masking In addition to the standard options right clicking an item provides a shortcut to mask mask until green or create a duration based mask You can also open the item details using right click and perform any detailed operations as normal Priority Previous Links gt Full Screen Alt Enter Zoom gt e Scale To Fit Window F10 Window gt Mask Unit Mask Unit Until Time Details Figure 158 Masking 9 4 9 Insert Component we Insert a component into the current schematic Select a component file CPT using the Open dialog box that displays Issue 6 Rev 1 Page 117 2015 SAM RollMap User Manual Schematic Window 9 4 10 Load Control Screen Template From Cache a Add a control screen template into a Schematic to allow for control of a unit Clicking on this icon displays a screen from which to select the control screen template Select the appropriate screen and click Add to insert
98. ap exe replacevariable VAR_NAME Some String VAR_NAME2 Some String2 c testschematic sch Issue 6 Rev 1 Page 169 2015 SAM RollMap User Manual SNMP Setup for RollMap Appendix B SNMP Setup for RollMap Issue 6 Rev 1 B 1 RollMap uses the standard Microsoft SNMP services to generate V1 SNMP trap events This feature can be enabled or disabled from the RollMap menu The computer where RollMap is to be run on must have the SNMP Service and SNMP Trap Service installed and running correctly These services are available in Windows 2000 and XP as standard components For Windows NT4 these may be found on the Service Pack CD SP6 is recommended SAM do not support the operation of SNMP traps on Windows 95 98 or ME The following guide is for setting up the SNMP services in Windows XP For Windows 2000 the procedures are similar but some names of components may vary Please to refer to Microsoft SNMP installation guide for further details Installing SNMP Services for Windows XP Use the Control Panel and select Add or Remove Programs Then select the Add Remove Windows Components option Windows Components Wizard Windows Componente ou can add or remove components of Mindo P To add orremowe e component cick the checkin A shaded bow means hat onk pertot the component ill be installed To sea wheats induded ma campaneri click Details Components g Internet Explorer 0045 Fy inernet r ormation Senioas IE 15
99. arance providing information and adding functionality to the schematic The tools described in this section are e Schematic Link e Status Control e Thumbnail Control e Web Browser Control e Pie Chart Tool e Meter Control Schematic Link Tool lt i The Schematic Link tool provides an active link to another schematic document when the schematic is in Run mode It has similar properties to the rectangle tool but its border color is not set manually the color reflects the overall state of the schematic to which it links For example if all objects in the linked schematic are in the green OK state then the border is colored green otherwise the border is colored yellow or flashing red depending on the most serious error in that schematic Page 103 2015 SAM RollMap User Manual Schematic Window Figure 130 Add Schematic Link In addition to the general properties and font settings a schematic document can be assigned to this object Use the browse button to locate a schematic To enable a set of linked schematics to be moved from one directory or PC to another you should use relative paths rather than absolute paths For example if you enter a file name with no drive or directory this is searched for in the same directory as the parent schematic file Object Properties General Position Fonts Schematic Unit Address State Actions State Pictures Schematic file name Single Click Activation Report Status Enable
100. ary 172 19 39 302050 o k r i pp Secondary 127 0 0 11022050 Primary control connected 172 19 39 30102030 Figure 13 Control Connection Menu e Priority Primary Sets the Primary Connection as the priority connection The application will always attempt to connect to the primary address if a connection can be established e Priority None No priority given to primary or secondary connection Attempts to switch back to the primary address only if the secondary connection is lost e Primary lt ipaddress gt forces the connection to the Primary Connection e Secondary lt ipaddress gt forces the connection to the Secondary Connection Page 19 2015 SAM RollMap User Manual Configuring RollMap 4 1 4 Thumbnail Server Connection The thumbnail server is a Windows service installed as part of the RollMap installation which is used to retrieve thumbnail images from remote units in readiness for use in RollMap A thumbnail service is always available on the loopback address 127 0 0 1 However this location can be changed and if required an additional location added for redundancy RollMap connects to the thumbnail server on port 2064 This can be changed by specifying a different port address for example 127 0 0 1 60000 The thumbnail service must be running on the port specified RollMap requires a connection to a server containing thumbnail images for use within schematics To set the IP address of a
101. ask 5 Individual Header State Any Data Change Open RollMap manual Figure 28 Configuring Alarm Triggers In the Individual State Trigger section specify Whether the alarm is to be applied to All Addresses in the RollCall Network or only to be applied to Specific Addresses lf Specific Addresses is selected select the addresses to which the alarm applies in the network tree below e Whether the alarm should be triggered by the Aggregate State of the units or by the Individual State of units Issue 6 Rev 1 Page 32 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap Aggregate State triggers actions based on the overall state of the selected units If one unit triggers the alarm the alarm condition is considered to apply to all units If a second unit also reaches an alarm state a new alarm is not triggered Individual State triggers actions based on the individual state of the selected units If one unit triggers an alarm and then a subsequent unit reaches an alarm state A separate alarm is raised for each unit The States that trigger the alarm Green Yellow Red alarm triggers on any selected state When the states make a transition from one color to another if both of the states are selected as triggers it is still treated as a single event For example if Yellow and Red are both selected as the state triggers when a Yellow warning condition arises the alarm is triggered if the state t
102. ask Header Action ny UnMask Header All Addresses 0 Specific Addresses Mask for Period of Time Duration Days Hours Minutes Seconds Open RollMap manual Figure 46 Unmask Header In this window select from the tree which headers of which units are to be unmasked By right clicking on the Mask Header Unit action in the actions tree you can use Reflect Action to convert a UnMask Header Action into an Mask Header Unit action Login The Login action provides a means of user access to a schematic When in run mode a username and password must be entered to gain access There are no extra parameters available with this action Logout The Logout action provides a means of logging out of the current schematic thus requiring a login operation to regain access There are no extra parameters available with this action Lock Provides a means of locking the panel in run mode so that it is in a read only state There are no extra parameters available with this action Unlock This action deactivates a previously locked panel There are no extra parameters available with this action Page 45 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap Toggle Lock Combines the panel lock and unlock function into a single action If this action is active the panel remains unlocked Deactivating the action locks the panel There are no extra parameters available with this action QC Report
103. aste Paste a previously cut or copied component to the current schematic Print 33 Print the current User Alarm Screen Schematic or component Back One Level Forward One Level 3 Selects the previous or next schematic The order of selection is the same as the order in which the schematics were opened Home Schematic 2 Displays the home schematic as set up in the Configuration menu Any previous schematic is still available but the home schematic becomes the currently active schematic Edit Schematic Ki This button toggles between edit mode and run mode Page 12 2015 SAM RollMap User Manual 3 2 11 3 2 12 3 2 13 3 2 14 General Operation Login EX By creating different log in templates it is possible to provide restrictions on parts of the system for certain users For example an administrator will have system wide access whereas different users may only have access to specified parts of the system See Manage Users on page 24 Lock Unlock Views a With a schematic running it is possible to lock the screen to protect against accidental changes to the system Click the Lock icon to lock the current schematic Click the icon again to unlock It is also possible to trigger this option from a button placed on a schematic using alarm actions Log Logic x Enables Log Logic to be added edited See Log Field Logic on page 65 Cascade Displays all non minimized templ
104. atched separated by semi colons The virtual unit and log field header that the result is sent to can also be configured If no specific Log Header is given the OID is used Mask Unit This action masks a specified selection of unit s with the option of only masking until they become green Page 41 2015 SAM RollMap User Manual Configuring RollMap Actions State Trigger 2 Mask Unit f L e Network 1000 a _ 9 Network 1100 a Network 1111 i P Network 11F0 at a Network 1200 oO at a Network 1300 A Network 1333 h C 1 matarte anna Mask Until Green Mask for Period of Time Minutes Open RollMap manual Figure 42 Mask Unit In this window select from the tree which unit are to be masked there is also the option to mask until green By right clicking on the Mask Unit action in the actions tree you can use Reflect Action to convert a Mask Unit Action into an UnMask Unit action Add Trigger Add Action Delete Copy Action Reflect Action Ordering Figure 43 Actions Reflect Action Issue 6 Rev 1 Page 42 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap Unmask Unit This action unmasks a specified selection of unit s with the option of only masking until they become green Actions E oe State Trigger Units to Mask UnMask A UnMask Unit 2179 Network oo m Network 01 al C a Network 1000 e 4 Network 1100 e 4 Netwo
105. ate occurs e Toolbars The main toolbars are very similar to a standard Windows type toolbar with some of the more familiar file and view options See Main Toolbars on page 12 Other Toolbars are explained in each relevant section according to the Window with which they are associated Issue 6 Rev 1 Page 11 2015 SAM RollMap User Manual Issue 6 Rev 1 3 2 3 2 1 3 2 2 3 2 3 3 2 4 3 2 5 3 2 6 3 2 7 3 2 8 3 2 9 3 2 10 General Operation Status Bar The Status Bar displays some information about the current state of RollMap and provides quick access to the Control Connection redundancy controls Menus A set of menus display at the top of the screen The majority of these menus are similar to standard Windows type menus and need no further explanation here The Configuration menu provides shortcuts to some of the features available in the various Windows See Configuring RollMap on page 18 Right clicking in a window displays a further menu related to that window Main Toolbars The main toolbars immediately below the menu have the following tools available New Start a new User Alarm Screen Schematic or Component file Open wa Open an existing User Alarm Screen Schematic or Component file Save 4 Save the current User Alarm Screen Schematic or component to a Component file Cut y Cut a component from a schematic Copy Copy a component from a schematic P
106. ates as a cascade This is the default setting Figure 4 Cascade 3 2 15 Tile Horizontally Issue 6 Rev 1 Displays all non minimized templates in a horizontal tile m a a EH Schemati f SY 5 Figure 5 Tile Horizontally Page 13 2015 SAM RollMap User Manual 3 2 16 3 2 17 3 2 18 3 2 19 3 2 20 3 2 21 Issue 6 Rev 1 General Operation Tile Vertically _ Displays all non minimized templates in a vertical tile m Schematicl ieee EA Schematic2 ol lt fy Schematic3 0 xX Figure 6 Tile Vertically Minimize Un Minimize P A Minimize minimizes all opened templates Un Minimize restores all opened templates Zoom PP sate tort yo Click on the or icons to increase or decrease the zoom factor on the current schematic or select a specific zoom factor from the drop down list Scale to Fit Window With this button selected the schematic scales to fit within its window If the window size is subsequently changed the schematic dynamically scales to fit at the maximum possible size within the window Fullscreen This button which switches the current schematic or alarms window to fullscreen mode In fullscreen mode the full window is occupied and the toolbars Network Browser and Connected Units are hidden To return to normal mode select Exit full screen mode from the on screen menu Alternatively use the keyboard shortcut Al
107. ation gt Columns Issue 6 Rev 1 Page 84 O 2015 SAM RollMap User Manual History Tabs OM columns Unit Name Unit Name Unit Type Unit Type Unit Address Unit Address Time Stamp Time Stam Message Duration Duration Sort All Local Time Timecode COMPARE PID _HOUSE_ID Version Unit State Information Delete Move Up Sort Selected CELLMASKS IP Address IP Mame Up time PSU 1 Name PSU 1 State PSU 2 Name PSU 2 State Temp 1 Name Cancel Figure 103 Columns In the Columns window the list on the left shows the columns that are available and the list on the right shows the columns to be displayed To move a column to the right select it on the left and click the button The columns at the top of the displayed columns list display on the left of the tab and the columns at the bottom of the list display on the right of the tab To move a column up or down in the list select it and then click either Move Up or Move Down as required Certain columns can be displayed specifically on error or on the clearance of an error To specify this criterion select the column in the display list and in the mode section click On Error or On Cleared as required Click Ok to save changes and close the window or click Cancel to close the window without save In the log files the column headings are not displayed The order in which the default columns are shown in the files are as follows Current Status Column1 Unit Name
108. automatically update any time that the referenced log field value changes Command line paths and parameters executed by RollMap for example the subject or body of an email being sent via the command line blat tool The live value is used each time the command is executed whether this is triggered interactively a configured button press or automatically in response to a configured status condition Note that updating of the log field value does not necessarily cause the command to be executed again this is determined by the configuration of the command trigger e Paths to displayed images These automatically update with corresponding image redraws any time that the referenced log field value changes e Address specification For example 1234 56 78 NAME takes the NAME log field from the unit address 1234 56 78 Deferred addressing may also be used by replacing numerals with where required See Deferred Addressing on page 176 Q What string parameters do NOT support dynamic logfield processing A Path references to schematic or component file links RollMap s structure requires the link structure to be known and fixed from the point the application starts up This allows status propagation to work correctly Undefined behavior results from attempting to use dynamic log field values within schematic links or embedded component links logfield codes are intended to be case INsensitive so psu_1_state should work th
109. bjects Select Insert User Component from the menu or the Component button from the toolbar Open x a _ _ _ ____ UY r RollMap LibraryV3 Snell and Wilcox Generic Components gt v gt Search Generic Components p Organize v New folder jz v Fill e a ES Name f Date modified Type Size a E Desktop di cvs 19 09 2012 13 56 File folder JB Downloads e Devices 19 09 2012 13 56 File folder 1 Recent Places E Audio AES Status LED small cpt 08 11 2007 13 10 CPT File 28 KB E Audio AES Status LED cpt 08 11 2007 13 10 CPT File 28 KB A Libraries El Audio AES 8 Status LED cpt 08 11 2007 13 10 CPT File 5 KB Documents Audio All Status LED small cpt 08 11 2007 13 10 CPT File 6 KB al Music El Audio All Status LED cpt 0 007 13 10 PT File 6 KE Pictures E Audio Analogue Left Status LED small cpt 0 2007 PT File KB Videos Audio Analogue Left Status LED cpt 0 2007 PT File KB Audio Analogue Right Status LED small cpt 08 11 2007 13 10 PT File KB Computer E Audio Analogue Right Status LED cpt 0 2007 PT File KB iw OSDisk C Audio Analogue Status LED small cpt 0 2007 CPT File 5 KB E SD Disk E Audio Analogue Status LED cpt 08 11 2007 13 10 CPT File 5 KB GP StuartCheer sr Audio Emb Status LED small cpt 08 11 2007 13 10 CPT File 5 KB g root snellwilcc E Audio Emb Status LED cpt 08 11 2007 13 10 CPT File 28 KB Control and Mor Y Network Status Link cpt 08 11 2007 13 10 CPT File 5 KB M
110. cally display a different picture when the rule evaluates to true based on current log data To enable this option check the enable rule driven picture checkbox and enter the picture and rule in the boxes provided The rule and picture can also be edited from the Picture properties tab External Properties This object exposes many properties Only the ones listed below should be used as alarm trigger properties Properties read and write variables External Name Valid Values Type State VT_12 16 bit integer O Black 1 Green 2 Yellow 3 Red Caption VT_BSTR text string null terminated string c field UserString VT_BTSR text string r substitution field Table 6 External Properties Page 132 2015 SAM RollMap User Manual Schematic Window 9 8 2 6 Common uses for the General Button Invoking the RollCall Control Panel Object Properties Fonts Alarm Triggers Addressing General Picture Button Style Position Command line Command Actors Figure 181 General Button Setup 1 On the General tab click Command Actions button 2 Adda Button Press trigger with a Command Line action 3 Inthe Command Line enter ROLLCALL RollCall EXE u a Where the search path macro ROLLCALL is set to C RollCall when using 16 bit application or C Program Files SAM RollCallSuite 32 bit application or C Program Files x86 SAM RollCallSuite when using Windows 7 The a field and the ROLLCAL
111. ch is now taken from UNIT ADDRESS at runtime Me Wee Corfigvet Wrd w b aa bit L 290493 SN AOA P OR Wwe Phyical Network tek a r po bos ate for NAME UNIT_ADORESS Sta Nerot 1100 L 9 0 UNIT ADDRESS Figure 10 Changing the address when including the component in a schematic Issue 6 Rev 1 Page 196 2015 SAM RollMap User Manual Issue 6 Rev 1 RollMap Parameterization 3 Include the component into any schematics as many times as required The example above includes the component twice Override the component variables as required with the real address ie di Wee Conbgua on Winda Pei Y bd gt 7 Eu as paan A Pa PE px mor Theme 5 Pryaical Hetarik tl A Pietro 10001 Pirtek 11001 Lar Meteprk re E Figure 11 The component in run mode pulls the data from multiple different units Now when running the schematic the objects are correctly wired up to 4 different unit addresses Alarm Triggers Addressing Position General Commands Address Methods Properties for State UNIT_ADDRESS Trigger INPUT_1_EMBED AUDIO 1 1 LEVEL gt P Caption Trigger List UNIT ADDRESS N UP INPUT 1 EMBED AUDIO 1 1 LEVEL C Hide on Green C Hide on Not Set A Hide on Cyan A Hide on Waming A Hide on Magenta Hide on Error Figure 12 Specifying the variable address in the trigger list It is possible to specify the unit ad
112. chematic In a similar way that search paths can be used to centralise the location of file path parameters variables can be used to centralise the location of other inputs for example captions IP address stream URLS etc They provide a degree of adaptability to schematics and components as these can be built using variables as placeholders which can simply be updated as required in a single location without requiring each and every schematic component to be edited separately Variables can be defined at three levels e Global level Configuration gt Variables menu Mitre Dalew Wao VARLABLE AME o inchada the walien into schematic obpecis Qk ancel Figure 1 Global variable definitions e Schematic level Schematic properties dialog box e Component level Component properties dialog box General Fonts Grid Settings Background Picture Address Workspace Control Level Authorisation Levels Variables Name Value IP MASTER_IP New Delete Use VARIABLE_NAME to include the value into schematic objects Figure 2 Schematic Component Variable definitions This forms a hierarchy with global variables at the top During variable resolution if the variable can not be found at the current level the level above is checked This allows a default value to be defined globally and then redefined within schematics or componenis at a later time Page 193 2015 SAM RollMap User Manual
113. cipients when the alarm trigger occurs Before emails can be sent as alarm actions at least one email profile must be configured See Configure Email Messages on page 53 Actions Command Line Send To Po Message lt Property Substitutions Soa Address NM Net U Unit P Port oi State 0 3 Ss State Black Green Yellow Red Sp ExecutablePath c CauseString Sot CauseHeader r UserString 5 ej Masked State 0 3 FHEADER value of a log field header Other wH hide command execution Date Time Sy yyy year as 4 digit 25 MM9 month as 2 digit s6sdd day as 2 digit ddd short day name dddd long day name 25 MMM36 short month name MMMM 6 long month name Sor vo time zone 06H 24 hour vom Yo minute 65 second Open RollMap manual Figure 39 Send Message To configure a Send Message action e Inthe Send To field specify a recipient e Inthe Message text box create the message body You can include any log field header into this email message and RollMap inserts the correct data For example To receive an email that says the following Unit Hyperion 1 Type IQSDA0O2 at Address 1100 10 01 has triggered an alarm at Time 15 13 56 19 November 2015 You would insert the following into the Message section Page 39 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap Unit NAME Type IDNAME at Address ADDRESS has triggered an alarm at Time TIME
114. cons on the toolbar which can be used to show and hide elements in Network Tree View E Expands all units and other sub components in the network tree Collapses all components in the network tree Ta Expands the selected unit only Collapses the selected unit only 6 2 Auto Discovery Auto discovery mode can be enabled from the configuration menu and Auto Discovery Active displays on the status bar when it is operational When active auto discovery automatically adds new cards frames networks devices to the current list without In combination with Filtered groups there is the possibility to instantly monitor new network items as soon as they are added to the network The expected usage of this mode is first manually add all the units to the unit list Then activate Auto discovery Mode Auto discovery mode is disabled if you change the unit list manually and on startup of RollMap Issue 6 Rev 1 Page 76 2015 SAM RollMap User Manual Network Tree 6 3 Load Control Screen Control screens from active units can be cached for use in schematics e Right click on a unit in the network tree window and select Load Control Screen The control screen is cached and can be selected from within a schematic See Load Control Screen Template From Cache on page 118 Issue 6 Rev 1 Page 77 2015 SAM RollMap User Manual User Tree 7 User Tree 7 1 Description The User Tree window is used to build custom tree views of n
115. ct Properties e Right click on the line and from the menu that displays select Properties e Double click on the line Click on the General tab to specify options such as the line s weight border and color Click Line border colors to display a color selection dialog from which the line s color can be selected Click the Position tab to specify the line s position and size Page 98 2015 SAM RollMap User Manual Issue 6 Rev 1 9 3 3 9 3 4 9 3 5 9 3 6 9 3 7 Schematic Window Rectangle Tool Use the rectangle tool to draw a simple rectangle After selection place cursor over window and click and hold the left mouse button and then drag across window Release left mouse button to draw the rectangle To edit the rectangle s properties do one of the following e Click on the rectangle and from the Edit menu select Properties e Right click on the rectangle and from the menu that displays select Properties e Double click on the rectangle Settings for its caption border width border color transparency fill color and position are available The background colors options has no effect Holding down shift while drawing allows an even sided square to be drawn This works for round rectangle ellipse text box picture schematic link and status control Round Rectangle Tool Select and place as rectangle tool Adjust the radius of the corners by clicking on the top right hand marker and then drag
116. ctions on page 35 4 8 3 Add an Alarm Trigger To add an alarm trigger right click in the actions list and from the menu that displays select one of the following Add Trigger gt State Trigger e Add Trigger gt Logserver Lost Trigger e Add Trigger gt Auto Actions x AA serio Add Action Logserver Lost Trigger Control Connection OK Trigger Control Connection Warning Trigger Control Connection Lost Trigger Auto Time Based Trigger Ordering b Duplicate Trigger Add Delete Open RollMap manual Close Figure 26 Alarm Triggers Alternatively click the Add button and from the list that displays select an alarm trigger Issue 6 Rev 1 Page 31 2015 SAM RollMap User Manual Configuring RollMap TRIGGER Logserver Lost Trigger TRIGGER Control Connection OK Trigger TRIGGER Control Connection Warning Trigger TRIGGER Control Connection Lost Trigger TRIGGER Auto TRIGGER Time Based Trigger Figure 27 Add Trigger 4 8 4 Configure Alarm Triggers The Logserver Lost Trigger requires no configuration however the State Trigger has several configuration options Actions 3 wg State Trigger Individual State Trigger 6 All Addresses l J Aggregate Unit States C Specific Addresses 6 Individual Unit States feel E w gt m H 00000 ao NS La it 5 Headers Bag 0 All Headers lnea eror j O Spedfic Headers 805 Mone 9 Aggregate Header State Ignore M
117. d Headers 2 2 ce eee eens 65 5 7 Logi Feld OO Criss o Sie arnt E A RR R E 65 5 9 View Unit Details 200 visa idos te oe oe A dd bets 68 DOPNING os cheatsheets A A A weil diese a E Meath tn GiB 69 5 9 1 Page Setup Options v a5 Yaw es WR 2 ai is Wale Fe Reo ha BONO da 69 5 9 2 Printer Setup Options 0 0 cc ees 69 B93 MIM PreVICW cs ots ea ae ene a eee ee ote ee em Oe 69 E A A Stak amp ROL Ges oate aaa a e att ar ee fa eevee ena 69 DOU SER AIIM ip du sheets E aid ne alae ia 70 5 10 1 Set up an Alarm Document 0000 eee 70 D TOZ UNE oale ec O 70 5 10 3 Mask Unmask Units 0 0 0 0 0 ccc eens 71 5 10 4 Set Viewing Mask 0 ccc cee eee ees 71 5 10 5 MOVE Faulty UNIS e sti Go wince ay ecw a e Pn kw eR ae eat a 71 OO NCW Alani ciar dct ana as ard ae octet or ea meee ee wae 72 5 10 7 Hide the Mask Window 0 0 cece ees 72 Issue 6 Rev 1 Page 4 2015 SAM RollMap User Manual Contents 5 10 8 Print the User Alarm window 000 e cece ee ee eee 72 5 11 Configure Headers 0 cc eee eee ees 73 De PT Selec GOINGS ens i aid Si Med 73 5 11 2 Deselect Columns After Pin 0 es 74 DOE dil HCA dE ow act sais Su ae Sew eee 74 5 11 4 Create All Headers 0 0 0 cc eee 74 5 11 5 Sort Headers By Name 0 ees 74 5 11 6 Delete Unused Headers 0 0 0 eee 74 STREFA Header FOSON 0 20 sire rr dial e ANE aes E 74 5 11 8 Auto arrange Column Widths
118. d words from the column and does not display in any state Multiple word match can be separated with a semicolon character wild card matching can be assigned using the asterisk character and the EMPTY keyword can be used to match a blank string If no keywords are matched to generate any specific state the state is assigned the Default State If the checkbox Show only on warning or failure is selected only items that are either in Warning or Failure state display If the column header contains numerical values such as temperature the state can be set by entering a set of number ranges as a Number Field To skip a band enter the same values for its range In the example shown in Figure 16 e Values below 10 generate an error condition e Values between 10 and 20 generate a warning e Values between 20 and 30 are considered good e Values between 30 and 40 generate a warning e Values greater than 40 generate an error condition cHumber Field Error YWarmning Good Warning Error 10 lo o Figure 16 Number Field The column header positions can be changed from this setup dialog box by entering the new column number into the Column Number field Alternatively the header can be selected and then dragged to its new position using the mouse The Enable SNMP Trap on change checkbox enables and disables SNMP traps for this header This allows only specific events of interest to generat
119. dds a box that displays status messages from a unit on the network specified by the address property Error conditions Warnings and Informational messages are displayed Messages can be copied from the Schematic window when in run mode and the messages history can be manually cleared The object has two configuration modes e Simple Mode in which only basic information is displayed e Custom Mode in which any or all available headers can be displayed by the control Page 106 2015 SAM RollMap User Manual Schematic Window Figure 135 Add Status Control To configure the object s operational mode open the Object Properties dialog and click the Mode tab Object Properties Position Custom Mode Headers Sewer Time Message E 20 11 13 15 38 07 HEADER VALUE A 20 11 13 15 38 06 HEADER WALUE G 20 11 1315 38 05 HEADER WALUE Figure 136 Mode Properties To display only basic information Severity Time and Message select Simple Mode Alternatively to specify the headers to be displayed by the control select Custom Mode and then click Headers A new dialog opens in which you can select the headers to be included OR columns Address Addre ai Unit Name Move Up Local Time Local Time COMPARE PID HOUSE ID ID Move Down Unit Type Unit Type Version Unit State Information CELLMASES IP Address IP Name Version Unit State Information CELLMASKS IP Address IP Name Sort All Sort Selected Delete
120. dress Used to define a new virtual unit that is used to store the aggregate result from the rule Show all contents of frames Frames displayed in the filtered group also display the cards within the frames F 2 1 Rule Editor Settings Show cards in their frames Cards displayed in the filtered group display the frame they belong to Compiled RPN A read only information field that reads from right to left and is used to help with debugging a rule For example it may help indicate if brackets are required around parts of the rule Issue 6 Rev 1 Page 183 2015 SAM RollMap User Manual Rules Engine F 3 Example Rules F 3 1 Example 1 The following example creates a rule that matches any unit that has the INFORMATIONZ2 field as either Channel 01 or Channel 02 Rule Editor x Name Channel 1 2 Virtual unit address xxxx xx xx V Show all contents of frames 4 Show cards in their frames Rule A v Compiled RPN Clear Rule r Rule Builder y Join Header Operator Value OR ADDRESS a String Numbe A amp AND AES multiple character wildcard AFD_CONFLICT lt i y ANALOG_1L lt single character wildcard ANALOG_1R gt Note Enclose strings in quotes ANALOG _2L aa Date Time a ANALOG _2R Date Time 26 11 201 AUDIO E z m AUDIO_A_LEFT 3 00 1 z AUDIO_A_RIGHT v Sine Jera kiz OK
121. dress directly in the trigger list as shown above Page 197 2015 SAM
122. e SNMP traps Create All Headers searches the header list and automatically creates a column for each header found 4 2 2 Special Keyword Headers Keyword Description The alarm list should always contain the column ADDRESS This is the only eee true identifying reference to a unit on the network INFO All other header keywords in the current status file that are not assigned to a column are shown in the INFO column This column is always present and cannot be deleted Note that this column contains the full display of HEADER VALUE so the warning and failure keywords must also contain the header keyword and its value Note that by default there are several failure keyword conditions separated by semicolon and that the TIME keyword is excluded from this column Uses UCT instead MSG Messages for this keyword header can be generated by the unit or artificially by the LogServer program It is normally used to show presence on the network of a device If a unit responds to a polling request by LogServer then the message MSG Unit present is generated otherwise MSG Unit lost is generated Table 1 Special Keyword Headers Issue 6 Rev 1 Page 22 2015 SAM RollMap User Manual Issue 6 Rev 1 Table 1 Keyword Configuring RollMap Description TIME UCT The LogServer program generates two time keywords for each unit in the current status file The first is TIME This is the ASCII version of the time at which the eve
123. e of the macro and in the Command Line field enter the macro command to be run The Substitute Search Paths option replaces the path to the macro with the pre defined RollMap search path if the macro resides in a directory for which a RollMap search path has been defined e Play Sound This action plays a specified WAV file when the alarm trigger occurs Actions Play Sound Property Substitutions a Address M Net U Unit 9 P Port 4i State 0 3 s State Black Green Yelow Red Sp ExecutablePath c CauseString ot CauseHeader 5 Repeat Every seconds Open RollMap manual Figure 36 Play Sound In the text field type the path to the wav file to be played or click the button to browse for the file e Select Repeat and specify an interval at which the sound is played for the duration of the alarm condition e Send RollTrack This action sends a specified RollTrack command when the alarm trigger occurs Issue 6 Rev 1 Page 37 2015 SAM RollMap User Manual Configuring RollMap Actions E State Trigger Rolltrack I ny Send RollTrack REEE RERE NIN Control Defer Net Delay ms Defer Unit _ at Defer Port Every seconds Data Open RollMap manual Figure 37 Send RollTrack e Get RollTrack This action gets a specified Rolllrack command when the alarm trigger occurs The way that the action is handled depends on the configuration of this screen Actions E ng State
124. e printed with a using the menus below Print To print the contents of the Schematic window from the File menu select Print Print Preview To view a preview of the print job before printing from the File menu select Print Preview This displays the exact layout of the page to be printed Printer Setup To change the printer setup options from the File menu select Print Setup The standard printer setup dialog for your printer displays The options that can be specified here depend on the printer Page 97 2015 SAM RollMap User Manual 9 3 9 3 1 9 3 2 Issue 6 Rev 1 Schematic Window Basic Drawing Tools The Schematics window includes the following basic drawing tools e Select Tool e Line e Rectangle e Round Rectangle e Ellipse e Polygon e Text e Picture To access the drawing tools do one of the following From the Edit menu select Drawing Objects and select the tool e Click the desired tool s icon in the Schematic Edit toolbar Select Tool l The Select tool allows the selection of items Multiple selections are allowed and items can be moved copied and deleted Line Tool A a Use the Line tool to draw a simple line After selection place cursor over window and click and hold the left mouse button and then drag across window Release left mouse button to draw the line To edit the line s properties do one of the following e Click on the line and from the Edit menu sele
125. e same as PSU_1_STATE Dynamic Data Insertion The following codes can be entered in RollMap strings and are replaced dynamically at run time with the live values and also trigger redraws when the value changes These are used in the same string parameters explained above for logfields with the same exclusions sch and cpt paths Example Output Code Meaning Value From Code a Full RollCall address of current unit in NNNN UU PP form 0000210203 N RollCall address route of current unit in NNNN form 0000 U RollCall unit address hex switch of current unit in UU form 10 P RollCall port address slot number of current unit in PP form 03 C Program Files x86 SAM Rol1Map Directory containing RollMap exe in long format see below for Puse within ActiveX objects Cause RollMap to hide the executed program empty string returned for this code Table 1 String Fields Codes H Page 191 2015 SAM RollMap User Manual RollMap Parameterization Example Output Code Meaning Value From Code ao Literal percent character escaping the normal code handling Table 1 String Fields Codes Codes applicable to most string fields within RollMap Example Output E reannag Value From Code opi Numerical state assigned to this object O Black including i Masked 1 Green 2 Yellow 3 Red opi Numerical state assigned to this object ignoring any masking i 0 Black 1 Gr
126. e visit the SAM web site and navigate to Support Contact Support www s a m com support contact support Customers with a support contract should call their personalized number which can be found in their contract and be ready to provide their contract number and details Issue 6 Rev 1 Page 2 2015 SAM RollMap User Manual Contents Issue 6 Rev 1 Contents Information and Notices sexies a an 2 Copyright and Disclaimer 0 0 0 eee eee ees 2 Contact Detail Sica hoch atid eg dau iaa eee ote ea eee 2 1 INIFOGUCHION cdo esse ees Bo eee te a ee ech ee ors Meee eae 8 1 1 RollMap Versions ceci Sas ede Bye Real Paw dre had we Ge gh eke ha Go a 8 2 INSTAN AMON lt a ieee bebe Soe as CSE IA She eae ee 9 2T bal 21210 0 Sy Co eae aia a as a aa dao id 9 2 2 Stal OIM area yes ae ee av oh a Bote AE AAN ote SD eh 9 2 2 VOUM Iy E criadas idad id 9 2 2 2 Editing Monitoring Workstation 0 00 eee 10 3 General Operation 0 0 0 0 00 eee ee eens 11 3 1 Screen GOmpoOnents lt 2 2 4 araa a A A AAA 11 322 MAN TOOIDANS ptm er risa a a le ae 12 Se INSW 1 a a a das 12 de 2 ODEN Suda Ss e ad a e 12 2 O IV ia a ds e A he 12 S24 CULL sua rea AS AS AGG ES 12 O 432 3 ee 2c ee ie ee oe ee ee ae ee ee ee BS 12 ERA A A ney ds aa alerting Reenter mend itunes E al eg E nian gra eae aha 12 IAr ca Ce OE ee ee R E 12 3 2 8 Back One Level Forward One Level 0 0 0 ccc eee eee ees 12 3 2 9 OMe SCHEMANC a ol Ae di
127. ect the Address and Log Header of the Input PID x Output Log Field Address Log Header COMPARE_PID_HOUSE_ID 0000 24 04 COMPARE_PID_HOUSE_ID v INPUT_1_PID_HOUSE_ID Input 1 PID House Remove Data when any log data are NOT EQUAL Advanced Query A r Summation Logic O Use Summation Logic Decimal Values v a Hexadecimal Values Edit Rule L Alarm Actions Create State Trigger r Comparison Logic Use Comparison Logic Data when all log data are EQUAL Alarm Actions Delete Figure 75 Example Screen 2 Cancel 4 Log Data Logic Input Lag Fields 0000 24 04 04 SDA02 0000 24 04 04 1QSDA02 Simple Query Address Log Header 0000 24 04 04 1Q SDA02 gt OUTPUT_1_PID_HOUSE_ID Out gt Add INPUT_1_PID_HOUSE_ID Input 1 PID House OUTPUT 1 _PID_HOUSE ID Output 1 PID H Select the Address and Log Header of the Output PID then click Add x Output Log Field Address Log Header COMPARE_PID_HOUSE_ID 0000 24 04 COMPARE_PID_HOUSE_ID r Comparison Logic Use Comparison Logic Data when all log data are EQUAL Remove Data when any log data are NOT EQUAL Advanced Query A y r Summation Logic O Use Summation Logic cimal lue v rAlarm Actions sama Create State Trigger Alarm Actions mn Delete OK Cancel Figure 76 Example
128. ed Cancel Figure 21 Authentication Required An Administrator Username and Password must be entered to delete a user 2 Enter a Username and password and click OK The Users screen displays 3 Select the user to delete and click the Delete selected button 4 5 RollMap Client Logging This feature sends RollMap system information to the Logserver where it is treated as a unit So by creating a new unit the system details can be viewed in RollMap added to schematics or viewed by other RollMap clients on the same Logserver To setup the new unit 1 Enable the RollMap Client Logging by checking the checkbox 2 Enter a unique name for the unit 3 Enter a RollMap address 4 Click OK RollMap Logging Setup Enable RollMap Lagging RallMap Unit Name PM COMPUTERNAME s Max 20 Note Use COMPUTERNAME s to replace with computer name Rallkdap Unit Address Reset the Log counters Reset Figure 22 RollMap Client Logging Once the RollMap Client Logging has been enabled add the new address via the Unit List dialog Details of the unit can then be displayed in the normal way Issue 6 Rev 1 Page 27 O 2015 SAM RollMap User Manual Issue 6 Rev 1 4 6 4 7 Configuring RollMap To view the Client Logging details e Right click on the device in the network tree and select Details from the menu 5 Details 1100 10 01 Hyperion 5 Sort by Header Keyword Figure 23 Client L
129. een 2 Yellow 3 Red s Textual state assigned to this object Green v Textual state assigned to this object ignoring any masking Green Observed behavior current value of caption property of object pis is a C Documented feature in manual Cause string For example Pwtton label contents of log field that produced the state of this object ne ont Cause header For example name of log field that produced EE TT the state of this object ofr Value of UserString property which can be written to via alarm an O triggers C PROGRA 2 op Directory containing RollMap exe in 8 3 format SAM Rol1Map Table 2 ActiveX Components Codes Codes only applicable to string fields within embedded ActiveX components within RollMap schematics and components V and j appear to be triggered only by the overall unit state whereas s and i takes the specified cell state RollMap treats these codes in a case SENSITIVE manner so P is not the same as p for example Different fields are used within RollMap time field definitions Issue 6 Rev 1 Page 192 2015 SAM RollMap User Manual RollMap Parameterization G 6 Variables Issue 6 Rev 1 Everywhere in RollMap that string parameters are entered variables can be included using the syntax VARIABLE NAME which is replaced dynamically at run time with the current value of this variable This feature can be used to create generic components which can be customized when placed inside a s
130. eir frames Join Header OR ADDRESS amp AND AES iil gt AFD_CONFLICT ANALOG_1L ANALOG_1R ANALOG_2L ANALOG _2R AUDIO AUDIO_A_LEFT AUDIO_A_RIGHT v multiple character wildcard single character wildcard Note Endose strings in quotes iD i Figure 96 New Rule Screen 5 Select INFORMATION1 from the header list select the Equal to operator and enter Channel 1 in the String Number field Rule Editor Name Channel 1 2 Rule Virtual unit address XXXX XX XX Compiled RPN INFORMATION 1 Channeli INFORMATION2 Channel2 Clear Rule Z Show all contents of frames Show cards in their frames v Rule Builder Join Header Operator Value OR F z 9 String Number Channel 1 amp AND l E lt AIR INFORMATION2 lt single character wildcard INPUT 2 Note Endose strings in quotes gt S IO INCA ISOC SIE gt Oia INPUT_1_ BLACK a INPUT_1_BLACKISH INPUT_1_C_BIT_DEPTH Insert S OK Cancel Figure 97 New Rule Part 6 Click Insert The expression is added to the rule 7 Select the OR join operator select INFORMATION2 from the header list and change the String Number field to Channel 2 8 Click Insert Page 80 2015 SAM RollMap User Manual User Tree Name Channel 1 2 Vi
131. em sends a message even if more may be coming Max Messages specifies the maximum number of messages that the system queues before sending Page 55 2015 SAM RollMap User Manual Configuring RollMap e Click the Contents button to open the Message Text window in which the email subject line header text and footer text can be specified Message Text Single Message Subject Message Header Message Footer Multiple Message Subject First line of message i Custom Figure 62 Message Text Window After completing this configuration email alarm actions can be set up 4 10 Specify the Location of the Home Schematic To specify the location of the Home Schematic e From the Configuration menu select Home Schematic This function sets up the Home Schematic command path Once you have built a schematic it can be saved and the command path entered into the Home Schematic parameter as shown in Figure 63 Home Schematic Setup Home Schematic PROJECTE Schematics Top Level schl Figure 63 Home Schematic Setup The Home Schematic can then be recalled by pressing the Home button in the toolbar Issue 6 Rev 1 Page 56 2015 SAM RollMap User Manual Configuring RollMap 4 11 Set up Search Paths RollMap can use search path macros to locate the full path name of a file To access the Search Path Setup dialog From the Configuration menu select Search Paths gt Edit C Search Path Setup Variable Na
132. ently the rest of RollMap In order for Control Objects to function correctly it is essential that the Control Connection IP address presents the same view of the RollCall network as the IP address to which the Log Server is pointing not the IP address of the Log Server itself If for example all units show a red border at runtime it is highly likely that the IP address of the Control Connection is down or on a different segment of the network from the IP address used for the logging connection Control Objects may have deferred addresses assigned These deferred addresses can be assigned at this level or left so that it is assigned by the next level schematic document When a Control Object is added to a schematic the schematic records the command numbers and menu lines required to operate the controls however the schematic does not record the type of unit unitID that the controls came from If the actual unit present at runtime is of a different type or command set version the Control Object will not function correctly This problem will likely result in a flashing red border around all controls for the unit but in some cases the object may appear to function correctly while adjusting other settings Therefore extreme caution must be exercised when including Control Objects in components and schematics It is highly recommended that Control Objects are only used with the actual unit from which the controls were taken See
133. ents Give the profile a unique name e Click Add and in the window that displays enter the name of a recipient Then select the transport type which was set up in the previous section and click OK If required multiple email addresses can be added at this stage Add Recipient Figure 61 Add Recipient The Options sections at the bottom of the window specify whether emails should be sent immediately or joined into larger messages If you choose to join messages RollMap waits for a specified period to see if any subsequent alarms follow If this does occur the details of both alarms are sent in one message A scenario in which this is useful would be if a modular frame was turned off If messages are sent immediately one email would be sent to alert of the loss of the Gateway card a second email would be sent to alert of the loss of the card in slot 1 a third email to alert of the loss of the card in slot two and so on By joining messages these alerts would be combined into a single message The parameters for joining messages are Initial Delay specifies how long the system waits after receiving the first alert before it assumes that no further alerts are coming and sends the message Max Idle specifies how long the system waits after receiving another alert before it assumes no more are coming Max Time specifies the maximum amount of time from the first alert to the last When this time limit is reached the syst
134. er profile LOCALAPPDATAS SAM Rol1lMap Configuration Page 9 2015 SAM RollMap User Manual Issue 6 Rev 1 2 2 2 Installation Per User Roaming Each user has their own configuration as above but will integrate with domain roaming profiles if enabled S APPDATA SAM Rol1lMap Configuration All Users All users on that PC will share the same configuration file SALLUSERSPROFILE SAM Rol1Map Configuration In Application Folder This will install the configuration files to the same directory as the application This is for legacy support of previously configured environments and does not fully support Windows User Account Control Install Directory Configuration Editing Monitoring Workstation The next dialogue will ask if you want to be able to use this workstation to be able to modify schematics If it is to be used for operators only the recommendation is to select Monitoring Workstation RollMap InstallShield Wizard Setup Type select the setup type that best suits your needs Click the type of setup you preter Full Editing Workstation Monitoring Workstation Figure 2 Editing Monitoring Workstation Page 10 Description Full monitoring workstation with editing facilities Back Next gt Cancel 2015 SAM RollMap User Manual General Operation 3 General Operation 3 1 Screen Components The diagram below shows the layout of the main components
135. er of buttons required for the panel and define the format of the router panel layout the style of each of the elements of the panel and define the crosspoints Object Properties Alarm Triggers Addressing Presets Configuration Position General Settings Columns nae name a Total 1 Text 5 Command E Li al a Routing Command Name Command Base Offset Routing Value ss Take ie Immediate Take Click to edit Preselect with Take button Options Enable Undo Timeout secs 0 No timeout Panel Lock Button Enable Panel Lock Figure 226 BPX Panel Configuration For the panel define a title caption and set the number of rows and columns of buttons to display Rows and columns may be spaced to divide buttons into different groups By default the Total number of buttons adjusts in line with the number of columns and rows selected However this can be overridden if required Note The number of columns and rows defines the area allocated for the buttons If the total number of buttons is subsequently reduced the buttons do not spread to fill the allocated space Issue 6 Rev 1 Page 160 2015 SAM RollMap User Manual Issue 6 Rev 1 Schematic Window Use a combination of the drop list and the Next and Previous buttons navigate to each button and allocate a name command as required Each button can either take the name of the source directly from the router or a fixed button name can be added manually Command numbe
136. ered directly into the Home URL box 4 Click the Edit Schematic button and either save the Schematic or open the Web Browser Issue 6 Rev 1 Page 110 2015 SAM RollMap User Manual Schematic Window Fle Edt View Corfaurater Virdow Hed 8X vaa gt AS 2581489 ODORA Per AR E som Physical Network Snel FE EE hip aww enetigroup com Je ol 0 6lels mp 06 O6 QBADX D GQBADX A m3 07 07 IQUAAD IOBAAD ID 08 08 IQOMENCS IQDMENCS mu 09 09 190 C02 MQDECOZ Wp 10 10 108AIR GQBAR snell E 11 111Q0AFS QQDAFS E 12 12IQOtAP 1QDEAP me 13 L3IQDEAP IQDEAP mi aoe mm 14 LAIQDAMDA IQDAMDA ED 15 15IQRDACN IQRDACN mm 16 161 0M3 L 1QOMIE 3A JOHIUMO E GQHIUM3 E 38 HUME IQH3UM3 E 2C 1QHIUNG OQHIUMG f a Seen pest bl New Kahuna MAVERIK o Network 8000 gt 9 x 0 0001 OA us User Network testes AEREO PERS PE feb senate eoenenes gt ar a ES Test Lat ALLELE E TE a DA 0 0 0005 AA 4 sses a rs a LAB 14480 S288 amp eee 00 ap i 6 History na 02 0 Unit Name Una Type Unit Address Tene Stamp Y Mestage A o D4IQSDA02 SDAD 2000 LADA Wed New 20 07 50 11 2013 INPUT 1 STLLISH FA L Sth Y New Fimered Group 1 041050402 1QSDA02 2000 24 04 Wed Nov 20 07 50 11 2013 0 T a a ES SC_una O4IQSOADZ 1QS0A02 NOAD Wed Nov 20 07 50 11 MAI pans O4 IQSDA02 1QSDA02 2000 24 Wed Now 20 07 50 11 2013 INPUT 1 HYPERION SUMMARY lt FAL E s es AANE HIQSDAD2 IQSDAN 2000240 Wed Nov 20 07
137. ert ActiveX Object menu If using Microsoft Windows 2000 or XP operating system an option box displays All SAM ActiveX objects are listed under ActiveX Controls Insert ActiveX Object kK Figure 167 Insert ActiveX Object The dialog box displays a list of available objects Many of these can be used as static objects The standard objects installed by RollMap start with the name SAM Insert Object 0 Create New Adobe Acrobat Document Microsoft Equation 3 0 Cancel Create from File Microsoft Graph Chart J eae om Microsoft Office Excel 97 2003 Work Help AE ead Microsoft Office Excel Binary Worksh O Create Control Microsoft Office Excel Chart Microsoft Office Excel Macro Enablec OH Display As Icon Microsoft Office Excel Worksheet bl Result Inserts a new Adobe Acrobat Document object into your document Page 123 2015 SAM RollMap User Manual Schematic Window Figure 168 Insert ActiveX Control Object After selecting an object the object is placed in a default position Use the grab handles to re position the object on the screen The object can be copied pasted and moved just like any of the basic drawing objects ActiveX objects have their own Properties menus and their behavior depends on their implementation Undo New OLE Object Cirl z Se Cut Ctrl x H Copy Ctl Delete Del Select All CctrI 4 Ordering Add Object Style To Custom Tool Bar Properties Ctrl Enter Image Object
138. erties Alam Triggers Addressing General Commands Pictures Colour Position Display Colour Figure 195 Color Properties Issue 6 Rev 1 Page 141 2015 SAM RollMap User Manual 9 8 4 5 9 8 5 9 8 5 1 Issue 6 Rev 1 Schematic Window External Properties This object exposes many properties Only the ones listed below should be used as alarm trigger properties Properties read and write variables External Name Type Valid Values State VT_12 16 bit integer 0 Black 1 Green 2 Yellow 3 Red Null terminated string Can be used in command Caption VT_BSTR text string line substitutions as c UserString VT_BTSR text string r substitution field Table 8 External Properties Snell State Meter CC This object allows an alarm trigger event to be represented as a segmented bar or numerical meter with up to five color level ranges in a schematic window The global system registered name for this ActiveX object is Snell State Meter This object is useful when the Caption of an alarm trigger is a number value the EDHERR header or FAN_SPEED header The Caption can be assigned to the ValueString property and the meter converts the ASCII text into a real number for display Figure 196 Add Snell State Meter To resize the Snell State Meter double click on the object or select Snell State Meter Object gt Properties from the main or context menu to show its properties box General Properties
139. ess Requires IPADDRESS and Cl Use manual IP address THUMB_IP_PORT log fields of IP Address Defer Unit 1 IP Port Slot dec Defer Bo Z Figure 140 Address Properties The aspect ratio for the Thumbnail image is set on the Control tab Object Properties General Address Control Position Trata nage dr Initial ect Ratio is 7 Lock Aspect 0 Widescreen 16 9 Figure 141 Control Properties The size and placement of the Thumbnail image can be specified on the Position tab Page 109 2015 SAM RollMap User Manual Schematic Window 9 4 4 Web Browser Tool O This function inserts a Web Browser control into the schematic window this works the same as Internet Explorer This would be used for web based control using applications such as RollCall Control Panel 1 Click on the Web Browser tool in the tool bar Click on the schematic window and expand out the required area for the Web Browser as shown in Figure 142 2 Figure 142 Add Browser 3 With the Web Browser window still selected right click with the mouse with in the Browser window and select Properties Object Properties Position Object Address Hex The IPADDRESS log field of the resolved address can be Defer Unit T substituted by using the He Ue ll vaiable inthe URL Home URL Doo Ef Figure 143 Browser Address Properties Enter an IP address to connect directly to external servers or URL can be ent
140. etwork components To organize components within the User Tree there are e Location For creating trees within Filtered Groups Automatically add components based upon user defined rules e Folders For organizing components within Locations or Filtered groups Y ya i 2 ua O Ex Anan w F be 5 E Bright seme Phepecad Mecheverk _ Adress Ural Marne Local Te i Urai Type Versi n Unt Stee intor E e E T Hi E de IAEA E HL El 0 1 00H E F HURN G lamri Frar PHILS 1 ik URH Se la ma 01 01001050 LT me ach DESEOS Ea OF I MSE om ti 1149640 ORADE Ea ii aiiim MODAS a Li 15H J4DES MODA Ep 15 1620088 panii izah AAA D he Lib r Pletacra ke 1 E E a E Ya Me ted Gire a rik User Tree spit matron Cu Les Sane MAIS me Rack 1 0 iy O Rack BEG mi a OF Rack a HACI LonSoreer 00000000 Stats is OK oa g4 a an an an to DOr Peck 3 CH we Rack d OQCRRG A i Urat Plane Unit Type Lina Addr Tima Suma S Maeceage A 5000 1108 M n Mor 1A 08 05 33 30039 eee z Local Mebieork RollbHap Local User Hersart 0000 10 01 Mon Mov 18 0744 14 2013 MEW ALTERET GROUP Te PAN Local Mrbwnrk RellMiap local Uher Hisori 0001 01 01 Men Mor 18 07 4 17 2013 TT LAB FalLagyirgale SE OM JOA E WJOIMSTE 4000 0505 Bisa Me LOTS 2087 MMPUTSLOST sia EO IQOMSLE ama Mon Mire 16 07 44 14 219 LOST TUNEL II EL piin EREI Mier Merr 1H OA M4 CARO IJARCDO ADS Bisa Mos LA 07 4
141. event does not display on the Complimentary Tab The History Tab only displays states that are not Green OK and have completed that is the state of the event is now in another state Starting State INPUT_1_BLACK 0K Complimentary Tab 1 Hyperion sch E Details 1100 16 03 Hyperion Sort by Header v History Unit Name Unit Type Unit Address Time Stamp 7 Message Duration Timecode Default History H Figure 105 Complimentary Tab Black OK At first while the state is still OK Green neither tab displays any information State INPUT_1_BLACK WARN Black Complimentary Tab 1 Hyperion sch E Details 1100 16 03 Hyperion Sort by Header Keyword lt History m E EEE E TT TT T TT Tg TT T g g g g Unit Name Unit Type Unit Address Time Stamp 7 Message Duration Timecode A Hyperion IQHIPOO 1100 16 03 Wed Dec 11 12 14 18 2013 MIN 0 01 40 21 GE Figure 106 Complimentary Tab Black WARN Black Page 87 2015 SAM RollMap User Manual Issue 6 Rev 1 History Tabs When the state changes to INPUT_1_BLACK WARN Black Amber because it is no longer Green and is an active event the state is displayed on the Complimentary Tab However because it has not yet completed nothing is displayed on the History Tab State INPUT 1 BLACK FAIL Black Complimentary Tab 1 Hyperion sch 4 Details 1100 16 03 Hyperion Sort by Header
142. following parameters to the Configuration cfg file which is located in the Configuration folder of the installation directory By default the location of this file is C Program Files SAM RollMap Configuration Configuration cfg RollMap must be closed before opening the configuration file and not restarted until the changes in the files have been saved The parameters to add are AlarmViewRightClickAllUnits Item0 System Home page SPROJECTS Schematics Home sch Iteml Sub system home page SAREASS SN sch AlarmViewRightClickPortZero Item0 View unit details SDETAILSS N_ U sch AlarmViewRightClickPortNonZero Item0 View module details SDETAILSS N_ U_ P sch Iteml View rack details SDETAILSS N_ U sch Issue 6 Rev 1 Page 60 2015 SAM RollMap User Manual Configuring RollMap 4 14 Other Configuration Options The options described in this section set several other preferences that allow you to customize RollMap Issue 6 Rev 1 Open Schematics in Design Mode specifies whether RollCall Schematics open in Run or Design Mode To open RollCall schematics in design mode from the Configuration menu select Open Schematics in Design Mode If this option is not selected RollCall schematics open in run mode Fonts specifies the font used in the System Alarms window To change the font used in the System Alarms display from the Configuration menu select Fonts A font selection dialog displays from which the font can
143. g triggers can be specified for a Schematic Link e Object State Trigger actions initiated when the state of the assigned unit changes e Button Press actions initiated when the button is pressed e Auto actions are initiated when either e aschematic containing the object with the auto trigger is loaded or goes into Run mode from Design mode e RollMap starts if in global alarm e CheckBox Checked Press actions are initiated when a checkbox is pressed when in checked state e CheckBox Un checked Press actions are initiated when a checkbox is pressed when in unchecked state For details of the attributable alarm actions see Configure Alarm Actions on page 35 Log fields can be used with a SAM General Button See Dynamic Log Field Insertion on page 191 The State Pictures properties page allows a different picture to be shown in the object dependent on its state If a single static picture is required independent of state select the Use Default Picture Only checkbox and enter a path to the picture in the Default Black Picture field Different pictures can also be defined for when a mouse pointer is over the object Alt Object Properties General Fonts Schematic Unit Address State Actions State Pictures Position AM O Keep Aspect Ratio O Show as LED Ol Use Default Picture Only Hash on Red O No Fit In Border Figure 134 State Pictures Properties Status Control The Status Control a
144. g with 8 No user feedback is given by the replace command the modified schematic is automatically opened and closed After running the replace command the results should be verified by opening the RollMap GUI filename T1 Open file and place new window as full screen of client area within RollMap filename T2 Open file and place new window at top half of the client area within RollMap filename B2 Open file and place new window at bottom half of the client area within RollMap filename L2 Open file and place new window at left half of the client area within RollMap Page 167 2015 SAM RollMap User Manual Issue 6 Rev 1 A 1 RollMap Command Line Parameters filename R2 Open file and place new window at right half of the client area within RollMap filename TL4 Open file and place new window at top left quarter of the client area within RollMap filename TR4 Open file and place new window at top right quarter of the client area within RollMap filename BL4 Open file and place new window at bottom left quarter of the client area within RollMap filename BR4 Open file and place new window at bottom right quarter of the client area within RollMap hide Hides the RollMap window and places a small icon in the Taskbar icon area fullscreen Starts the program in Fullscreen mode filename is the paths of 1 or more Alarm Schematic or Component files with the extensions ALM SCH or CPT respectively Long file names
145. ge 188 2015 SAM RollMap User Manual RollMap Parameterization Appendix G RollMap Parameterization Issue 6 Rev 1 G 1 G 2 Relative Paths Everywhere in RollMap that a path is entered for example links to images links to components within schematics or other components links between schematics and links to external commands to execute you can enter a relative path which is considered relative to the starting directory of the enclosing file Example If c myfolder screenl sch has a navigation button that links to c myfolder screen2 sch the link could be defined simply as screen2 sch The huge advantage of storing the relative path is that you can move the entire set of files from c myfolder to D newlocation and all the relative links still work D newlocation screenl sch containing a relative link to screen2 sch now automatically links to D newlocation screen2 sch with no editing required This allows the control amp monitoring system to be maintained moved between local and server shared locations moved between PCs with different hard drive structures without tedious changes RollMap design mode automatically finds the best relative path when you browse for files for example when editing the link from c myfolder screenl sch and browsing to target file c myfolder screen2 sch RollMap automatically identifies the common relative path and inserts just screen2 sch into the configuration Unless super
146. ging it from the centre to the outer edge of the rectangle The round rectangle has the same properties as the rectangle Ellipse and Circle Tool Select and place as before The ellipse and circle has the same properties as the rectangle Triangle Tool A Select and place as before The triangle has the same properties as the rectangle with the addition of selecting a triangle style and orientation using radio buttons Polygon Tool E Select the polygon tool Click to start the first point of the polygon Move and click the left mouse button to join more points to the object To finish double click the left mouse button and the last point is automatically connected to the first starting point Use the grab handles to re shape the polygon This has the same properties as the rectangle object Page 99 2015 SAM RollMap User Manual Schematic Window 9 3 8 Text Tool A This is a general text item that can be placed on the screen Figure 124 Text Tool The text tool has the following properties 9 3 8 1 Text General Properties Object Properties General Fonts Unit Address Position Line Border Style Colour Fill background colour Weight Transparent fill C Y Line border colours l Figure 125 Text General Properties e Caption tIn the caption field enter the text to display This text can be either a static entry or it can be a header expansion variable For example inserting ADDRESS
147. h enables third party objects to be included into the document such as MS Paint pictures MS Word documents etc Schematic Window Ele g t yew Conipraten jundow Help 89X lak b DS COSCR ES SOSA Perr PES onee Physical Network eb EE BD 0G 06IQRADX D PQRADIO al MS 0 OF 2QBAAD OGHAAD mp 02 CB IQDMENCS MIQOMENCS mp OF COIQDECH IQDICO2 WD 1 20908408 106A mp 11 LLIQDAFS GQDAFS Me 12 122Q084P QOLAR MD 1 gt LAQQDEAP DQ0EAP ED 14 149QDAMDA PQUAMDA ED 15 1S2Q8D4CN OQEDACN UD 16 16300103 IQOMIA E B JA IQHSUMS AQ4OUMO E E 39 HUMI E GQHIUM2 a aC IQUIUMO E QUIM E a Network 2000 a 05 IQHPUME S Tirms Fearn OOHIUME S Network 1000 User Network gx EE EE 2 E Test Lab 3 0 0 0 ma ot 0 Horey ma 0 0 Unt Neme Unt Type Una Address Tmc Seme Y Mersege A 0 OLISDAN 1QSDAD 2000 2404 Wed Nev D 075011 2013 INPUT I STRLISHsFAR Atila SB New Filtered Group 1 04305DAD 1OSDAD 2000 2404 Wed Nov 20075041 2013 SARAAT FI 5C_ uo OkIQSDAGZ sanz 7000 2404 Wed Nov 2007 509 2083 a a a pa J HA KEDAN 2000204 Wed Nov 20073011 201 INPUT A HYPERION SUMMARY FAIL a em E Wed Nev 20075011 2013 NDUT 1_PREEZESFAILFreese E 0 IQHGUNG E 1QH3UM3 E Wed Nev 2007 40411 2013 i CANI 1 W 11 113Q6ADC MQEADC asia aes ay may TENT ouigsnan i E Wed Nev 3007 50411 2013 OkIQSOVE2 1QSDAD2 2000 2404 Wed Nov 20075011 2013 Oars anz snan 2000 2404 Wed Nov 20073011 2013
148. hat after adding to the main list the entry contains 0000 00 00 X X X The X denotes which part of the address is deferred Object Properties Alarm Triggers Addressing General Commands Position Address Methods Properties for State Defer Net C Unit C Port Methods Properties for Caption P Caption Figure5 Alarm Trigger Address In general all Components and its internal objects should be built using partial or fully deferred addressing This allows greater re usability of components anywhere in the system All SAM library components use deferred addressing and search path substitutions Issue 6 Rev 1 Page 178 2015 SAM RollMap User Manual Integrating RollMap with Volicon Observer Appendix D Integrating RollMap with Volicon Observer Issue 6 Rev 1 D 1 D 2 Overview RollMap can be integrated fully with Volicon Observer monitoring and logging software To configure Volicon integration 1 Install and configure Volicon Observer This is not described in this manual please refer to the Volicon documentation 2 Setup the RollMap Links menu in the Configuration cfg file See Configuring Shortcut Links below 3 Edit the Gateway template pages to set the correct INFORMATION2 log field for the IQHIP00 See Setting up the INFORMATIONZ2 Log Field on page 180 4 Create History Tabs and Complimentary Tabs monitoring each Hyperion IQHIPOO card per Volicon channel See Setting up the RollMap History
149. he Base Protect field for the base command that defines the destination protect function applicable routers only Issue 6 Rev 1 Page 165 2015 SAM RollMap User Manual RollMap Command Line Parameters Appendix A RollMap Command Line Parameters RollMap can be run from any MS Windows command line interpreter or shortcut The format is RollMap exe min max sys mask unmask maskcell unmaskcell snmp maxframe minframe details address replace T1 T2 B2 L2 R2 TL4 TR4 BL4 BR4 hide fullscreen filenames Where are optional parameters mMin Starts the program with child windows minimized max Starts the program with child windows maximized SYS Opens the home schematic home Opens the Systems Alarms window mask NNNN UU PP Mask unit at address NNNN UU PP standard RollCall address of unit maskuntilgreen NNNN UU PP Mask unit at address NNNN UU PP standard RollCall address of unit until green unmask NNNN UU PP Unmask unit at address NNNN UU PP standard RollCall address of unit maskcell NNNN UU PP HEADER Masks a cell on a specified unit where HEADER is the header keyword and NNNN UU PP is the RollCall address of the unit maskcelluntilgreen NNNN UU PP HEADER Masks a cell on a specified unit where HEADER is the header keyword and NNNN UU PP is the RollCall address of the unit until green unmaskcell NNNN UU PP HEADER Unmasks a cell on a
150. he LAN port is set to On E ye Auto Send SNMP MY Get SNMP Agent Address 192 168 50 82 El y CheckBox Un checked Press 4 Send sump OID 56 12 1232 1 7 65540 A OID Type 32 bit Integer Find Numerical values can be either decimal or hexadecimal use Ox prefix Figure 207 Check Box Example LAN Port On 10 In the Actions screen add a CheckBox Checked Press trigger and add a Send SNMP action 11 Enter the unit details and a Value of 2 Issue 6 Rev 1 Page 149 2015 SAM RollMap User Manual Schematic Window This sets the checkbox such that when unchecked the LAN port is set to Off Auto Send SNMP Get snmp Agent Address 192 168 50 82 El y CheckBox Un checked Press Send snp OID 1 3 6 1 2 1 2 2 1 7 65540 Send SNMP OID Type 32 bit Integer And Numerical values can be either decimal or hexadecimal use Ox prefix Figure 208 Check Box Example LAN Port Off 12 Enter the virtual unit address F000 36 00 into the Log Unit field 13 Enter LAN PORT _ADMIN_STATE into the Log Header field 14 Click OK For further details about triggers and actions see Unit Triggers and Actions on page 164 To ensure the checkbox is checked even if an external source changes the value e Inthe General Properties tab click on the States radio button in the Check When section and check the OK checkbox Object Properties Fonts Aam Triggers Addressing General Picture
151. he object is hidden until the state changes Issue 6 Rev 1 Page 125 2015 SAM RollMap User Manual Schematic Window 9 8 1 Snell State LED ActiveX Object This object allows an alarm trigger event to be represented as a LED in a schematic window The global system registered name for this ActiveX object is Snell State LED Figure 171 Add LED ActiveX Object To resize an LED double click on the object or select Snell State LED Object gt Properties from the main or context menu to show its properties box 9 8 1 1 General Properties You can set the initial color state of an LED or the LED can be made to flash on any color Or it can be made to flash only on RED for example The LED object does not have a user editable Caption property Object Properties Alam Triggers Addressing General Commands Position Options Flash W Flash On Red Figure 172 General Properties Issue 6 Rev 1 Page 126 2015 SAM RollMap User Manual Schematic Window 9 8 1 2 Commands Properties The Commands properties page allows Alarm Triggers and Alarm Actions to be configured Object Properties Alam Triggers Addressing General Commands Position Figure 173 Command Properties Click the Edit Actions button to open the Actions window Actions Object State Trigger z ny Send Message chats Green Yellow warn MlRed error None Ignore Mask Open RollMap manual Figure 174 Edit Actions The follo
152. he schematic being edited must have a filename so that its current location can be found A manual Paths button is also available next to most fields that support search path substitutions Issue 6 Rev 1 Page 57 2015 SAM RollMap User Manual 4 12 Issue 6 Rev 1 Configuring RollMap 3 RollMap System Alarms File Y ma Unit List ES Edit View Configuration Window Help I r Log Server Connection F Physical Metwork Keyword Headers t Adress is E Mask Setup RollMap Client Logging Local Time gt yh RollMap Local 4 b dy Network 0001 Snap Shot IDs b b wi UK LogServer al SNMP j B Network 1111 Alarm Actions t gt y4 UK RollTop Cor oe gt B Network 1333 b a UK Lab LogServ Message Configuration gt y4 Stand Alchernis Home Schematic gt B Network B00 auto pscovery of Un gt nh Network 4000 __ hee A gt Network 8000 ia Multi Window Configuration Automatic use of search paths Open Schematics in Design Mode File Handling Fonts Colours Highlights User Network Time Format Lis E e Clear Cache User Authentication b gt Pa l an Figure 65 Search Paths Automatically Multi window Configuration Schematics can be opened automatically in separate windows under certain conditions allowing them to be placed outside of the main RollMap application enabling the use of multiple monitors and large displays within the control and monitoring sys
153. hen transitions to Red a new alarm is not triggered None alarm is not triggered regardless of state Ignore if selected an alarm is triggered whether masked or not Any Data Change triggers the alarm on any data change so long as the states match Care should be used when selecting the Any Data Change option because it can generate a very large number of alarms In the Headers section specify whether the trigger is to be applied based upon the Unit State or upon the state of the Headers If Headers is selected specify whether the header state should be determined by the Aggregate Header State or Individual Header State Aggregate State triggers actions based on the overall state of the selected headers If one header triggers the alarm the alarm condition is considered to apply to all headers If a second header also reaches an alarm state a new alarm is not triggered Individual State triggers actions based on the individual state of the selected headers If one header triggers an alarm and then a subsequent header reaches an alarm state A separate alarm is raised for each header To select specific headers click the Headers button OM Headers Delete Unit Type Version Temp 1 Name Temp 1 State Temp 1 Celsius Voltage 1 Name Figure 29 Headers Page 33 2015 SAM RollMap User Manual Configuring RollMap 4 8 5 Add an Alarm Action After adding an alarm trigger to add an action to it right clic
154. hen you can change the text color to any available color in the Fonts or Colors property pages Text alignment properties are similar to the generic Fonts property page The border frame and text can be made to flash or flash only on red error state The border can be made visible or invisible The border width is always 1 pixel Object Properties Fonts Alam Triggers Addressing General Commands Colour Position state Options Black Flash Green Flash on Red O Yellow Frame O Bed WlUse State Colour Figure 190 General Properties 9 8 3 2 Fonts Properties Page The horizontal vertical and escapement orientation of the font can be set from this page Some combinations of style allow multi line formatting Select Change Font to select a font available in the system The font color can also be set from this dialog if the Use State Color property from the General page is not set 9 8 3 3 Commands Properties Page The Commands properties page allows Alarm Triggers and Alarm Actions to be configured Click the Edit Actions button to open the Actions window The following triggers can be specified for Snell State Text Box e Object State Trigger actions initiated when the state of the assigned unit changes e Auto actions are initiated when either e aschematic containing the object with the auto trigger is loaded or goes into Run mode from Design mode e RollMap starts if in global alarm e Caption Changed action
155. ile CurrentHeaders ctg Column Selection Column Number _ 0 ADDRESS 0 Header keyword enone SNMP trap on change ADDRESS lo _ Show only on Warning or Failure Display Title Text Field eres Exclude keyword s O UCT Field O Number Field Text Field Good Green state keyword s Universal Coordinated Time Field i Cyan display keywords if state is Good Magenta display keywords if state is Good Display Format Warning Yellow state keyword s ena Failure Red state keyword s Error Warning Good Warning me een o o 0 o Good Green New Delete OK Cancel Figure 15 Keyword Headers The column is identified by the Header Keyword listed in the current status file One of the header keywords available in the current status file can be selected using the Browse buiton The display line for the unit can be made to change color depending on the words matched in the Warning Keyword and Failure Keyword fields The Warnings field generates a Yellow State Failure field generates a Red State The Magenta and Cyan parameters can be configured in the same way as Green Yellow etc states They are used to highlight a condition that isn t necessarily a fault for example if you had a network switch you could have all the ports running at 10 Mb be Cyan and all the ports running at 100 Mb as Magenta Page 21 2015 SAM RollMap User Manual Configuring RollMap The Exclude Keyword field removes the assigne
156. ion to the normal alarm triggers addressing and position properties there are two properties tabs relating to the setup of the router panel e Presets quick setup for each of the basic router types e Configuration define the number of buttons and their operation and the layout and style of the panel Presets Properties When a new panel is added to a schematic the default Custom type is selected To start the configuration using one of the preset routers select the relevant radio button according to the router type connected to This will configure the correct commands and numbers and will display a default grid size according to the router selected Page 159 2015 SAM RollMap User Manual Schematic Window Object Properties Alarm Triggers Addressing Presets Configuration Routing Position Select a router type Vega Sirius 800 Family 16x16 Default VIQSPI Router Ctrl Driver 16x16 Default Options IQDMX4 IOSRT20 4x1 Reset grid sizes 5 IQDMX8 IQSRT21 8x1 4 Reset button command offsets O IQBRTS IQDRTS 8x8 O IQBRTS IQDATE 6x4 E IQSRTOO 5x2 5 IQSRTIO 8x2 Figure 225 Router Presets Two option checkboxes one to reset the button grid size according to the selected router and one to retain the router command numbers are both checked by default These can be unchecked if the functions are not required 9 8 9 2 Configuration Properties In this tab set up the numb
157. ior methods such as search paths are used see below Search Paths Everywhere in RollMap that a path is entered for example links to images link to components within schematics or other components links between schematics and links to external commands to execute you can enter a combination of a base variable search path prefix with a hard coded suffix The syntax is Svarname where varname Is the defined name of the search path variable Search paths can be defined with absolute hard coded values or with nested values referencing other search paths The key point is that you can edit the search path definitions in one central place and have the changes ripple through to every use of that search path within the configured system Worked example as used in the SAM standard RollMap library Variable SLIBRARYS defined hard coded on each PC as required SLIBRARYS C WhateverPathYouLike MyLibraryRoot Variable 1Q defined in a nested relative way ITQS SLIBRARYS SAM IQ Modular Within a typical control and monitoring system there may be thousands of file links referencing entries from the RollMap library for IQ Modular devices which take the form SIOSAstatic_suffix for example Insert component from path SIQOS IQAAD00 Device 1A cpt The library itself contains thousands of cross references between library entries and also the customer specific project files Schematic screens for example contain numerous links to entries fr
158. is in a checked state and then clicked to un check then the unit is unmasked in the Actions windows select the criterion to set the checkbox to a checked state In this example it will automatically check the box even if the unit is masked by a third party giving an indication to its current state Issue 6 Rev 1 Page 146 2015 SAM RollMap User Manual Schematic Window 9 8 6 2 Font Properties The font style size and color can be changed as can the position of the text within the button face Highlight text may be added to change the font properties for when the button is hovered over Object Properties Alam Triggers Addressing General Picture Check Box Style Position Styles Horz Alignment k Sample Text Vert Alignment Escapement Horizontal eft to right 2 Highlight Change highlight font Change font Change font colour Figure 203 Fonts Properties 9 8 6 3 Picture Properties The check box face can be replaced with a picture based on the Unchecked and checked state defined The original aspect ratio of the picture can be maintained and the Caption displayed over it Also the button bevel and button background can be removed by deselecting the corresponding check boxes Object Properties Fonts Alam Triggers Addressing General Picture Check Box Style Position iv Keep Aspect Ratio Wl Show Caption On Picture 4 Show Button Bevel 4 Show Button Background Figure 204 Picture Properties
159. it can load libvic dll and the methods it needs are available The code automatically searches the default install directory for VLC player so in all likelihood you won t see these dialogs at all 4 8 10 Global Alarm Actions Versus Object Auto Command Actions Auto triggers or state triggers can either be Global or Object specific If an Auto trigger is defined under the Configuration Alarm Actions section of RollMap then it will be active the whole time RollMap is open and not linked to a specific schematic This has the benefit of field values being present at all times and can be used as general triggers for example initiating other actions such us sending emails or triggering GPIls If an Auto trigger is assigned to an object it will only run when the schematic on which the object resides is open This is more efficient with regards to server load however field values will get lost when navigating away from that schematic assuming the option of opening one schematic at a time has been chosen and re appear when navigating to the schematic with the auto trigger assigned to an object It is advisable not to use to use a high number of Auto triggers per machine as they can have a high cost on hardware resources Issue 6 Rev 1 Page 52 2015 SAM RollMap User Manual Configuring RollMap 4 9 Configure Email Messages Before any emails can be sent as alarm actions 1 A transport profile which specifies the method by which emails
160. items for details Issue 6 Rev 1 Page 96 2015 SAM RollMap User Manual Issue 6 Rev 1 9 2 7 9 2 8 9 2 9 9 2 9 1 9 2 9 2 9 2 9 3 Schematic Window Ordering Items in the Schematic Window These menus re order the selected item in the display list Items that are at the front of the list display on top of other items Lindo Fill Colour Ctrl4 z ps Cut Ctrl X f Copy Crl c Delete Del Select All Ctl A Move To Back Alt HMinus Properties Ctrl Enter Move Back Minus Figure 123 Ordering Items To change the display order of items in the Schematic Window right click on an item and from the menu that displays select Ordering and one of the following options e Move To Front places the selected object in front of all other objects Move To Back places the selected object behind all other objects e Move Forward moves the object one level nearer to the front e Move Back moves the object one level nearer to the back Opening Schematics in the Same Window This re uses the current window to open new schematics Otherwise each schematic opens in a different window To set this option from the View menu select Open Schematic in Same Window This option applies only to schematics and schematic links opened through the command line It does not affect File gt Open or File gt New which always open a new window for the selected schematic Printing a Schematic The current schematic can b
161. ith Sunday as the first day of the week 00 51 e w Weekday as a decimal number 0 6 Sunday is 0 W Week of the year as a decimal number with Monday as the first day of the week 00 51 e y Year without the century as a decimal number 00 99 e Y Year with the century as a decimal number e As single sign To use a single log file with a fixed name clear the Use automatic filename based on Time Date check box And in the Fixed filename section enter the path or browse to the location and name of the log file to be created This file must be located in a local or network accessible directory Then specify the maximum size for the log file set to O to allow unlimited file size Click OK to save changes and close the properties window or click Cancel to close the window without saving changes History Tab Log File Set Up Enable log file Use automatic filename based on Time Date Fixed tilename Log filename C Program Files 06 Snell RollMapsDetaultl log a File size limit KE o setto O for WO limit Paths Automatic filename Filename format C Program Files ibr Snell Rolliap d Current resolved filename is C Program Files wib Snell Rollifap 20 111 3 100 Cancel Figure 102 History Tab Log File Setup 8 2 6 Columns Use this option to configure the columns to be displayed on tabs and the order in which they are displayed To configure columns right click on a tab and select Tab Configur
162. k on the trigger and from the menu that displays select one of the actions Add Trigger k Addiction Commande Macro Play Sound Send RollTrack Get RollTrack Send Message Send SNMP Get SNMP Mask Unit UnMask Unit Ordering Duplicate Trigger Mask Header UnMask Header Login Logout OC Report Logging Ping IF Address Snell MV Control Open RollMap manual Figure 30 Add an Alarm Action Alternatively click the Add button and from the list that displays select an alarm action Multiple alarm actions can be added to the same alarm trigger For example both an email message and an SNMP message could be sent to a system administrator in the event of a log server loss 4 8 6 Alarm Action Operations Alarm actions can be copied and pasted via the Windows clipboard The can also be changed into their corresponding opposite action by using Reflect Action for example Mask Header becomes UnMask Header 4 8 7 Trigger Operations Triggers and all their actions can be duplicated 4 8 8 Multi Alarm Triggers Associating a single Alarm action with more than one Alarm Trigger creates a Multi Alarm Trigger type To create a Multi trigger add the first trigger and create an action for it then add a second trigger at the same level in the tree as the action In the example shown in Figure 31 the same Email message has been linked to both a Logserver Lost Trigger and a State Trigger Issue 6 Rev 1 Page
163. lders hence the name search path This is an advanced feature and rarely used by SAM when we build RollMap systems Search paths are intended to be case INsensitive so iq should work the same as SIQS Macros Everywhere in RollMap that an executable command is specified for example an action triggered by pressing a configured button or an action triggered from a customised right click context menu or an action triggered by a defined status from the live monitoring system RollMap allows you to reference command macros The syntax is lt macroname gt to reference a defined macro and the macros are defined centrally Q What is the difference between macros and search paths A Search paths are intended to be used for paths for example directory names and or file names Macros can contain paths but in addition they can contain other data typically command line parameters being passed to the external program Worked example as used in the SAM standard RollMap library Macro definition lt CONTROL PANEL gt SCONTROLS runonce u a Search path definitions SCONTROLS SROLLCALLS Control Panel Rollcall Control Panel exe SROLLCALLS C Program Files x86 SAM RollCallSuite Many places within the RollMap library or a customer s configured system may call the macro lt CONTROL_PANEL gt At run time this is expanded through the various nested macro and path definitions to resolve to an absolute external path reference C Progra
164. le a unique name e Inthe Application field enter or browse to the location of the blat exe file By default this is located in the RollMap installation folder for example C Program Files 86 SAM RollMap blat exe e Inthe Parameters field enter the command line to be run by blat exe using the listed substitution strings The following string can be used by replacing the necessary fields with your sender address and mail server address f subject Ss to t f sender Address com server serverAddress In the above example RollMap replaces with the email text and s is replaced by the subject line Transport Name Application SROLLMAPS Blat exe Parameters Sof to Sot s subject 5 Subject Som Message 4 First line of message 2f Temporary File containing message Sot Recipient Cancel 44 Supports Multiple Recipients Figure 59 Transport Details e Click OK to close the Window and then click OK again 4 9 2 Create a Message Profile To create a message profile that specifies the recipients and emails options From the Profiles window click New or to modify an existing profile select the profile and then click Edit The Recipients window displays Issue 6 Rev 1 Page 54 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap Recipients x Recipients Add Edit Delete Options 6 Send Immediately 5 Join messages Contents gt gt Figure 60 Recipi
165. le click on it to open the Properties 3 From the General tab add a caption Panel Lock 4 Select the Locked radio button in the Check when section Issue 6 Rev 1 Page 151 2015 SAM RollMap User Manual Schematic Window Object Properties Fonts Alarm Triggers Addressing General Picture Check Box Style Position Caption Panel Lock Command line Command Actions Check when Y O States Unknown OE Warming Error O Unlocked Figure 212 Check Box Example General Properties 5 Click on the Command Actions button 6 Inthe Actions screen a Checkbox Checked Press trigger and add an Unlock action to it 7 Add a second trigger Checkbox Un Checked Press trigger and add an Lock action Actions E CheckBox Unechecked Press oo UnLock El CheckBox Checked Press Open RollMap manual Figure 213 Check Box Example Actions 8 Click OK The appearance and functionality of the control can be changed for example the caption highlight font style and color from within the Fonts tab Issue 6 Rev 1 Page 152 2015 SAM RollMap User Manual Schematic Window Object Properties Alam Triggers Addressing Position General Picture Check Box Style Horz Alignment Sample Text Vert Alignment Change font Change font colour Escapement take gt a Horizontal left to right A Highlight Change highlight font Figure 214 Check Box Example Fonts The style of the checkbox itself may also
166. lect the Highlight check box and then click Change highlight font to specify the font Page 101 2015 SAM RollMap User Manual Schematic Window 9 3 8 3 Text Unit Address Properties Object Properties General Fonts Unit Address Position Object Address Hex Defer Unit Defer Port Figure 127 Text Unit Address Properties These settings allow a unit address to be associated with the text object 9 3 8 4 Text Position Properties Issue 6 Rev 1 Object Properties General Fonts Unit Address Position Figure 128 Text Position Properties These settings allow the position and size of the text object to be specified Page 102 2015 SAM RollMap User Manual Issue 6 Rev 1 9 3 9 9 4 9 4 1 Schematic Window Picture Tool This is a static picture object It has properties similar to the rectangle tool with the addition of a picture The picture can be made to stretch to fit the frame boundaries or centered with its Original aspect ratio To set the picture use the Picture tab of the properties box to enter or browse to the picture to be inserted Object Properties General Picture Position Picture file name Keep Aspect Ratio Figure 129 Picture Properties Advanced Drawing Tools As opposed to the drawing tools described in the previous section which only provide graphical elements to the schematic these tools gather information from the RollCall logs and changing appe
167. lick on the selected cell and then select Mask Unmask Cell Mask Cell Until Green Mask Cell Until Green masks the cell until its status returns to green or it is unmasked by means of the Unmask Cell option Mask Cell Until Time Mask Cell Until Time masks the cell for the specified period of time either preset or custom Once the time has elapsed the cell is automatically unmasked by the LogServer This feature is accessible from all menus where the current cell can be masked Unmask All Cells This option unmasks all cells Page 63 2015 SAM RollMap User Manual Issue 6 Rev 1 9 4 5 5 5 5 1 5 9 2 5 9 3 System Alarms Window Query the State of a Unit To view the details of any warnings or errors with a unit right click on the unit in the System Alarms window and select Query State A dialog displays indicating warnings or errors currently being generated by the unit RollMap A 01132 2000 21 00 State is OK Figure 70 Query State Change View Options There are eight tool status bars available on the System Alarm window The General Toolbar Schematic Toolbar and Alarm Objects Toolbar appear just beneath the menus The Status bar contains six boxes with colored icons displaying the total number units in each state and the total number of units Their description can be viewed by placing the cursor over the boxes and a tool tip will appear The green bar at the right of the status bar is
168. ll other headers may be sorted or deselected This is used in conjunction with the Deselect Columns After Pin and Sort Headers By Name functions Only one header may be fixed pinned at any one time Auto arrange Column Widths Column widths are automatically set so that each column displays all data without truncation Each column width is set to accommodate the longest item in that column Page 74 2015 SAM RollMap User Manual Network Tree 6 Network Tree 6 1 Description The Network Tree is displayed on the left of the RollMap window as with the RollCall Control panel when the network is first displayed all nodes are collapsed Click the sign next to a node to display the units contained within it Fie Edi few Confgurabn free Help id S Geese BSE OEL a Y NE wots Pryce Mirheverk address Ud Hama Lacal Tirne _ Ut ype Meron Unt Stee inion We ak J IQHIUWO E QQHAMU E A Network i E T HE HR ree gt i 22 IQHDUNOE aQHoUMO E de LHS E QS E 8 20 HILO GALO E Aer IAEA E CHUA a 7 Hiebrecak 0500 af 0 HJHSUA 45 Der Frar IH IUN 1 me 01 01001050 Ly mg oe UOT AL ie RE ma 04 5d fife hie OE i 50 ma Li 1110840 10RAD E 14 1400450 ODE So EA li RANER PALIAR Bee Lhe 16704068 KADEN E ir AN Liter Pietas J PE GE A me amp lagiii Pola eghir Ea OF RLT L mu LonSoret 00000000 State is OF a 449 a4 o4 an a i Of ma 502
169. llMap User Manual Schematic Window 5 Set the Increment by value to determine how much the value increments after each button allocation 6 Click OK All buttons are setup sequentially from the starting source value To use fixed button names 1 Check the Fix button name checkbox 2 Either enter text to fix the button name or select the command radio button and enter a command number for a command that will be queried from the unit If using a command auto fill can be used to set commands for a number of subsequent buttons as defined in the auto fill screen The Name Command Base Offset Source and Destination fields specify the RollCall command number to use to obtain a name Depending on the router type the Base Command Number is added to the Source Value to obtain the full command number or in the case of routers where they have the same command number this value specifies what the command number is Whichever of these is applicable is determined automatically Set up Destination Buttons 1 Select the first destination button button 1 2 Define the full command number in the Command Base Offset field The offset is automatically calculated from this value Alternatively define the Routing Base and define the Routing Command Offset the number to add to the Routing base to obtain the full command number Each destination will have a different command offset incremental from 0 or 1 typically 3 Enter the value in t
170. m Files x86 SAM Rol1lCallSuite Control Panel Rollcall Control Panel exe with various command line parameters appended runonce u Sa See below for explanation of sa On a different PC the RollCall Control Panel could be installed in a different location C Program Files ona 32 bit PC orc Programme ona French language PC or indeed any location chosen by the customer By simply editing the one global search path definition for each PC all of the buttons and other links to the Control Panel are automatically updated appropriate to each installed PC Macros are intended to be case INsensitive So lt control_panel gt should work the same as lt CONTROL_PANEL gt Page 190 2015 SAM RollMap User Manual Issue 6 Rev 1 G 4 G 5 RollMap Parameterization Dynamic Log Field Insertion Everywhere in RollMap that string parameters are entered dynamic data from the monitoring system can be included using the syntax logfieldheader which is replaced dynamically at run time with the current contents of the specified log field header For example by entering the string PSU_1_STATE this is replaced dynamically at run time with the current value of the PSU_1_STATE log field header for the appropriate unit The string values might be OK or FAIL Q What string parameters support dynamic logfield processing A Examples include e Text labels displayed for example static text objects within a schematic design These
171. me Parameter Expanded Path PROGRAMPILES CA Program Files x6 CA Program Files x6 ROLLMAP PROGRAMPILES 4 Snell RollMap C Program Files x86 snell RollMar _ LIBRARY C RollMap Library C RollMap Library E ShMP_LIBRAR Y C RollMap ShMP Library C RollMap ShMP Library PROJECT CARollMap IBC 2012 CARollMap IBC 2012 GENERIC_COMP LIBRAR Y Snell and Wilco Generic Compo CiRollidap Librars3 Snell and Wilce GENERIC_DEVIC GENERIC_COMPONENTS Devices C RollMap Library s Snell and ilc LIBRAR S Snell and Wilcox G Modular C RolllMaptLibraryy3 Snell and Wile y gt Cancel Figure 64 Search Path Setup A macro can be set up so that it can be used in any path field within the schematic or object properties For example Macro definition ROLLMAP C Rol1lMap Use of macro RollMap exe SROLLMAP Schematic sch At run time the above command line expands to Ro11Map exe C RollMap Schematic sch A macro may contain only ONE other macro definition For example TEST SROLLMAPS Test Expanding the macro STESTS becomes C RollMap Test A predefined set of macros is provided for use with the current RollMap component libraries If the Use Search Paths Automatically option is enabled and a path field is entered by browsing the path is scanned and may be reduced by the use of path macro substitutions This allows the target files to be relative to the current schematics and fixed path names can be avoided For this feature to work t
172. n Fonts Priority Address Title Link Hide Below Level Command 1 6000 08 01 01 IQSRTOO srt_details sch E Yellow v Edit 5 2 6000 08 03 03 IQBRT8 B Yellow v Edit 3 16000 08 04 04 IQBRT8 B M Yellow v Edit 4 1000 FF 00 RollPod wes Yellow v Edit New Delete Move Up Move Down V Show Priority Show Address Enable Latching Options Figure 155 Properties window Issue 6 Rev 1 Page 115 O 2015 SAM Schematic Window RollMap User Manual The following options are available The Monitoring List tab enables the address and title to be specified Link Select a schematic link to open when the item is clicked in run mode Hide Below Level Select the warning level after which this item should be displayed in the list options are Never Hide Yellow Red Command Open the command actions dialog box to define triggers commands for this item valid triggers are button press item visible item hidden New Add a new item to the list Delete Delete selected items from the list Move Up Down Move the selected items Up Down in priority Show Priority Display the priority number in the top left of the item Show Address Display the address in the top right of the item Enable Latching When enabled previous alarms remain on display within the widget see Latching below 9 4 8 1 Latching If a unit goes red and then green again whilst the operator is not looking at the screen then the fac
173. n the Schematic WindoW o oo oooooo 97 9 2 8 Opening Schematics in the Same Window 2000 eee 97 9 2 9 Printing A Schemat seps rra rt e dee ee as 97 9 3 Basic Drawing OOS Liar a a A a As 98 Vo Select TOO mina a ri e lidia eee 98 A A ake a Ee eye Re ee A 98 9 3 3 Rectangle lOO esate 2 4604 2 ba oes Meee hay eee maw te de dew pow RSS a 99 9 3 4 Round Rectangle Tool ares tas ara aed des 99 93 5 Ellipse and Circle Tool 1200 dar rara ro aia 99 9 30 Tangle TOOL iii iio ia A gn do A 99 A A sz Bie Su sho ce fv Beam ee rn eho BO Serves Get Hi Bove is Sed 99 SS ase elie eet dh ind ON 100 SEA gio diy bP rd web O O Se ams dude 103 9 4 Advanced Drawing Tools 0 0 cc eee ees 103 9 4 1 Schematic Link Tool 2 22 06 eee 103 9 4 2 Status Control oviductales 106 A mga amea w 4h Gee Riera ee ee Pare aus Saeed a 108 9 4 4 Web Browser Tool 0 00 ccc eee eens 110 9 4 5 Streaming Control Tool 1 2 0 00 ee eens 111 Issue 6 Rev 1 Page 5 2015 SAM RollMap User Manual Contents 346 PIECHA TOOL ata ante dae aes bade eased Get ees Beebe 112 E O A E sila r Mh Edie a A ai te Gt 2S 113 9 4 8 Exception Monitoring Widget 0 0 0 cece ee ee 115 9 4 9 Insert Component 2 0 eee eee eens 117 9 4 10 Load Control Screen Template From Cache 005 118 DSi COMP OMS ALS so mest tics eh sio dh fh gestive lila ce dence ari ends ata Dole 118 9 5 1 Component Documents
174. nents Figure 7 Windows Features Ensure both the Simple Network Management Protocol SNMP component and the WMI SNMP Provider sub component are selected Click OK to continue and install the components To configure the services use the Service Manager under Control Panel gt System and Security gt Administration Tools gt Services File Action es ME 6is Bm gt au p teil Services Local View Help SNMP Service Stop the service Restart the service Description Enables Simple Network Management Protocol SNMP requests to be processed by this computer If this service is stopped the computer will be unable to process SNMP requests If this service is disabled any services that explicitly depend on it will fail to start Name 5 SmartSVN Status ZE SMS Agent Host 4 SNMP Service ZE SNMP Trap a Software Protection 24 SPP Notification 5 TE SQL Active Direct ZE SQL Server SQLEX a SOL Server Agent ce SQL Server Browser DE SOL Server V55 Wr ZE SSDP Discovery DE Storage Service zi Superfetch ck System Event Noti ck Tablet PC Input Se ad Task Scheduler TE TCP IP NetBIOS H DE Telephony 24 Themes Description Provides ch Enables Sim Receives tra Enables the Provides So Enables inte Provides sto Executes jo Provides 0 Provides th Discovers nu Enforces gr Maintains a Monitors s
175. nit Log Unit 0o000 00 01 Log Header PING_STATUS Write to Log C Open RollMap manual Set the IP address of the unit to send the ping command to Define additional text for the success and failure results if required Set the address for the virtual log unit Check the Write to Log checkbox if the result is to be sent to the Log Server so it is visible to other clients Issue 6 Rev 1 Page 49 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap SAM MV Control A SAM multiviewer using the Hydra Open Protocol can be controlled using the commands available on this screen When an action is triggered the command is sent to the multiviewer Actions E Button Press Snell MV Control Target y Snell MY Control MV Address 19 230 36 MY Type Miy 16 Module 0 Multiviewer 1 Command Adjust Border Object Id Video 1 red Virtual Unit for Get Commands Poll Every Secs Comms Timeout 5000 ms Open RollMap manual Figure 52 Snell MV Control The address of the multiviewer can be set as IP FQDN or field specifying the value from another log field Select the type of multiviewer from the drop down list and select the relevant Module Set command type from the drop down list e Adjust border updates the border of an object e Adjust UMD updates the UMD text of an object e Adjust Text Updates the lines in a text object e Get Source Tally Gets the sta
176. nt was logged according to LogServer using its local PC time However this TIME field when viewed by a LogViewer on a PC in a different time zone Wide area network system indicates incorrect local time The second keyword is UCT Universal Co coordinated Time This is a numerical value indicating the number of seconds elapsed since 1st January 1970 LogViewers can use this value to generate local or GMT time depending on its own time zone settings For example If a LogServer in San Francisco California USA is configured to collect information on a network of RollCall units it may generate an entry similar to the one below for an IQD1FPG NAME 01 TIODIFPG 0 ADDRESS 0000 A0 01 TIME Thu Apr 30 10 52 41 1998 MSG Unit present UCT 893929961 EXTREF N A STD 625 SN 270207 The time that the event occurred was Thu Apr 30 10 52 41 1998 This is in San Francisco local time If a monitoring site in Rome Italy was configured to view the same status file as generated by the LogServer in San Francisco then the monitoring site in Rome would also see Thu Apr 30 10 52 41 1998 which is wrong respective to Rome local time In order to adjust for local time anywhere in the world the UCT header keyword should be used instead Each PC should have its Time Zone variable set either by the environmental variable TZ or by setting it within the COMMTROL program See COMMTROL Setting Time Zone If the Time Zone for San Francisco is set to GMT 8 and Rome
177. nual Contents G2 Search Pal a ode eee A eee es ee ey E 189 Gio MaC S amp acute iae a pects 4 Bebra cine Ge etek and id de Sha e ie a 190 G 4 Dynamic Log Field Insertion 0 0c eee ees 191 G 5 Dynamic Data Insertion 0 0 eee eens 191 GO Valles seais a Mesa eee a sas ees 193 G 6 1 Variables replacement 0 0 0 00 ccc eee eee 195 G 6 2 Variables and Addressing 0 00 cece eee eee 195 Issue 6 Rev 1 Page 7 2015 SAM RollMap User Manual Introduction 1 Introduction RollMap the RollCall Schematic Viewer is a companion program to the existing RollCall set of programs for logging and control In addition to a configurable System Alarm window there is a schematic drawing package built into RollMap to provide a visual representation of the network and connectivity of your system Alarms from the units can be assigned to trigger events in objects in the schematic RollMap is a full ActiveX container hence it can use some ActiveX objects registered in the Windows operating system 1 1 RollMap Versions RollMap is available in three different versions RollMap 10 Management of up to 10 RollCall enabled Enclosures ideal for the management of small systems RollMap10 includes the following licenses 1 x Schematic Creation license 2 x Schematic Viewing licenses Prerequisites RollCall Middleware services are required Options RolISNMP is an option with this product RollMap 30 Management
178. of the panel e Routing configure individual source and destination button operation 9 8 8 1 Presets Properties When a new panel is added to a schematic the default Custom type is selected To start the configuration using one of the preset routers select the relevant radio button according to the router type connected to This will configure the correct commands and numbers and will display a default grid size according to the router selected Issue 6 Rev 1 Page 155 O 2015 SAM RollMap User Manual Schematic Window Object Properties Alarm Triggers Addressing Presets Configuration Routing Position Select a router type 5 Vega Sirius 800 Family 16x16 Default 5 1Q5PI Router Ctrl Driver 16x16 Default Options O IQDMX4 IQSRT20 4x1 4 Reset grid sizes 5 IQDMX8 IQSRT21 8x1 Reset button command offsets O IQBRTS IQDRTS 8x8 O IQBRTS IQDATE 6x4 E IQSRTOO 5x2 5 IQSRTIO 8x2 Figure 219 Router Presets Two option checkboxes one to reset the button grid size according to the selected router and one to retain the router command numbers are both checked by default These can be unchecked if the functions are not required 9 8 8 2 Configuration Properties In this tab set up the number of sources and destinations required for the panel and define the format of the router panel layout and the style of each of the elements of the panel Object Properties Alam Triggers Addressing Presets
179. of up to 30 RollCall enabled Enclosures ideal for the management of medium sized infrastructure systems RollMap30 includes the following licenses 1 x Schematic Creation license 5 x Schematic Viewing licenses Prerequisites RollCall Middleware services are required Options RollISNMP is an option with this product RollMapENT RollMap Enterprise Edition offers totally scalable systems management of unlimited RollCall enabled Enclosures RollMap Enterprise Edition includes RollMap Middleware services and RollSNMP It is the best option for customers that wish to implement an integrated monitoring environment for medium to large infrastructure systems RollMapENT includes the following licenses 2 x Schematic Creation licenses 10 x Schematic Viewing licenses 1 x RollCall Middleware license 1 x RolISNMP Framework license 1 x RollMechanic license Issue 6 Rev 1 Page 8 2015 SAM RollMap User Manual 2 Installation Issue 6 Rev 1 2 1 2 2 2 2 1 Installation Prerequisites RollMap requires a fully working version of RollCall Middleware Services to be installed either on the same machine as RollMap or on a network connected machine Without a running RollCall LogServer RollMap has no functionality The recommended configuration is a single dedicated log server PC with one or more workstation PCs running RollMap connected to the server via a TCP IP LAN Only a single log server can collect log data from any RollC
180. og data Example We can define a component to trigger of a log field where the source number is a variable INPUT in this case MeuT_1_EMDODOOO ALGO NUT STATE CECI Pe oa a mn Inge dor Geral Commands Lalo Adra MethodePrceser dor bie fer arg tga 1 Pige Defer Ha ia Pon Lal Meth Frapet lor Tapion MPUT_ _ EMBEDDED AUDIO INFU P Cipion Trigger jet De he AE Hee on Green Heda on het Sat Lpdala Ca wi Dhia on lyen s bdi Delete ee on West fede on Error Figure 4 Dynamic log fields We then include this component in the same schematic twice and override the INPUT variable to hook each instance of the component to different sources Page 194 2015 SAM RollMap User Manual RollMap Parameterization PUT 1 EMBEDDED ALDO Puen on obeon ee pet ste Si yl a ad Component Addressing Fesi venaient Warme meur Figure 5 Overriding the INPUT variable Then when run mode is enabled the same component is used to display the state of different sources INPUT_1_EMBEDDED_AUDIO_1_STATE INPUT_1_EMBEDDED_AUDIO_5_STATE Figure6 Displaying source state G 6 1 Variables replacement The RollMap command line can be used to replace a schematic variable in a schematic or component See Replacing a schematic variable on page 168 G 6 2 Variables and Addressing Variables can be used in the addressing tab of any object to specific an address which is resolved at runtime Resolution is pe
181. ogging Details Snap Shot IDs A Snap shot of current unit IDs and types can be made so that if any unit is replaced and its type does not match the previous snap shot it generates a warning or error for that unit s ID and IDNAME field To take a snap shot select the Configuration gt Snap Shot IDs gt Take Now menu This deletes all previously stored ID and IDNAME overrides and generates a new override for each unit present The current snap shot can be cleared by the Configuration gt Snap Shot IDs gt Clear All Snap Shots menu Enable SNMP RollMap contains a SNMP extension agent that can generate V1 SNMP traps The format of the trap is defined by the SAM ROLLMAP mib A trap can be configured to occur for any state of each log field Individual keyword headers can be configured to generate SNMP traps To enable SNMP traps 1 From the Configuration menu select SNMP The SNMP Configuration dialog displays 2 Select Enable SNMP Traps and then specify the state or states that generate SNMP Traps Page 28 2015 SAM RollMap User Manual Configuring RollMap SNMP Configuration on UNE NOWN Black state Cancel Figure 24 SNMP Configuration See SNMP Setup for RollMap on page 170 4 8 Setup Global Alarm Triggers and Actions Alarm actions can be configured to generate internal alarms or send external messages when a specified alarm
182. om this status file every Status File Poll Time seconds Define the Poll Time in seconds and set a Time out The Status file timeout is in multiples of polling intervals Control Connection The control connection is required for Control Objects See Control Objects on page 120 Set the IP address of the Control Connection The Control Connection is the address of the RollCall Network proxy or chassis That is the same address used to connect the RollCall Control Panel to the network The default Control Connection port is 2050 but a different port can be specified as lt ipaddress port gt or any of the other allowable IP formats If required check the Auto reconnect check box and define a Retry Time in seconds A secondary Control Connection IP may be added allowing redundancy Check the Enable Redundancy checkbox and enter an IP address in the Secondary Address field or select an address from the drop down list When using Control Connection redundancy priority can be given to the primary connection by selecting the Priority Primary radio button Select the Priority None radio button if priority is not required for the primary connection The primary and secondary connections can be controlled from the status bar Right click on the Control part of the status bar to display the control menu JD VEIQARCUU IJARCUU AULA Priority Primary MECO Channel One H Priority None zi EA Er I Prim
183. om within the library All of these are defined based on the IQ search path In this example the link defined to STQS IQAAD00 Device 1A cpt is expanded at run time to the actual file location C WhateverPathYouLike MyLibraryRoot SAM IQ Modular IQAAD00 Device 1 ASC Page 189 2015 SAM RollMap User Manual Issue 6 Rev 1 G 3 RollMap Parameterization But if somebody decided to move the library to a shared network location to reduce maintenance workload or wanted to move the data to the D drive or they could simply edit the one central definition for the LTBRARYS search path SLIBRARYS M SharedLocation NewLibraryRoot and all the thousands of references automatically change to use this new location The link defined to SIQ IQAADO00 Device 1A cpt is expanded at run time to the new file location M SharedLocation NewLibraryRoot SAM IQ Modular IQAAD00 Device 1A cpt RollMap design mode automatically finds the best search path suffix when you browse for a file In the example above if you browsed for the target file M SharedLocation NewLibraryRoot SAM IQ Modular TQAAD00 Device 1A cpt RollMap would automatically find the best matching search path the one requiring the smallest hard coded suffix and insert into the configuration SIQS IQAAD00 Device 1A cpt RollMap does allow a single search path to be defined with multiple destination folders and RollMap searches for the target file within the sequence of target fo
184. ome page SPROJECTS Schematics Home sch Iteml View video in Volicon Observer C 1iProgram Files Internet Explorertliexploresexe 192 168 50 90 monitor php ch Information2 amp time UCT After editing the Configuration cfg file save the changes and restart RollMap To check that the Links menu has been changed highlight a unit in the System Alarms window right click on it and follow the Links entry The Links menu displays as shown in Figure 1 RollMap System Alarms File Edit View Configuration Window Help B a i k E F Ss Physical Metwork le E gt wd RollMap Local Aggregate 0000 b y Network 0001 p y UK LogServer and Proxy Connections 1000 gt y Network 1111 1111 b gt ny UK RollTop Conversion Equipment 1300 b y Network 1333 is my UK Lab LogServer and Proxy connections 2000 p A Stand Alchemist 2300 b y Stand Kahuna 2400 b a Network 3000 gt a Network 4000 t gt y Network 8000 User Network UE la b Ta Mew Filtered Group 1 ES SC_unit b ES Example Location Figure 1 Links Menu D 3 908s ms HODDA Address Unit Mame Local Time ID o Connect to RollCall Panel Load Control Screen Mask Unit Mask Unit Until Green Query State AA an roca contra Highlight Frames View Details Page for this unit Highlights rs View Top level page 13 Select All Cil A View video in Volicon Observer H Copy to Clipboard Ctrl C Full Screen Alt Enter Edi
185. on page 35 Log fields can be used with a Snell General Button See Dynamic Log Field Insertion on page 191 Font Properties The font style size and color can be changed as can the position of the text within the button face Highlight text may be added to change the font properties for when the button is hovered over Object Properties Fonts Alarm Triggers Addressing General Picture Button Style Position Styles Horz Alignment 7 Sample Text Vert Alignment Centre i i Change font Change font colour Escapement Horizontal left to ight Highlight Change highlight fort Figure 178 Font Properties Picture Properties The standard button face can be replaced with a picture The original aspect ratio of the picture can be maintained and the caption displayed over it The button bevel and button background can be removed by deselecting the corresponding check boxes Page 130 2015 SAM RollMap User Manual Issue 6 Rev 1 9 8 2 4 Schematic Window Object Properties Fonts Alarm Triggers Addressing General Picture Button Style Position Picture Picture Keep Aspect Ratio Wl Show Caption On Picture Enable enhanced styling Figure 179 Picture Properties A rule can be added to the button to dynamically display a different picture when the rule evaluates to true based on current log data To enable this option check the enable rule driven picture checkbox and enter the picture and
186. or CauseTrigger ActiveX objects Soh CauseHeader ActiveX objects Sor UserString Yo j Masked State 0 3 FHEADER value of a log field header Other 6H hide command execution Date Time Soyyyy o year as 4 digit MM month as 2 digit odd day as 2 digit oddd short day name ssdddd lng day name 25 MMM36 short month name wMMMM l0ng month name iz b time zone wH gt 24 hour Pom Yo minute 265 second Open RollMap manual Figure 188 Enter Command Line Loading an Internet URL If your system has internet access the button object can be used to access an URL address For example explore www s a m com Header Expansion Variables can be used in command actions to insert column headers For example inserting ADDRESS into the command displays the actual unit address when the command is run Snell State Text laa This object allows an alarm trigger event to be represented as a color text item in a schematic window The global system registered name for this ActiveX object is Snell State Text State Text Box Figure 189 Add Snell State Text To resize the State Text Box double click on the object or select Snell State Text Object gt Properties from the main or context menu to show its properties box Page 137 2015 SAM RollMap User Manual Schematic Window 9 8 3 1 General Properties Page The text color can be set according to the State property of the object If Use State Color is not set t
187. overy enables Auto Discovery mode See Auto Discovery on page 76 Clear Cache deletes all files in the RollMap cache directory Page 61 2015 SAM RollMap User Manual System Alarms Window 5 System Alarms Window 5 1 Description The System Alarms Window is a table made from units in the system and their alarm headers Each entry in the table is a trigger event for an alarm System Alarms Window ir iio ea Configurar Wirriy F i j gt eo P Wm je Ex if io PA Physa Mietensrk dress 3 are Local me 2 IL E els tk MIO gQHIYMJ E INIHSURADE HA E e E PGE OGG O i OHSU E HSA E 10 HILL GALO WB A HUT E DOHA El GH Petrer 0000 a my JAULA S lami Frar PHIL me 01 O00 Ly 6 LS Ep t uh Dia RODI ma Ec CS IQS m Ll MAIGRADE 10AADC Bee 1d 140045 OOO So me LS IDE ARR ee li 16704068 enon Di Mah Litar Pletaora te a GE GE mi legii FL Log im OL AL T DH MALAO me 00 Rs i amp be k fee R atsara i 10 State is OK E 20 j e Lons 00000000 Siah is OF a 449 aa o 43 a 0 a 0 on 502 fo i j Hrgory ne E Uia Pla ree Unit Type Una ddr ers ma S Firiiige A m0 h Ty Init Ad T Shanty 3 na 00011018 Mie Mere 1H 08 05 37 013 z h 0 e nek Local Mebieork Rollbap Local User Network 0000 10 01 Mon Nov 18 07 44 14 2013 NEW FILTERED GROUP Ts PAN et 3 Leal Hrtvenrk RellMap Local Ue Nite 6001 3901 Mon Mor 18 07 44 17 2013 TEST LAB FAlL Agyirgabr bh B3 i QA IOMSTE 4000 0505 Fleas How LE OTSA 2007 POTS
188. ow Configuration aana aa aaa ae eee es 58 4 12 1 Define Target Windows 0 2 cc ees 59 4 12 2 Rules for Opening Schematics 0 0 ccc ee eee 59 A V2 3 RUI Screen OPINAS iaa ai id 59 4 12 4 Manually Display Schematics Outside of the RollMap Window 59 4 12 5 Edit Released Windows 0 00 eens 60 4 13 Configure Shortcut Links 2 0 0 ees 60 4 14 Other Configuration Options 1 0 0 cee es 61 5 System Alarms Window 0 0 00 eee eens 62 vl VSS CTO sarria a dan nD oP bashed Rio di Aia to Se 62 92 GONNE OUM senean OES o o i eee Re ee ee el ao ee ee 62 De IVS UI Seas no cits pd is SO aaa rado 62 Don WAS Dele idad can Sb Meike care aU eae 62 5 3 2 Mask Unit Unmask Unit 1 0 0 0 0 00 ees 63 5 3 3 Mask Unit Until Green nannaa naana bales kel A E Ve ee ss es 63 5 3 4 Mask Unit Until TIME vesi satunse eee 63 5 9 0 Mask Cell Unmask Cells a caccs va imine owes eee es 63 5 3 6 Mask Cell Until Green nannan tees 63 5 3 7 Mask Cell Until Time 2 eee eens 63 5 30 UNMASK Alella a id edhe SG eet he Maced Soa 63 6 4 Query tne Slate 01 a Ui cients aaa rios dicas 64 5 5 Change View Options 0 0 0 0 cee eee eee 64 5 5 1 AQGregale Stale ce a ge eRe Sle Pa a 64 5 5 2 lo plo As ac cese s aoe eens gered a e eet nad ad ae a aaa 64 5 5 3 Auto arrange Column Widths 0 0 0 ce eee 64 5 5 4 Show Error State in Network Tree 1 ee es 65 5 6 Override Keywor
189. path can be entered directly into the Location box Alternatively use a field to look for any other header 5 Select the appropriate radio button for whether the video stream is a file or a network stream 6 If required change the aspect ratio selecting from the options in the drop down list By default the aspect ratio of the source is used If the aspect ratio is changed the target aspect ratio stretches the source to fit No cropping or zooming takes place so the source may appear squashed If the box does not fit black borders are added 7 Click the Edit Schematic button and either save the Schematic or start the video stream RollMap provides the ability to start stop and pause the streams via a command action which can be applied to any trigger including a button press trigger See Configure Alarm Actions on page 35 9 4 6 Pie Chart Tool E This function displays a Pie Chart diagram that takes its values from parameters in the RollCall Log fields It is used to display information for example hard drive capacity levels Mises Mia Hiden Figure 147 Add Pie Chart Issue 6 Rev 1 Page 112 O 2015 SAM RollMap User Manual Schematic Window The Address is the RollCall address of the unit the information for the Pie Chart is taken from and the Trigger is the Log field that is being monitored the values that are output from the log field are used to draw the Pie Charts Object Properties General Font
190. r Setup Options To change the printer setup option e From the File menu select Print Setup The standard printer setup dialog for your printer displays The options that can be specified here depend on the printer 5 9 3 Print Preview To view a preview of the print job before printing e From the File menu select Print Preview This displays the exact layout of the page to be printed 5 9 4 Print To print the contents of the System Alarms window e From the File menu select Print The printer setup dialog displays e Specify any required print options and then click OK to continue Issue 6 Rev 1 Page 69 O 2015 SAM RollMap User Manual 5 10 5 10 1 5 10 2 Issue 6 Rev 1 System Alarms Window User Alarms User Alarm documents can be created to manage smaller numbers of units This can be a subset of the units available from the System Alarms window The Alarm window is split into two windows The left window is the Active state window This shows the current status of user selected units The right hand window is the masked window This shows the status of units that you have masked or have already noticed and wish to ignore Using a combination of viewing masks you can be informed of changes quickly and accurately File Open Close Save and Save As are standard file options for an alarm document Settings for each User Alarm document can be saved with the extension ALM Edit options Cut Copy and Paste from the Sys
191. re READ ONLY so changing the access mode makes no difference to RollMap This however does affect other SNMP devices which may use the same community name but require READ WRITE access The Send authentication trap checkbox allows the basic SNMP system to generate an authentication error trap when an invalid access occurs All other tab controls should be left as default The SNMP Trap Service is not required by RollMap The SNMP Service can be manually stopped or re started but must be running in order for RollMap to generate SNMP traps Both the SNMP Service and SNMP Trap Service can be manually stopped or restarted Issue 6 Rev 1 Page 172 O 2015 SAM RollMap User Manual B 2 Installing SNMP Services for Windows 7 2008 SNMP Setup for RollMap Use Control Panel from Programs select the Programs and Features option Select the Turn Windows features on or off option Turn Windows features on or off To turn a feature on select its check box To turn a feature off clear its check box A filled box means that only part of the feature is turned on Ee Microsoft Message Queue MSMQ Server im Print and Document Services eap Remote Differential Compression dJi RIP Listener DE e Oo Ji Services for MFS di Simple Network Management Protocol SNMP WMI SNMP Provider di Telnet Client A TEMEL pee YEL Hosea di Simple TCPIP services 1 8 echo daytime etc di Subsystem for UNIX based Applications di Tablet PC Compo
192. red add one or more IP addresses for the trap destination location of the SNMP manager If a SNMP manager is to be run on the same computer as RollMap then add the name localhost or the IP address 127 0 0 1 to the list The corresponding SNMP manager must have the same community name configured to receive traps from RollMap SNMP Service Properties Local Computer T The SNMP Service provides network management over TCP P and IPXSPX protocols ff traps are required one or more community names must be specified Trap destinations may be host names IF addresses or IPX addresses Community name public Add to list Remove from list 127 0 0 1 Leam more about SNMP Figure 10 SNMP Services Traps Properties Issue 6 Rev 1 Page 174 2015 SAM RollMap User Manual SNMP Setup for RollMap The Security tab sets up the access modes of the SNMP variables and which sources to accept messages from for SNMP managers Send authentication trap Accepted community names READ ONLY A E aa SNMP ie these hads Leam more about SNIP Figure 11 SNMP Services Security Properties All RollMap SNMP trap variables are READ ONLY so changing the access mode makes no difference to RollMap This however does affect other SNMP devices which may use the same community name but require READ WRITE access The Send authentication trap checkbox allows the basic SNMP system to generate an authentication error trap when an invalid access occurs
193. rformed in the normal way so addresses can be defined at component schematic or global level Alarm Triggers Addressing Position General Commands Object Address Hex Object Address Variable Defer Net 1100 4 Obtain address from variable Variable name UNIT_ADDRESS Figure 7 Specifying the object address using variables This feature enables components to be created which interrogate data from multiple different units rather than being limited to a single unit by using the standard deferred address approach Issue 6 Rev 1 Page 195 2015 SAM RollMap User Manual RollMap Parameterization For example Ta ties Hb aa e 0 281493 agonia Pe PRE ter Phil Hetersrho Ub Piiteri 1000 Piiteri LLII k a Pare Abies Welopsos Cort lea Auron Lera ates E Figure 8 Defining variables on the component for each address 1 First create a component and define component level variables for any customisable addresses mn eee aa bors 28 BS ROOD Pmr PE we Phrasal Meterork tts Httoiri 1000 Htto rie 1130 an ri Pros Doral Commands Obs Area fran Ob Aca daras Dicen kihe bos pirado Warabis rara OMIT ADDRESS Uber Matweork Rapes Bata Dace ib Ree OE Figure9 Configure the objects to use the variable address 2 Add any objects and configure them to use the variable address Within the Alarm Triggers tab you can continue to use the deferred address whi
194. rk 1111 m 4 Network 110 m _ 9 Network 1200 Network 1300 w 49 Network 1333 h PI matarte Jinn Mask for Period of Time Seconds Open RollMap manual Figure 44 Unmask Unit In this window select from the tree which unit are to be unmasked By right clicking on the UnMask Unit action in the actions tree you can use Reflect Action to convert a UnMask Unit Action into an Mask Unit action Page 43 2015 SAM RollMap User Manual Configuring RollMap e Mask Header This action masks a specified selection of header s for a selection of unit s with the option of only masking until they become green Actions J State Trigger Mask UnMask Header Action i pa ny Mask Header All Addresses D Specific Addresses Mask until green Mask for Period of Time Hours Seconds a Open RollMap manual Figure 45 Mask Header In this window select from the tree which headers of which units are to be masked there is also the option to mask until green By right clicking on the Mask Header Unit action in the actions tree you can use Reflect Action to convert a Mask Header Action into an UnMask Header Unit action Issue 6 Rev 1 Page 44 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap Unmask Header This action unmasks a specified selection of header s for a selection of unit s with the option of only masking until they become green Actions state Trigger Mask UnM
195. rs may also be attributed to buttons To set button names 1 2 Check the Fix button name checkbox Either enter text to fix the button name or select the command radio button and enter a command number for a command that will be queried from the unit If using a command auto fill can be used to set commands for a number of subsequent buttons as defined in the auto fill screen The Name Command Base Offset field specifies the RollCall command number to use to obtain names Depending on the router type the Base Command Number is added to the Source Value to obtain the full command number or in the case of routers where they have the same command number this value specifies what the command number is Whichever of these is applicable is determined automatically To set crosspoints 1 Enter a value in the Routing Command field the command number that corresponds to a specific destination Use the Auto Fill button to fill subsequent buttons if required Enter a value in the Routing Value field the command number that corresponds to a specific source Use the Auto Fill to fill subsequent buttons if required In the Define Styling section click on any of the items in the list to display the format styling properties for that item Widget Properties Style Normal Color im Selected Color M Transparent T Opacity 0 255 Roundness 0 100 Border Thickness Border Color Font Family Select
196. rtual unit address xxxx xx xx Rule Show all contents of frames O e Show cards in their frames INFORMATION1 Channel 1 FINFORMATION2 Channel 2 Compiled RPN INFORMATION1 Channeli INFORMATION2 Channel Clear Rule Rule Builder Join Header FAULT amp AND FIRMWARE_VERSION FREQ HARDWARE_VERSION ID IDNAME INFORMATION 1 INPUT INPUT_1_ANCILLARY_TIMECODE_STATE Mm gt v Operator WACA Ai 1 Value String Number Date Time Channel 2 multiple character wildcard single character wildcard Note Enclose strings in quotes pms 5 Insert Figure 98 Rule Added OK Cancel The editor automatically wraps the existing expression in brackets and inserts the new expression 9 Click OK The changes are saved The rule can be manually edited within the edit box to remove brackets or to change the rule If the edit box displays red instead of green the rule is invalid and the syntax should be checked 10 Click OK and the new Filtered Group Channel 1 displays in the User Tree View and it automatically list all units that have their INFORMATION2 field as Channel 01 dl Ca Test Roorn gt E 10 Playout Frame 10 IQH3UM4 S gt E 11 Playout Frame 11 IQH3UM4 5 po 8 Channel 2 i 16 Playout Frame 16
197. rule in the boxes provided The rule and picture can also be edited from the Button Style properties tab Button Style Properties Buttons can have custom designs to enable them to have a specific look and feel On the Roll Button Style Properties Page check the Enable custom design checkbox From here you can change the design of both the unpressed Normal state and also of the pressed state Either a solid color gradient fill or a button shine can be used Or an external image for example a jpeg file can be applied to the button face The shape of the button rectangular through to circular and the opacity may be customized to suit the application Changes in format may be copied to all other button modes by clicking on the Copy style to all button modes button This button is always active for normal mode To copy styles from other modes first check the checkbox for that mode then click on the copy style button Page 131 2015 SAM RollMap User Manual 9 8 2 5 Issue 6 Rev 1 Schematic Window Object Properties Fonts Alam Triggers Addressing General 4 Enable enhanced styling Button Mode Normal LC Mouseover L Pressed Fill Fill Colour A Fill Colour B 5 Maintain aspect ratio of picture Copy style to all button modes Label offset E i Picture Border Opacity 0 255 Colour a Roundness 0 100 Figure 180 Button Style Properties A rule can be added to the button to dynami
198. s In this tab set up the source and destination buttons The Source Value and Routing Commands are used to perform the routing It is also possible to define how buttons are named either queried from the unit or using a fixed button name Use a combination of the drop lists and the Next and Previous buttons to navigate to each button and allocate a name command as required Object Properties Alarm Triggers Addressing Presets Configuration Routing Position Destinations Previous Next fo to Fal Fix button name Name Command Base Offset Source Value Source Destination Figure 232 Routing Properties Set Up Source Buttons Routing Command Offset po Auto Fill Command Base Offset Fix button name Command Bases Routing Base js e Protect Base To set buttons numerically using auto fill 1 Select the first source button button 1 2 Seta source value from which the routing should begin either O or 1 depending on the router type being configured 3 Click on the Auto Fill button The Auto Fill screen displays Start Value Increment after button s h e Increment by Figure 233 Auto Fill The source value displays as was set in the source value on the main screen and cannot be edited on this screen 4 Set the Increment after value to define how many buttons are to be set with the current fill attributes Issue 6 Rev 1 Page 164 2015 SAM Ro
199. s Values Display Position Input Log Value Address Trigger O Net Unit Port Defers Total Log Value Trigger Address 0000 Net Unit Post Defers O Use Manual Value Label data source Address Net JUnit Fort Defers Figure 148 Values Properties The Value and Total Format Strings set the text label below the chart For example 0 1 sets the value as a floating point number with 1 digit after the decimal point 0 2 returns a value of 2 digits after the decimal point Object Properties General Fonts Values Display Position Pie Colours Value Colour Total Colour Value Format String Value is 30 11 Total Format String Total is 0 11 Figure 149 Display Properties 9 4 7 Meter Tool ZA This function displays an Audio Bar Meter used to display audio values taken from a RollCall Command value such as data from each of the audio output channels in Hyperion Issue 6 Rev 1 Page 113 2015 SAM RollMap User Manual Schematic Window Figure 150 Add Meter Select the addressing components as required Only a single component may be edited at a time select the properties from the menu and enter values as required Object Properties Position Unit Address RollCall Commands Meter Object Address Hex Defer Net VI Defer Unit Defer Port Figure 151 Unit Address Properties Set the RollCall Command or select from the pull down menu then set the minimum and maximum ranges
200. s are initiated when the caption of an object is changed This could be via control panel or an alarm trigger For details of the attributable alarm actions see Configure Alarm Actions on page 35 9 8 3 4 Colors Properties Page Sets the font and foreground colors of the text box Issue 6 Rev 1 Page 138 2015 SAM RollMap User Manual Issue 6 Rev 1 9 8 3 5 9 8 4 9 8 4 1 Schematic Window External Properties This object exposes many properties Only the ones listed below should be used as alarm trigger properties Properties read and write variables External Name Type Valid Values State VT_12 16 bit integer 0 Black 1 Green 2 Yellow 3 Red Caption VT_BSTR text string null terminated string c field UserString VT_BTSR text string r substitution field Table 7 External Properties Snell State Frame This object allows an alarm trigger event to be represented as a bordered frame ina schematic window The global system registered name for this ActiveX object is Snell State Frame Figure 191 Add Snell State Frame To resize the State Frame double click on the object or select Snell State Frame Object gt Properties from the main or context menu to show its properties box General Properties You can set the initial state of the border There are different styles of frames to select rectangular rectangular with variable rounded corners elliptical circular and diagonal lines
201. s object exposes many properties Only the ones listed below should be used as alarm trigger properties Properties read and write variables External Name Type Valid Values State VT_12 16 bit integer O Black 1 Green 2 Yellow 3 Red Caption VT_BSTR text string null terminated string ValueString VT_BSTR text string converted to a real value UserString VT_BTSR text string r substitution field Table 9 External Properties Issue 6 Rev 1 Page 144 2015 SAM RollMap User Manual Schematic Window 9 8 6 Snell Check Box of The Snell Check Box works in a similar way to the Snell General Button but can have two actions states assigned to it To place a check box onto a schematic or component e Click the check box icon in the toolbar Figure 200 Add Snell Check Box Double click on the new object or select Snell Check Box Object gt Properties from the main or context menu to display the properties window 9 8 6 1 General Properties In this General tab enter a name for the check box Object Properties Fonts Alam Triggers Addressing General Picture Check Box Style Position Command line Command Actions Check when 7 0 States Unknown Ook Warning Error O Units Masked Unit s Not Masked Locked O Unblocked Figure 201 General Properties e Click the Command Actions button to open the Actions window to configure the actions of the check box Issue 6 Rev 1 Page 145
202. ser Reports are processed as a background task and may take some time to generate While processing a QC indicator displays on the right hand side of the status bar Issue 6 Rev 1 Page 47 2015 SAM RollMap User Manual Configuring RollMap e Logging Allows the History Current Status tabs logging feature in RollMap to be configured via actions For example a button could be placed on a schematic which enables disables logging Actions Object State Trigger Use this action to alter the settings on the history or status tabs Bene P Logging for example to enable or disable the log file Source History or Status tab Channel One 7 C Program Files 86 Snell RollMap Default log Configure Tab Log file action Disable Toggle Delete File deleted from disk I Clear Removes all data from the log file File remains on disk Open RollMap manual Figure 50 Logging Select a source from the History or Status tab drop down list Determine the action by selecting the appropriate radio button Issue 6 Rev 1 Page 48 2015 SAM RollMap User Manual e Ping IP Address Actions Object State Trigger Bsc P Ping IP Address Figure 51 Ping IP Address Configuring RollMap Address IP Address Ve SE YF wy a ms 2 Poll Every seconds Timeout Result Strings Define success and failure strings i Test Debug Received response Received from 172 31 9 1 Shown in Log Header Virtual U
203. sing this feature a custom user interface can be created enabling the unit to be monitored and adjusted as required from the schematic viewer To add control objects to a schematic With a schematic open in Drawing Mode from the Network List on the right right click the unit from which to download the template and then select Load Control Screen es RollMap Schematici File Edit View Configuration Window Help De 400889 ALE A x Physical Network EB E p ny UK RollTop Conversion Equipment 1300 A b ny Network 1333 p ch UK Lab LogServer and Proxy connections 2000 E A Stand Alchemist 2300 I b y Stand Kahuna 2400 4 y Network 3000 E E Connect to RollCall Panel Ge 26 J Ge 37 IC ime 38 11 Details gt e 39 Ie Load Control Screen 3A 1 E Mask Unit E 36 1 T gt Mask Unit Until Green 4 y Network Query State a 05 K Links Eg m i Rename M User Network es E E Show Slot Numbers in Decimal b ES Ted Lab Show Error State ES a Contract All gt Ea Example Expand All Selected History Contract All Selected Unit Name Unit Type A IQH3UM4 Tims Fram IQH3UM4 Figure 164 Load Control Screen Issue 6 Rev 1 Page 120 2015 SAM RollMap User Manual Issue 6 Rev 1 Schematic Window The unit s template is downloaded and a window displaying the unit s RollCall control panel is displayed To add a control to the schematic drag any item from the template display and drop it on to
204. specified unit where HEADER is the header keyword and NNNN UU PP is the RollCall address of the unit maskcellallunits HEADER Masks a cell on all units where HEADER is the header keyword maskcellallunitsuntilgreen HEADER Masks a cell on all units where HEADER is the header keyword until green unmaskcellallunits HEADER Unmasks a cell on all units where HEADER is the header keyword snmp NNNN UU PP UnitName D DName EventTime EventState LogMessage This causes RollMap to generate a SNMP trap in the format specified by the ROLLSNMP MIB The fields are as follows e NNNN UU PPStandard RollCall unit address e UnitNameASCIl name of unit e DUnique ID of unit type 1 to 65535 IDName Corresponding type name for ID EventTimeASCll display of time of event For example Tue Feb 20 12 00 01 2003 Issue 6 Rev 1 Page 166 2015 SAM RollMap User Manual Issue 6 Rev 1 RollMap Command Line Parameters EventStateNumerical value indicating state of event 0 is UNKNOWN 1 is GOOD 2 is WARNING and 3 is FAILURE e LogMessageRollCall log message that generated this event For example INPUT LOST All fields must be comma separated and hence the fields themselves must not contain commas Any field that contains a space must be enclosed by double quotes Example snmp 0000 50 05 DA5 56 IQDVDA Wed Feb 21 12 00 00 2003 3 INPUT LOST maxframe This maximizes the whole RollMap window minframe This minimi
205. t Enter to toggle between fullscreen mode and normal mode Previous Next Ga gt Selects the previous or next non minimized template The order of selection is the same as the order in which the templates were opened Page 14 2015 SAM RollMap User Manual Issue 6 Rev 1 General Operation 3 3 Customize Screen Layout and Color Theme 3 3 1 The size and position of the component windows within the screen may be changed to suit a particular application Tool bars can be configured to show only those items that are being used Choose from the dark and light color themes according to preference Any changes to the windows and toolbars are saved on closing RollMap and are restored automatically when reopening the application The layout settings are stored in an external file that if required can be copied to other RollMap clients to give a standard look across clients or a number of alternative layouts can be saved in other folders and restored depending on the application To reference an alternative saved layout file in the Configuration cfg file enter the following line inthe Rollmaster section LayoutFile insert the path of the saved file Layout xm1 Docking Windows The Network Tree and User Tree windows and the History and Status Tabs are dockable windows Dockable windows can be arranged to suit working practices Windows can either be floating windows or docked in different positions around the working area
206. t Header HE Hist ory De tails Unit Name Window Unit Address A IQH3UM4 5 Tims Fram JASUR 2400 05 00 A IOH3UM3 E IOH3UM3 E 2300 39 00 Setting up the INFORMATION2 Log Field A Volicon Observer system is normally set up to monitor four video feeds A Hyperion enabled card IQSDA02 or IQHIP00 monitors the video then the feed goes on to the Volicon Observer system Volicon Observer can only integrate Hyperion cards that have a specific log field enabled INFORMATION2 When integrating the systems the standard convention is to edit the INFORMATION2 field on each I QSDA02 or IQHIPOO card and set to Channelxx where xx identifies a number i e Channel01 Channel02 Channel04 etc To set up the INFORMATION2 log field open the RollCall Control Panel of the Gateway card hosting the Hyperion card Navigate to the relevant Slots dialog page and edit the 2nd Information Field For more information refer to the IQH3 chassis operator s manual Issue 6 Rev 1 Page 180 2015 SAM RollMap User Manual Issue 6 Rev 1 D 4 D 5 Integrating RollMap with Volicon Observer Setting up the RollMap History Tabs For each Hyperion card monitoring a Volicon channel create a History Tab anda Complimentary Tab It is important to set up both a History Tab and a Complimentary Tab The Complimentary Tab will display the current alarm any non green event while the History Tab records the last changed state and its duration To make using
207. t schematic Go to the home schematic Opens an on screen keypad for touch screen use only Login Logout Schematic Lock Unlock Move and pin the navigation bar to a different part of the screen oOMRGooRS Click and hold the pin to move the position of the navigation bar Click on the pin to fix the navigation bar to the current position on the screen Once fixed the navigation bar does not fade Page 91 2015 SAM RollMap User Manual 9 2 4 9 2 4 1 Schematic Window The transparency of the navigation bar when not fixed can be changed so that it is partially visible when not being hovered over e Right click anywhere on the navigation bar to display a menu and select the transparency level required from this menu Setting Document Properties To set the general document properties double click on the background of the schematic window or if the properties box is already visible just click on the background of the window General Properties The border fill color and fonts properties are used as default values for new objects that are added to the schematic The background color of the schematic window can also be set Document Properties Fonts Grid Settings Background Picture Address Workspace Control Level Authorisation Levels dE E Line Border Style Colour Fill background colour Weight 2 3 Transparent fill C Line border colours Background colours Figure 115 General
208. t that an error occurred is not visible to the operator This is the purpose of the latching option When this option is enabled a second list appears below the first and displays all previous alarms until they are acknowledged by the operator Exception Monitoring Latching Options Latching display options Caption Previous Alarms 4 Display date time and duration of error Unit Limit Maximum number of errors to keep for each unit Total Limit Maximum number of errors to display in list Unlimited Enter O Cancel Figure 156 Latching options The following options are available Caption The caption to display above the latched alarm list If empty the list consumes this space Ordering The order in which the latched alarms are displayed Address Date Time Priority or Severity Note that the order is used in conjunction with the Unit and Total Limit options in order to decide which items to remove Display date time If enabled the date time of when the error occurred and the length of time it was in the error state is displayed at the bottom of the latched item Unit Limit The total number of latched errors to display for any given unit For example to only display the fact that an error occurred for a unit set this to 1 Total Limit The total number of latched errors to display in the list The limits can be disabled by entering O as the value Issue 6 Rev 1 Page 116 O 2015 SAM RollM
209. te of a tally for a source e Get Version Gets the version of firmware running e Load Layout and Update Loads a layout and send it to the screen e Set Source Name Sets the name UMD for a source e Set Source Tally Sets the state of a tally for a source The arguments table immediately below the command type dynamically updates according to the command type selected Arguments can be entered as fixed strings or fields specifying the value from another log field using the deferred unit address or address override syntax field Page 50 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap The result of the GetVersion and GetSourceTally commands can be set on the virtual log unit e Get version creates fields MV_FIRMWARE_VERSION and MV_OS VERSION e Get source tally creates MV_TALLY_ SOFT1_SRC_ N MV_TALLY SOFT2_ SRC_ N and MV_TALLY_HARDWARE_SRC_ N where N is a numeric source id Check the write to log server checkbox to send the virtual unit and headers to log server so they are viewable in other clients Poll causes the action to be repeated when the action is placed on an auto trigger Set a poll interval time accordingly Comms timeout specifies the network timeout communicating with the MV Set the timeout in ms Streaming Control A streaming control allows a video stream to be controlled using the Play Pause and Stop actions Actions Button Press Stream Control
210. tem Select the Multi window Configuration option from the Configuration menu Multi display Settings schematic Display settings Y Cpen details schematics in a separate window Target Window Note Details schematics contain both SU and a SN in their path Target windows by folder schematic name Pattern TR WM Enable when opening schematics via command line Define Target Windows Mame Description Details Default details wind Full screen Options O Disable full screen for released windows Disable full screen for released windows if more than one displayed O Enable full screen for released windows always Figure 66 Multi display Settings Page 58 Open Delete Cancel 2015 SAM RollMap User Manual Issue 6 Rev 1 4 12 1 4 12 2 4 12 3 4 12 4 Configuring RollMap The following can be set from the dialog e Target windows names and locations e Rules specifying which schematics to open in which window e Actions upon selection of full screen mode Define Target Windows A Details window is always present and cannot be removed However its location and description can be edited Configure further target windows in the Define Target Windows section Enter a name and a description for a new window Click on the Add button The name and description are displayed in the title bar when opened The dynamic strings N and U can be used in the description If this
211. tem Alarms window can be used to aid editing of the alarm document Configuration options are the same as those available in the System Alarms window Set up an Alarm Document To create a new User Alarm document e From the File menu select New The New File dialog displays New File Llser Alarms ser selectable alarm list alm achematic Editable schematic sheet sch Component Editable schematic component cpt Figure 80 New Alarm Document Select User Alarms and then click OK The default list of units and column headings reflect those available from the System Alarms window Unit State The left hand window indicates the active state of the units and the right hand window indicates the status of masked units Each window has a viewing mask for each of the states Click on the right hand mouse to bring down a context menu The drop down menu has options to view Errors Warnings Unknowns and OK states Address Unit Mame Local Time Address Unit Mame Local Time O7 ODAWM B M 0000 0F 07 State is OK 454 94 44 0 00 Qo Wz Figure 81 Unit State Page 70 2015 SAM RollMap User Manual Issue 6 Rev 1 5 10 3 5 10 4 5 10 5 System Alarms Window Mask Unmask Units An item can be masked by selecting a mask menu option or by selecting the unit and then dragging it across to the masked window right hand window Unmasking a unit is performed by selecting one of the unmask options or
212. the object and drag the desired size or select Properties from the main or context menu and select the Position tab From here a size and position may be entered numerically 9 8 7 2 Commands Properties The Commands properties tab allows Alarm Triggers and Alarm Actions to be configured Click the Edit Actions button to open the Actions window Actions Add Delete Open RollMap manual Close Figure 217 Actions Issue 6 Rev 1 Page 154 2015 SAM RollMap User Manual Schematic Window The following triggers can be specified for a Snell Roll Clock Object e Object State Trigger actions initiated when the state of the assigned unit changes e Auto actions are initiated when either e aschematic containing the object with the auto trigger is loaded or goes into Run mode from Design mode e RollMap starts if in global alarm For details of the attributable alarm actions see Configure Alarm Actions on page 35 9 8 8 Snell XY Router Panel xy This object allows an XY router panel to be added to a schematic window The XY router panel can be configured and the display of the panel adapted as required Figure 218 Default XY Router Panel In addition to the normal alarm triggers addressing and position properties there are three properties tabs relating to the setup of the router panel e Presets quick setup for each of the basic router types e Configuration define the number of buttons and the layout and style
213. the tabs easier mask any event that you are not interested in See Auto discovery mode is disabled if you change the unit list manually and on startup of RollMap on page 76 Working with Volicon Observer Volicon Observer records video and allows review of previous material using a TIMECODE key To view an event with Volicon select the event from either the History Tab or the Complimentary Tab Right click and navigate to View video in Volicon Observer This opens the Volicon viewer at the specified TIMECODE event Page 181 2015 SAM RollMap User Manual Virtual Units Appendix E Virtual Units E 1 E 2 E 2 1 E 2 2 Issue 6 Rev 1 Overview Virtual units are used in number of different ways e Reporting of aggregate states from the User Network Tree e Receiving data from the Get SNMP action The virtual units and their virtual headers can be treated in exactly the same way is real units and headers You can use them in Alarm Actions History Tabs etc Troubleshooting Cannot see virtual unit in User Alarms View Check that they have been added to the Unit List Cannot see the virtual header in User Alarms View Ensure that you have either added the column manually to the User Alarms View or have run Create All Headers Page 182 2015 SAM RollMap User Manual Rules Engine Appendix F Rules Engine F 1 Overview The rule editor allows you to create complex expressions based upon data from units and their log
214. thumbnail server e Enter the IP address in the Primary Address field in the Thumbnail Server Connection section To add a redundant server e Check the Enable Redundancy checkbox and enter an IP address in the Secondary Address field or select an address from the drop down list When using Thumbnail server redundancy priority can be given to the primary connection by selecting the Priority Primary radio button Select the Priority None radio button if priority is not required for the primary connection The thumbnail server port can be specified in the Windows registry at this location HKEY LOCAL_MACHINE SOFTWARE Snell amp Wilcox ThumbnailService RollMapPort 4 2 Set up the Unit List The Unit List specifies which unit s alarms to monitor This is usually the list of units available from the current status file To set up the Unit List From the Configuration menu select Unit List The System Alarms Setup window displays ON System Alarms Setup setup File C Program Files xd6 Snell Rollkdap Configuration UnitLlist ctg Available Units Units to view 0000 00 00 LogServer A Up 1000 00 00 0000 00 01 RM LT DNH MR 03557 1100 08 00 0000 01 00 Rack 1 1100 08 01 0000 02 00 Rack 2 Add all 1100 08 03 Rack 3 Rack 5 Rack 4 0000 0F 00 lQH3UM4s 1100 08 08 0000 0F 01 OIOCBRG 1100 08 09 oe O000 0F 02 0ZIQCBRG 1100 08 04 0000 0F 03 IOCERG 1100 10 00 O000 0F 04 o41OCBRG 10 ANAN NF NS NFIQCRRG AE
215. tion that is recorded on the tab in the Window Type section select either History or Current Status Address Range or Ranges Specify the address range or address ranges that are shown on the tab To add an address range enter new start and end points for the range as required or click to browse Then click Add To change an address range select a range from the list and then in the fields below the list enter new start and end points for the range as required or click to browse To delete an address range select the range from the list and then click Delete Click OK to save changes to the properties and close the window or click Cancel to close the window with out saving A new tab can also be created by right clicking in the User Tree section of the Network Tree window and selecting the Create Tab option From here an auto named History tab or a Current Status tab can be created Page 82 2015 SAM RollMap User Manual Issue 6 Rev 1 8 2 3 8 2 4 8 2 5 History Tabs History Tab Properties Window Mame Window Type Channel Cnel Non Masked Masked GAI selected Address Hangels start 0000 00 00 FFFF FF FF Figure 101 History Tab Properties Move Tab Order Left Right Use these options to rearrange the order in which the tabs are displayed To move a tab to the right right click on it and select Tab Configuration gt Move Tab Order Right To move a tab to the left right click on it and select
216. to GMT 2 then the LogViewer in San Francisco automatically converts the UCT value in this example 893929961 into the ASCII string Thu Apr 30 10 52 41 1998 The LogViewer in Rome converts the same UCT value to Thu Apr 30 20 52 41 1998 The LogViewers also have the options of showing the UCT value in GMT time which is identical for both sites Thu Apr 30 18 52 41 1998 GMT Special Keyword Headers Keyword headers can be overridden in the unit list See Override Keyword Headers on page 65 Page 23 2015 SAM RollMap User Manual 4 3 4 4 4 4 1 Issue 6 Rev 1 Configuring RollMap Set the Global Time Format The global time format defines how the Time stamps display in the History Toolbar e From the Configuration menu select Time Format The Global Time Display Format screen displays Global Time Display Format O Show time as Greenwich Mean Time GMT Display Format oe bd HAM eo 26 Y 72a Abbreviated weekday name 245 Full weekday name zib Abbreviated month name 8 Full month name 2C Date and time representation appropriate for locale 20 Day of month as decimal number 01 31 eH Hour in 24 hour format 00 23 zal Hour in 12 hour format 01 12 25 Day of year as decimal number 007 366 zam Month as decimal number 01 12 ohd Minute as decimal number 00 54 zap Current locale s 4 M P M indicator for 12 hour clack eo second as decimal number 0
217. trigger occurs To access the alarm actions setup dialog e From the Configuration menu select Alarm Actions The Actions dialog displays If no actions have been previously configured this screen will be blank Actions Delete Open RollMap manual Figure 25 Blank Actions Screen Issue 6 Rev 1 Page 29 2015 SAM RollMap User Manual Issue 6 Rev 1 Configuring RollMap 4 8 1 About Alarm Triggers Alarm triggers are the specified events that initiate an alarm action The alarm triggers that can be specified in the alarm window are State Trigger initiates the specified alarm actions when the state of specified units on the network changes Logserver Lost Trigger initiates the specified alarm actions when the connection to the log server is lost Control Connection OK Trigger initiates the specified alarm actions when control connection changes to an OK state Control Connection Warning Trigger initiates the specified alarm actions when control connection changes to a Warning state Control Connection Lost Trigger initiates the specified alarm actions when control connection is lost Auto trigger initiates the specified alarm action when RollMap is started Time Based Trigger trigger initiates an alarm after a defined period of time See Configure Alarm Triggers on page 32 4 8 2 About Alarm Actions Alarm actions are the actions that are carried out when the alarm trigger event occurs They incl
218. ude Command Line executes a specified command line Macro runs a specified macro command Play Sound plays a specified wav audio file Send RollTrack sends a specified Roll Track command Get RollTrack gets a specified RollTrack command The way that the action is handled can be configured Send Message sends an email message Send SNMP sends an SNMP message OID set Get SNMP executes a specified SNMP get Mask Unit masks specified units UnMask Unit unmasks specified units Mask Header masks specified headers of specified units UnMask Header unmasks specified headers of specified units Login prompts for user login Logout logs out of the current schematic Lock locks all schematics Unlock unlocks all schematics Toggle Lock provides a panel lock and unlock function for when the alarm trigger is activated or deactivated Page 30 2015 SAM RollMap User Manual Configuring RollMap e QC Report configures a report from an existing history or status tab Report can be output as HTML XML or CSV format e Logging allows the History Current Status tabs logging feature to be configured via actions e Ping IP Address sends a ping command to an IP address and returns a pre defined result which sets a log field SAM MV Control control a SAM multiviewer using the Hydra Open Protocol Streaming Control control a video stream play pause stop See Configure Alarm A
219. ue 6 Rev 1 Page 104 2015 SAM RollMap User Manual Issue 6 Rev 1 Schematic Window At runtime the address entered here replaces the default address specified in the schematic Any changes made to the schematic file is automatically applied to all uses of the schematic for different units and addresses Link tool mode allows for setting a link directly to another named schematic returning back to the previous schematic or stepping forward to the next schematic In Run mode selecting the schematic object opens a window with the assigned schematic document If that document is already open it is moved to the front of all other windows The State Actions properties page allows Alarm Triggers and Alarm Actions to be configured Object Properties General Fonts Schematic Unit Address State Actions State Pictures Figure 132 State Actions Properties Click the Edit Actions button to open the Actions window Actions C State Triper Units to Mask UnMask GH Mask Unit WP Network 00 m Network 01 w _ 9 Network 1000 a 9 Network 1100 e 9 Network 1111 m Network 11F0 E C a Network 1200 a 4 Network 1300 e Network 1333 ES un A Noha anna Mask Until Green Mask for Period of Time Duration Days Hours Minutes Seconds Open RollMap manual Figure 133 Edit Actions Page 105 2015 SAM RollMap User Manual Issue 6 Rev 1 9 4 2 Schematic Window The followin
220. w its properties box General Properties This tab enables the button caption to be entered and provides access to the command actions Page 128 2015 SAM RollMap User Manual Schematic Window Object Properties Fonts Alam Triggers Addressing General Picture Button Style Position Caption Command line Command Actors Figure 176 General Properties Click the Command Actions button to open the Actions window Actions Select Macros to be run OO GENERIC EMAIL LT CONTROL_PANEL OCReportstylesheetO OCReportstylesheetl Edit Macros Open RollMap manual Figure 177 Actions Window The following triggers can be specified for a Snell General Button Object State Trigger actions initiated when the state of the assigned unit changes Button Press actions initiated when the button is pressed e Auto actions are initiated when either a schematic containing the object with the auto trigger is loaded or goes into Run mode from Design mode Issue 6 Rev 1 Page 129 2015 SAM RollMap User Manual Issue 6 Rev 1 9 8 2 2 9 8 2 3 Schematic Window e RollMap starts if in global alarm e CheckBox Checked Press actions are initiated when a checkbox is pressed when in checked state e CheckBox Un checked Press actions are initiated when a checkbox is pressed when in unchecked state For details of the attributable alarm actions see Configure Alarm Actions
221. widths to fit all data Page 64 2015 SAM RollMap User Manual Issue 6 Rev 1 System Alarms Window 5 5 4 Show Error State in Network Tree 9 6 5 7 Selecting this option displays unit states in the network tree by placing a dot corresponding to the states color on the object icons Override Keyword Headers A single cell of the System Alarms window can be selected by first selecting the row with the left mouse button then clicking on a cell within the selected row This highlights the cell with a dotted rectangle Right click in a selected cell and from the menu that displays select Override Keyword Headers This cell s state can be given a different set of keywords similar to the overall keywords for the whole column If an override exists for that cell its background color is set by the Header Override Color in the Color setup dia Headings Setup File CurrentHeaders cfg Column Selection log box Column Number fo ADDRESS fo Header keyword MiEnable SNMP trap on change ADDRESS Whe Show only on Warning or Failure Address Exclude keyword s O UCT Field Number Field Text Field Good Green state keyword s Universal Coordinated Time Field Display Format Cyan display keywords if state is Good Magenta display keywords if state is Good Warning Yellow state keyword s Number Field
222. wing triggers can be specified for a Snell State LED ActiveX Object Object State Trigger actions initiated when the state of the assigned unit changes e Auto actions are initiated when either a schematic containing the object with the auto trigger is loaded or goes into Run mode from Design mode Issue 6 Rev 1 Page 127 2015 SAM RollMap User Manual Issue 6 Rev 1 9 8 1 3 9 8 2 9 8 2 1 Schematic Window e RollMap starts if in global alarm For details of the attributable alarm actions see Configure Alarm Actions on page 35 External Properties This object exposes many properties Only the ones listed below should be used as alarm trigger properties Properties read and write variables External Name Type Valid Values State VT_12 16 bit integer 0 Black 1 Green 2 Yellow 3 Red Caption VT_BSTR text string Caption for command line substitution UserString VT_BTSR text string r substitution field Table 5 External Properties Snell General Button This object allows has no alarm trigger facilities It is a general ActiveX button that can be used in a schematic to invoke a command line parameter The command line is passed to the standard MS Window s command line interpreter SNTE E ho al Figure 175 Add Snell General Button To resize the Snell General Button double click on the object or select Snell General Button Object gt Properties from the main or context menu to sho
223. with spaces in them must be enclosed with double quotes If the file name has the extension WAV it is assumed to be a standard sound file and RollMap plays the file through the standard sound device logdata Allows a RollCall message to be sent to the currently configured LogServer The client logging must be enabled and the following text must be a valid RollMap sentence to work correctly Also the source address may be embedded in the message in one of the following formats e ADDRESS XXXX XX XX e or the first characters in the message may be either XXXX XX XX or XXXX XX XX If no source address is found the system sends the message from RollMap Example LogData 2000 29 0C ID 432 NAME FooBar MSG UNIT_ PRESENT MYVAR Hello Replacing a schematic variable The RollMap command line can be used to replace a schematic variable in a schematic or component This is useful if there are a lot of schematics to change at once in which case it is scriptable The syntax is RollMap exe replacevariable VAR_NAME VAR_VALUE FilePath For example Rollmap exe replacevariable IP 0 0 0 0 c testschematic sch If the value contains spaces then include quotes around it Rollmap exe replacevariable VAR_NAME Some String c testschematic sch Page 168 2015 SAM RollMap User Manual RollMap Command Line Parameters Multiple variables can be specified on the same command line by delimiting them with a comma For example Rollm
224. y Enables Tab Enables a us Provides su Provides Tel Provides Us Status Started Started Started Started Started Started Started Started Started Started Started Started mr Startup Type Automatic Automatic Automatic Manual Automatic D Manual Disabled Automatic Disabled Automatic Automatic Manual Manual Manual Automatic Manual Automatic Automatic Manual Automatic LogOnAs Local Syste Local Syste Local Syste Local Service Network 5 Local Service Network 5 Network 5 Network Local Service Local Syste Local Service Local Syste Local Syste Local Syste Local Syste Local Syste Local Service Network 5 Local Syste _ Figure8 SNMP Services Right click on SNMP Service and click Properties Select the Agent control tab and enter a contact name and location Issue 6 Rev 1 Page 173 2015 SAM RollMap User Manual SNMP Setup for RollMap Intemet management systems may request the contact person system location and network services for this computer from the SNMP service Contact Supervisor Location CHQ Service Physical Applications Datalink and subnetwork Intemet End o end Leam more about SNMP Figure 9 SNMP Services Agent Properties Select the Traps tab The default community name is public If required add a new community name For each community requi
225. zes the whole RollMap window details NNNN UU PP This brings up the Details window for the unit at address NNNN UU PP address NNNN UU PP filename sch Overrides the background address of a schematic specified by filename with the specified address Note that the schematic file is not affected so the same file can be opened multiple times with different address overrides replace NNNN UU PP NNNN UU PP filename sch This finds all instances of the first RollCall address NNNN UU PP and replaces them with the second RollCall address The replace option supports wildcard substitution as follows e or can be used in place of any nibble character in the original address preserving the total length of the string pattern to 10 characters e wildcard means don t replace that particular address nibble The total length of the parameter following replace must be 21 characters even when some of the source address nibbles are set to don t replace and the replacement value is therefore unused Only hex digits and wildcard characters are allowed in the pattern command line arguments that do not match this fixed pattern are ignored Any deferred addresses are ignored by the replacement process left as deferred The replace command should come before the schematic path on the command line Example replace 1 8000 00 00 filename sch This command changes any RollCall Networks beginning with 1 into networks beginnin

RollMap User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents