PROGRAMMING the SAGE ENDEC

By Jim Tharp
    This page has been revised due to  the release of DOS1-6 by Harris/Sage on 9/20/2002 It covers Firmware versions 5.88 thru 5.121.  If you have an older version I do have DOS1-2 but \would suggest upgrading your firmware to at least 5.88.  This was a free upgrade from Harris.
    Getting the Endec ready for accepting and handling the new event codes is a 2-step process.  First you have to get all the new codes in the box, so it knows what they are.  The second step is to tell the box what to do with them. With the second step, we run into the variations of how different stations operate and how they want each event to be handled.  Both of these can be accomplished with one programming session and one download/upload from the Sage.

Adding new codes to the box can only be done with the Sage Software "eprog.exe".  This is an old DOS type program and is a bit clunky, especially to the younger generation who only know how to drive a mouse.   It will get the job done. 

I'll try and walk you through the process as best I can.
    Download - EventCode.zip
 

2.  Unzip EventCode.zip then unzip DOS1-6.zip.  EventCode.zip contains misc files, but you may want to look at "Adding the new event Codes3.doc".   It has similar instructions as shown here on how to get the program "eprog" running.

Now you need to get "eprog" configured so it can talk to the Sage.  This requires a computer with either COM1, OR COM2 and a null modem cable.  You may have to use the front panel buttons on the Sage to set  PORT #1 to DOS @ 9600 baud.  Once in a while I have had to reboot a Sage to get this to work.  You should now be able to down load from the Sage and save it as a file.  I usually use the name  K???.DAT.    You can now disconnect from the Sage and program away at your leisure until you feel you have every thing correct.

3.   Now that we have the File K???.DAT lets sit down and work with it.

Do not change any of the level values.  Assume that someone knew what he or she was doing and set these for proper record and play levels.   This is why you must download and then upload.  A generic file will not have the correct levels and can really screw things up.

The first thing is to pick up the file with eprog and add all of the new event codes.  Here is where the file "new_ev_e.txt" will save you some time.  From the menu choose "<F5>  Import event/location".  When it asks you for a file name give it "new_ev_e.txt".  It then will pick up all the new event codes.
If you need the Spanish version use "new_ev_s.txt.  If you don't like this approach you can use <F3> and type them in yourself.   If you feel you need to add the new Marine FIPS Codes adjacent to your area, find out from your local NWS office what those codes are, and add them using <F4> "New Location"

We now have accomplished the first step.  It now knows all the new codes and possibly the new marine codes  We could stop here and upload everything back in to the Sage.  It would at least know what the new codes are.

4.  Let's proceed and deal with the filters.  Here is where things get a bit tricky.  I usually do a hard copy to see what I am starting with.   I save the program several times as I proceed with the programming.  I usually end up with several versions all with different file names.  The end file is something like "K???4.dat".  The highest number being the latest version

To do a print out use <F7> and create a text file.  I use K???.PRN.  Then exit "eprog" and pick K???.PRN up with an editor like notepad to print it.



There are some basic concepts you need to understand..  The Sage works like a pachinco machine.  When an event is received it first goes to the filter with the highest priority.  If it doesn't match the criteria of that filter it will pass on down to the next.  If it finds a mach it will stop and follow those instructions.    If a new alert comes in while a previous alert is still being processed it has to match a filter with the same or higher priority or it will be ignored.  If it has a higher priority it will displace the current event being processed. With "eprog" you can add, delete, edit filters anyway you wish.  You may choose filter names to your liking. 

You may wish to set the Sage in "Manual Mode" while you have operators on duty and then in "Automatic Mode" while you are automated."  You can do this manually or using the autostart and stop timer.

You can define the Action the Sage will take with the the action codes.  


"Manual Mode"
Automatic Relay       
Sends Immediatly        
Timed Relay             
Gives Operator time to insert in Program but will automatically relay after delay
Timed Ignore            
Only does relay if operator manually tells it to do so. Dicards after "Hold Time"
Manual Relay            
Same as Timed Ignore
Log Only                    
Sends to log and no other action is taken

