flmsg - quick guide

flmsg is a simple forms management editor for the amateur radio supported standard message formats.  These current include:
It's data files are pure ASCII text that can be sent from point to point using the internet, amateur radio, or other electronic link.  The data files are designed to minimize the transfer size.  This is particularly important on amateur HF.  The data file and the transfer file are one in the same, but can be further encapsulated using either flarq or wrap for the purpose of confirming the received file integrity.

The File and Template menus are:

Menu's




File:
New - clear all fields and name the default file "new.f2s" (new.m2s for radiogram)
Open - open an existing file flmsg data files have the extension

".i2s" for IARU form
".203" for ICS-203 forms
".205" for ICS-205 forms
".25A" for ICS-206A forms
".206" for ICS-206 forms
".213" for ICS-213 forms
".214" for ICS-214 forms
".216" for ICS-216 forms
".H203" for HICS-203 forms
".H206" for HICS-206 forms
".H213" for HICS-213 forms
".H214" for HICS-214 forms
".mds" for MARS daily report
".mis" for MARS IN/EEI report
".mns" for MARS net report
".nas" for MARS Army message
".nns" for MARS Navy message
".m2s" read as "message 2 send" for radiogram forms
".sws" for Red Cross Safety & Welfare repotr
".p2s" for plain text, generic forms
".b2s" for blank forms

Save - save the current file to the name in the "file:" display box

Save As - save using a new filename that the user provides

View- write the data to specified type of file

Html delivery - viewed in default browser, contains only those elements sent to final recipient
Html file copy - viewed in default browser, contains ALL fields including record keeping
Text - viewed in default text editor - suitable for CW / Voice transmission

Q-forms

Import - Import the data fields from a Qforms eXtended Markup Language (xml) file

Export - Export the data fields to a Qforms compatible xml file

Wrap (Import / Export / AutoSend)

Import the data fields from a Wrapped data file.  If the data file is corrupt you will be given the opportunity to either allow flmsg to recover as many fields as possible or to view the file using the default text editor.

Export the data fields to a Wrapped data file

Create a wrapped datafile and save in the NBEMS.files/WRAP/auto directory.  If running, fldigi will find and automatically transmit the file.

Template:

Load - load an existing template file -  the default extension for the supported files are:

IARU template - "i2t"
ICS-203 template - ".203T"
ICS-205 template - ".205T"
ICS-205A template - ".25T"
ICS-206 template - ".206T"
ICS-213 template - ".213T"
ICS-214 template - ".214T"
ICS-216 template - ".216T"
HICS-203 template - ".H203T"
HICS-206 template - ".H206T"
HICS-213 template - ".H213T"
HICS-214 template - ".H214T"
MARS daily template - ".mdt"
MARS IN/EEI template - ".mit"
MARS Net template - ".mnt"
MARS Army template - ".nat"
MARS Navy templat - ".nnt"
Radiogram template - ".m2t"
Red Cross Safety & Welfare template - ".swt"
Plain text template - ".p2t"
Blank text template - ".b2t"

Save - save the current form as a template file, using the default (or current) filename
Save As - save the current form as a template file, user provides the filenam

Config:

Open the configuration dialog

Note: data files and template files for ICS213 are identical.  The only difference is their location in the computer directory structure and their extension.  Message files and template files maintain their uniqueness by virture of their file name.  If you reuse a filename the old data will be lost.

File locations:

On XP: C:\Documents and Settings\<username>\NBEMS.files
On Vista: C:\Users\<username>NBEMS.files
On Linux: /home/<username>/.nbems
On Puppy: /root/.nbems
On OS X: /home/<username>/.nbems

Data files are located in the sub directory "ICS/messages"
Template files are located in the sub directory "ICS/templates"
View files (.rtf, .html, .txt) are located in the "ICS/" subdirectory.

Configuring flmsg

