RMS II
Reference B: Data File Formats

(rev. 30-Jun-08)


This page describes the formats of the Sound, Band Scan, Script, and Log files created by RMS II.


Sound File Name

YYMMDDHHMM@SSSSFFFFFBBBLLLL....
0        1         2         3
1234567890123456789012345678901
      
YYMMDD  = Year, Month, Day
HHMM    = Hour, Minute (UTC)
SSSS    = 4-character site code (left-just, blank filled)
FFFFF   = 5-digit frequency; no "." means kHz, with a "." means MHz (right-just, blank filled)
BBB     = 3-character broadcaster code (left-just, blank filled)
LLLL    = 4-character language code (left-just, blank filled)
....    = 4 characters reserved for a suffix (e.g. '.ra')
   
   Examples: 9811201422@VIEN14950VOAENGL
             9811201425@VIEN 98.7VOAENGL
   
   

Sound File Contents

Data Fork:
RealAudio 14.4 data, or RealAudio 28.8 data, or MACE 1:6 data Resource Fork:
'DESC' 128: binary data containing... - version - eventDateTime - siteCode - frequency (always expressed in kHz) - mode - broadcaster - language - relayStation - compressionType 'SNDA' 128: for RealAudio files, a sampling of the sound data at 2 samples per second 'SMTR' 128: same as text lines 2 - n of a scan file (S-Meter readings taken during sound recording) 'SC20' 2020: same as text lines 2 - n of a scan file (+/- 20kHz scan data)

Scan File Name

YYMMDDHHMMºSSSS fffff FFFFF....
0        1         2         3
1234567890123456789012345678901
      
YYMMDD  = Year, Month, Day
HHMM    = Hour, Minute (UTC)
SSSS    = 4-character site code (left-just, blank filled)
fffff   = 5-digit start frequency (right-just, blank filled)
FFFFF   = 5-digit stop frequency (right-just, blank filled)
....    = 4 characters reserved for a suffix (e.g. '.txt')
   
   Example: 9709241428ºBEIJ 9300 9900
   
   

Scan File Contents

Data Fork:
Line 1: YYMMDDHHMMº<sitecode> <startFreq> <endFreq> <step> <passes> <mode> <dwell> <radio> <ADC><cr> Line 2: <sequenceNum>, HH:MM:SS, <SMeterValue>, <freq><cr> ... ... Line n: <sequenceNum>, HH:MM:SS, <SMeterValue>, <freq><cr> Resource Fork:
empty

Script File Name

RMS Script SSSS                   (while in use by RMS Server)
RMS Script SSSS YYMMDD HHMMSS     (after being sent via FTP or E-mail)
0        1         2         3
1234567890123456789012345678901
     
SSSS    = 4-character site code (left-just, blank filled)
YYMMDD  = Year, Month, Day
HHMMSS  = Hour, Minute, Second (UTC)
   
   Examples: RMS Script VIEN
             RMS Script VIEN 970924 142815
   
   

Log File Name

RMS Log                           (while in use by RMS Server)
RMS Log SSSS YYMMDD HHMMSS        (after being sent via FTP or E-mail)
0        1         2         3
1234567890123456789012345678901
      
SSSS    = 4-character site code (left-just, blank filled)
YYMMDD  = Year, Month, Day
HHMMSS  = Hour, Minute, Second (UTC)
   
   Examples: RMS Log
             RMS Log VIEN 970924 142815
   
   

Web Monitoring Schedule (.wsked)

Filename: <anything>.wsked        (text file terminated with the .wsked extension)
   
   Each line in the text file is formatted as follows:
   
<daysOfWeek><tab>HHMM<tab>hhmm<tab><email1><tab><email2><tab><email3><tab><websites><cr>
   
where:
   