"Automatic Mode"
Automatic Relay       
Sends immediatly
Timed Relay              
Sends immediatly
Time Ignor                  
Discards alert immediatly
Manual Relay             
Holds alert for "Hold Time"  then discards
Log Only                    
  Sends to log and no other action is taken

The filters with the word "Required" can be edited but you must keep the original name or the box will complain.


Here is a print out of the filters for a fictitious radio station in Pierce Co.  It has operators on duty during the day but after hours and weekends, it is automated.  It has listeners in Pierce, King, Kitsap and Thurston counties.   I have re-organized the filters by priority so you can get a feel of how the priority thing works.  Your printout won't be in this order. 

Depending on location, stations will have different prioities.  This station is in Pierce Co. and deathly afraid of Mt. Rainer.  Therefore Volcanos and Earthquakes are at the top of their list of priorities..  Stations in Kansas would probably be more afraid of Tornados and Thunderstorms.

  
DO NOT COPY THESE FILTERS BLINDLY

This is for a fictitious station.  Give some thought as to how you want the filters to work and what each line does.
  Local Area:           
(053029)  location: Island, WA
(053061)  location: Snohomish, WA
(053033)  location: King, WA
(053053)  location: Pierce, WA
(053035)  location: Kitsap, WA
(053031)  location: Jefferson, WA
'
'
Outgoing:                         
              name: RWT        
        originator: Broadcast or Cable
             event: RWT,Required Weekly Test
     ATTN Duration: 0
             Audio: No Audio
        NV lead in: N 
        crawl only: N 
(-00002)  location: Local Area
               key: 
'

'

Incoming:          
              name: REQUIRED EAN              
        originator: Primary Entry Point
             event: EAN,Emergency Action Notification
             event: EAT,Emergency Action Termination
(-00001)  location: All Locations
          priority: 63 .
            action: Automatic Relay
     ATTN Duration: 8    
         Hold Time: 0    
        NV lead in: N 
        crawl only: N 
'
'
Incoming:
              name: CIVIL-1     .
        originator: National Weather Service
        originator: Civil Authorities         
             event: EVI,Immediate Evacuation      
             event: CEM,Civil Emergency Message
             event: VOW, Volcano Warning
             event  EQW, Earth Quake Warning
(053033)  location: King, WA
(053053)  location: Pierce, WA
(053035)  location: Kitsap, WA
(053067)  location: Thurston, WA
          priority: 60
            action: Automatic Relay
     ATTN Duration: 8    
         Hold Time: 0
        NV lead in: N 
        crawl only: N 
'
'


Incoming:
              name: CIVIL-2    
        originator: National Weather Service                   
        originator: Civil Authorities 
             event: CDW, Civil Danger Warning
             event: FRW, Fire Warning
             event: HMW, Hazardous Materials Warning
             event: LAE, Local Area Emergency
             event: LEW, Law Enforcement Warning
             event: NUW, Nuclear Power Plant Warning
             event: RHW, Radiological Hazard Warning
             event: SPW, Shelter in Place Warning
             event: TOE, 911 Telephone Outage Emergency
             event: TSW,Tsunami Warning
(053033)  location: King, WA
(053053)  location: Pierce, WA
(053035)  location: Kitsap, WA
(053067)  location: Thurston, WA
          priority: 55
            action: Timed Relay
     ATTN Duration: 8    
         Hold Time: 5   
        NV lead in: N 
        crawl only: N 
,
,
Incoming:
              name: ABDUCTION           
        originator: Civil Authorities
             event: CAE, Child Abduction Emergency     
(053033)  location: King, WA
(053053)  location: Pierce, WA
(053035)  location: Kitsap, WA
(053067)  location: Thurston, WA
          priority: 50
            action: Automatic Relay
     ATTN Duration: 8    

    
     Hold Time: 0    
        NV lead in: N 
        crawl only: N 
'
'
Incoming:
              name: WEATHER-1   .
        originator: National Weather Service             
             event: BZW,Blizzard Warning    .
             event: FFW,Flash Flood Warning
             event: HWW,High Wind Warning
             event: SVR,Severe Thunderstorm Warning
             event: TOR,Tornado Warning