There are three separate configuration dialogs for flmsg:
  • Date format - select the date format that will be used for both ICS213 and Radiogram
  • Time format - select the time format that will be used for both ICS213 and Radiogram 
     I think that's the right mix. I suspect NetBeans would
    be much more "helpful" a.k.a. intrusive, but I haven't tried it with
    Autotools code.

    No automated test units.  I test every input widget for correct
    functioning and that a 1:1 correspondence exists to the correct tag in
    the html and text file outputs.  I also test the wrapped file transfer
    between OS types.

    OK - makes sense. AUTs get tricky on pure GUI code. Unless you're
    already MVC or MVVM, there's only so much you can reach with units.

  • Wrap - automatically open the target folder (directory) when the file is exported
  • Naming files - automatic file name generation as:
    CALLSIGN-YYYYMMDD-HHMMSS(Z)-NNNN where
    CALLSIGN is the operators callsign
    YYYYMMDD is year, day, month
    HHMMSS is hours, minutes, seconds local or Zulu at time file is created
    NNNN is an auto incremented serial number
    You can elect to use any or none of the autogeneration components
    Filename extensions are f2s for ICS-213 data, f2t for ICS-213 templates and
    m2s for radiogram data.
  • Radiogram serial numbers can be auto-incremented.  The auto-increment number is also used for the file name.  In the example shown the next Radiogram will be number 104 and the associated file sill be W1HKJ-104.m2s
  • MARS roster file - Callsign entries in the MARS forms is from a combo box that is filled in from a configuration file.  This file is a simple CSV, Comma Separated Value, text file.  An example of it's contents is:

    CALL, LNAME, STATE, BCALL, POSITION
    AAR1AA,LNAME1,VT,,
    AAR1AB,LNAME2,NH,AAQ1EQQ,RS TUV
    AAR1BC,LNAME3,ME,AAQ1ERR,AB CDE

    Note that empty fields are still separated by a comma.  This file can be managed using a text editor or any spreadsheet program.

  • Radiogram format -
    • Fill in the data relating to the originating amateur station
    • # words per line to be used when formating the radiogram message text

Qform data file

flmsg can read and write Qform ICS213 data files.  The Qform data file is larger by virtue of the xml structure.  The file size ratio is less when the content is larger.

Viewing the data in a printable format

The program can produce a viewable document in ASCII text and Hypertext Markup Language (html) file formats.  After creating the document flmsg will request the file to be opened by the default viewer / editor for that type of document.

Html Text Format

The html Text Format file that the File/Write menu item produces can be opened with any web browser program.  Use that software for printing the report.

Command line parameters

Flmsg may be invoked from the command line (or parameters added to the launcher target).
--help
--version
--flmsg-dir "full-path-name-of-folder for all FLMSG folders"
--auto-dir "full-path-name-of-folder for autosend files"
  auto-dir and flmsg-dir can be separate and unique
--p FILENAME - print and exit
--b FILENAME - print and stay open

The --p and --b options are used by fldigi when it automatically opens flmsg to display a received flmsg data file.

The --flmsg-dir parameter is used to change the default location of all of the files associated with flmsg.  This should match with the same command parameter passed to fldigi.  This allows the user to run multiple instances of flmsg / fldigi with each keyed to the other.  For example the user might have separate flmsg/fldigi pairs for HF, VHF etc.  The default is

XP - C:\Documents and Settings\<username>\NBEMS.files\
Vista/Win7 - C:\Users\<username>\NBEMS.files\
Linux/Unix/OS X - $HOME/.nbems/

The --auto-dir parameter is used to further change the name of the folder used to contain the file that is sent automatically by fldigi.  Fldigi's command line parameter --auto-dir must match.  This is in addition to and over rides the --flmsg-dir parameter.  The default is:

XP - C:\Documents and Settings\<username>\NBEMS.files\WRAP\auto\
Vista/Win7 - C:\Users\<username>\NBEMS.files\WRAP\auto\
Linux/Unix/OS X - $HOME/.nbems/WRAP/auto/