This page describes the formats of the Sound, Band Scan, Script, and Log files created by RMS II.
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
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)
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
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
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
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
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
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