(053033)  location: King, WA
(053053)  location: Pierce, WA
(053035)  location: Kitsap, WA
(053067)  location: Thurston, WA
          priority: 45
            action: Timed Relay
     ATTN Duration: 8     .
         Hold Time: 15   
        NV lead in: N 
        crawl only: N 
'
'
Incoming:
              name: WEATHER-2  
        originator: National Weather Service
             event: AVW, Avalanche Warning               
             event: BZW,Blizzard Warning             
             event: CFW, Coastal Flood Warning
             event: FLW,Flood Warning
             event: SMW, Special Marine Warning
             event: WSW,Winter Storm Warning
(053033)  location: King, WA
(053053)  location: Pierce, WA
(053035)  location: Kitsap, WA
(053067)  location: Thurston, WA
          priority: 40
            action: Timed Ignore
     ATTN Duration: 8    
         Hold Time: 20   
        NV lead in: N 
        crawl only: N 
'

'

Incoming:
              name: REQUIRED RMT
        originator: Broadcast or Cable 
        originator: Civil Authorities
        originator: National Weather Service
             event: RMT,Required Monthly Test
(-00002)  location: Local Area
          priority: 35
            action: Timed Relay
     ATTN Duration: 8    
         Hold Time: 15   
        NV lead in: N 
        crawl only: N 
'
'
Incoming:
              name: REQUIRED RWT
        originator: Broadcast or Cable
        originator: National Weather Service
             event: RWT,Required Weekly Test
(-00002)  location: Local Area
          priority: 30
            action: Manual Relay    
     ATTN Duration: 0    
         Hold Time: 1    

      
  NV lead in: N 
        crawl only: N 
'
'
Incoming:
              name: OTHERS     
        originator: ALL
             event: ALL EVENTS
(-00001)  location: All Locations
          priority: 10
            action: Log Only
     ATTN Duration: 0            
         Hold Time: 0
        NV lead in: N 
        crawl only: N 

These are the 6 counties in the Central Puget Sound "Local Area", as defined in the Wash. State EAS Plan.





This is the standard RWT outgoing Template










This is for National Alerts.  Notice that the "Emergency Action Network" has been eliminated.  It is no longer need.


63 is the highest priority that can be entered into the Sage.







This station manager feels that these alerts are of the highest priority for his area.  He is willing to let these be relayed immediatly

NWS provides backup for Civil agencies so NWS is  added as a source.

Notice that here we have just those counties that this station covers.  Thurston Co. is in an ajacent "Local Area", but it is on the list of counties..











Management feels these are important events however  they would like their personel to reviw them if possible.  They have only 5 min. to do it, or they get relayed.
















ATTN Duration, is the 8 seconds of old EBS tones.  It is required anytime there is a voice message embedded in an alert.




This filter is for Abducted Children.  It will be relayed immediatly but we don't want it to displace something with greatter importance.












Here are some weather alerts that are going to be relayed.  It is felt that a little delay for these won't hurt and they may become "News bulletins" if staff is on duity.
















Station management feels these events are not important enough to justify an automatic  relay.  If staff is on duty they may become a "News Bulletin" ,or they may be inserterted into program manually.















This is the standard RMT filter.  Notice that NWS and Civil Authorities have been added as originators.



By setting the priority to 35 we assure that all real alerts have priority over a RMT.







This is the standard RWT filter. 

NWS has been added as a source.



This may look a bit strange.  To show the receiption of a weekly test on the reader board make the RWT filter a Manual Relay with a Hold Time of 1 min.  


This is the catch basket at the bottom.  It assures that all events, even from out of area will end up on the paper tape.




To save paper tape you could eliminate this filter.
 
 


5.   Now that you feel you have every thing correct.  Do a final print out and look it over.  Take your time and have lunch.  Then look at it again.


6.   If it all looks correct then hook your computer back up to the Sage and upload your latest version.  Save the file so if your Sage goes dumb you can reload the program.

7. Reboot the Sage.


Congratulations.  You are done. 
     

Back to Index