<daysOfWeek> is 7 chars SMTWTFS, or a . in that position if that day is excluded
HHMM is the start time; HH is 00-23, MM is either 00 or 30
hhmm is the end time; hh is 00-23, mm is either 00 or 30; and HHMM < hhmm  (Note: for midnight hhmm can be 0000)
<email1> is the 1st email to send the web log to (required)
<email2> is the 2nd email to send the web log to (may be empty)
<email3> is the 3rd email to send the web log to (may be empty)
<websites> is a list of one or more web sites where each web site has 7 fields:
  <siteName><tab><URL><tab><timeoutInSeconds>,<Redirect option>,<Trace route option>,<Num bytes to get>,<Get/Post option>[<tab>|<cr>]  (<cr> if last web site in list)
   
  <siteName> is human readable description of web site (up to 63 characters)
  <URL> is web site url (up to 255 characters)
  <timeoutInSeconds> is a number 1-65535
  <Redirect option> is REDIRECT or NOREDIRECT to either allow or disallow following HTML redirection requests
  <Trace route option> is FORCETRACE or NOFORCETRACE to always perform a trace route or only when necessary
  <Num bytes to get> specifies ALL or the number of HTML page bytes to retrieve. If ALL, the entire page is retrieved.
  <Get/Post option> is GET or POST to perform an HTTP GET request or a POST request
   
   Example: SM.W.FS  1300  1330  joe@voa.gov  jane@voa.gov  bill@voa.gov  CNN  www.cnn.com  90,REDIRECT,NOFORCETRACE,ALL,GET  ABC News  www.abcnews.com  90,NOREDIRECT,FORCETRACE,1000,POST
   
   
   

AutoDownloader Schedule

Filename: AutoDownloaderSked.txt        (text file)
   
   Each line in the text file is formatted as follows:
   
<ON/OFF><tab><bcastrs><tab><langs><tab><locs><tab><fromTime><tab><toTime><tab><DOW><tab><whichWeeks><tab>
  <dloadDOW><tab><dloadTime><tab><CGI URL><tab><FTP URL><tab><FTP filename><cr>
   
where:
   
<ON/OFF> is ON or OFF; OFF tells the AutoDownloader to ignore this line
<bcastrs> is a comma separated list of up to 20 3-character broadcaster codes
<langs> is a comma separated list of up to 20 4-character language codes
<locs> is a comma separated list of up to 20 4-character location codes
<fromTime> HHMM is the start of the time range of sounds to be queried; HH is 00-23, MM is 00-59
<toTime> hhmm is the end of the time range of sounds to be queried; hh is 00-23, mm is 00-59; HHMM <= hhmm  (Note: for midnight hhmm can be 0000)
<DOW> lets you specify which days of the week to include when querying sounds
      (SMTWTFS; use a . to exclude a day; e.g. SMT.T.S to exclude Wed and Fri)
<whichWeeks> lets you specify which weeks to include when querying sounds (ODD, EVEN, or ALL)
<dloadDOW> specifies which days of the week to do the auto-download (SMTWTFS; use a . to exclude a day; e.g. SMT.T.S to exclude Wed and Fri)
<dloadTime> HHMM specifies what time of day to do the auto-download (Note: use 0000 for midnight, not 2400)
<CGI URL> 
For Librarian: the URL of the Player CGI that you want to query (e.g. america.his.com/RMSPlayer/cgi-bin/PlayerCGI.acgi) For RMS Web: the URL of the RMS Web that you want to query (e.g. america.his.com/rmsweb/ui/sound_direct_access.php) <FTP URL> the URL of where to FTP the results of the query (e.g. ftp://user:password@voa.his.com/pub/voa/private/ForCraig/ ) <FTP filename > the name of the file to FTP; must end in .SIT or .ZIP or .TGZ (e.g. VOAEnglHong.sit ) Example: ON VOA ENGL HONG 1300 1600 SMT.T.S EVEN .MTWTF. 2330 america.his.com/RMSPlayer/cgi-bin/PlayerCGI.acgi ftp://user:password@voa.his.com/pub/voa/private/ForCraig/ VOAEnglHong.sit