jLog Help
for jLog V 6.2

Introduction
Install/Uninstall jLog
Getting started with jLog
   The Main Window
   Setting the User Profile
   Resizing and removing columns
   Adding information
   Entering QSOs manually
   Import existing data using ADIF
   Import existing data in a non-ADIF format
   Saving and opening a file
Menu Commands
   File
   View
   Entry
   Report
   Contest
   Spot
   Tools
   Help
Navigating between and inside windows
Tracking QSLs
   Classic QSLs
   Logbook of The World (LoTW)
   eQSL
The Keyer(s)
The Radio Interface
Register jLog
FAQ

Introduction

jLog has proven to be very stable, but you never know... Adding new functionality can introduce errors. Save copies of your log files frequently, just in case...

jLog is written in Java and can in principle run on almost any platform. Installers have been tested with Linux (Mint 18.3),  Mac OS X (10.13) and Windows (Windows 10).

The User Interface is designed to be efficient, nice and easy to learn. Your comments are invited (mailto:mail@jlog.org).

Install/Uninstall jLog

Minimum requirements

jLog will run on almost any computer that is able to run Java SE 7 or 8 (recommended).

The jLog application uses less than 5 Mbytes of disk space plus space for the database(s). The database file is typically 150 - 200 bytes in average per entry, i.e. 3 - 4 Mbytes for 20 000 entries. Memory usage is typically 17 - 22 Mbytes (depending on configured jLog max. capacity) plus 2 kbytes per entry, i.e. approximately 64 Mbytes for 20 000 entries or 21 Mbytes for 2000 entries.

Install jLog

Installation in two steps:

  1. The Java Runtime Environment, JRE (often referred to as the "Java Virtual Machine" or "Java VM")
  2. The jLog application (with it's configuration data) running under the control of ("inside") the Java VM

Please visit the jLog Installer page on the Web to find updated installation instructions for each platform!

Installation of a JRE

JRE 1.6.0, latest update (note that the newer versions 1.7.0 or 1.8.0 are preferred) is required and must be installed prior to jLog installation. You may download the JREs via the jLog Java download page and take notice of any instructions on that page.

The actual installation should be self explanatory if default values are used.
Take notice of any recommendations on the jlog.org web pages.

Installation of the jLog application

Run the installer according to instructions on the jLog Download page. Installation should be self explanatory for most users and default values should be used unless you know what you are doing.

Uninstall jLog

The jLog Uninstaller is found via a link or in a subdirectory named 'Uninstaller' in the jLog installation directory. It will only uninstall the program files and not the user files, i.e. changed files.

Getting started with jLog

When starting jLog for the first time, two warnings will be issued:

These warnings can be safely ignored at this stage. After loading is completed, the jLog Main Window should appear with no entries shown.

Note that Tool Tips (providing guidance) will appear when the mouse pointer is positioned over most buttons and fields.

The Main Window

An example of the Main Window is shown below using the Java "Metal" Look and Feel that differs slightly from the Mac or "Windows" Look and Feel.

 

The Status Field is continuously updated when the different rows of the Main Window are selected. The Previous Field is also updated and is showing either previous contacts with the same station or the same country (selectable).

Navigate up/down be means of the Up/Down-keys. Open a selected entry by pushing the Space Bar.

The Status Field is automatically updated with the Country, CQ Zone, ITU Zone, Continent and rotor information (direction and distance). The current DXCC status (Worked/Confirmed) for CW and SSB on the 9 HF bands is automatically displayed.

A Search Field is available to initiate searches throughout the whole log for a specific station or country. Wildcard syntaxes like 'SM5*' can be used to find all previous contacts with the SM5 area.

Setting up the User Profile

Select 'Profile' from the 'Tools' menu and as a minimum, fill in the following information:

Misc tab 
Backup directory (folder) Select a (sub)directory to be used for storing copies whenever 'Backup' is activated. Remember to clean up from time to time
Date format Choose the preferred date format
Position at newest entry... Select to automatically scroll to the end of the Log
  
User tab  
Config. name
Configuration name, i.e. the name of this specific combination of Callsign, City, Grid, Rig, IOTA, etc.
Abb. Config. name
A two or three letter abbreviated Id to be used in the Main Log Window
Callsign Normal callsign syntax, e.g. 'XX1XX'
Full name
Your full oficial name (e.g. for use when submitting Contest Logs in the Cabrillo format). Syntax: Given Name + Surname.
 GridsquareThe Maidenhead gridsquare should be filled in (preferably also the more precise Lat/Lon also)
Favorites  
Power Low/High values Set your defaults for the 'Low' and 'High' quick select Power buttons
Favorite frequencies Select three quick select Frequencies
  

Additional attributes are self explanatory or described below (See Tools->Profile).

Resizing and removing columns

First, use the View->Columns command to remove unnecessary columns. Import the current set, remove (and sort) as desired and 'Try" it before saving it as View '1'. Save the current view by issuing the View->Save View->1 command.

Then, in order to adapt jLog to your screen, columns should be resized. Move the cursor to the Main Window column header and place the cursor between two rows (a <-> should appear). Hold down the left mouse button and move the mouse to resize the column. Repeat for all other columns. The STx, SRx, Mult and Pts columns are only used in Contest mode and should be sized to a minimum or preferably removed (see above).

The Previous table will be resized to the same values when jLog is restarted or views are changed.

Adding information

Note that the 'Auto' mode should be turned off if a radio is not used to set Frequency and Mode.

Entering QSOs manually

jLog requires no additional preparation before use. To enter a QSO simply select the 'New' command from the 'Entry' menu. Fill in the applicable data and click the 'OK' button. The entry should now appear in the Main Window. Repeat the sequence for the next entry. To enter multiple QSO without closing the Entry window, enter 'Apply' instead of 'OK' to finish each entry.

Import existing data using ADIF

If you have log data from a previous Log program, data can be imported using the popular ADIF format if the old program supports this. This is the recommended way to import data! jLog has been verified to operate correctly with several other programs.

The default ADIF file extension is '.adi'.

Import existing data in a non-ADIF format

If, and only if, existing data is not available in ADIF format, you should export data in a text format suitable for a Spreadsheet program like Excel. Restructure data using one of these programs and export the modified data in a "comma separated" format, i.e. using Semicolons as a separator as the preferred separator. The sequence of each line of data must be according to jLog's built-in format (all on one line!):

Date;Time;Station;Frq;Mode;Pwr;Conf;Sent;Rcvd;End;Name;QTH;Remarks;S;R;DXCC;STX;SRX;Mult;Pts;
ITU;CQ;ContID;Pfx;Cont;Freq;RXpwr;State;Prov;County;QSL_Via;Age;Grid;QslRdt;QslSdt;Sect;Iota;Prop;
Qslmsg;Satmod;Satnm;Tenten;Addr;Notes;Submode;DOK;OBL;JCC;JCG;BandRX;QRP;SWL;Cmpl;QSO#;
Lat;Lon;eqslS;eqslR;eqslS_Dt;eqslR_Dt;lotwS;lotwR;lotwS_Dt;lotwR_Dt;Rig;Az;El;Eq;FI;MB;MSSH;
Bursts;Pings;Op;Stn;Ownr;Sig;SigInf;Key;Config;Email;S_via;R_via;Q;ud1;ud2;Sp4;Sp3;Sp2;Sp1

Use '.jdb' as file extension to easier find the file from jLog. Use the 'Open' command from the 'File' menu to read the file. Note that this is a risky operation because jLog has not been built to allow manual generation of its internal format. It is assumed to be correct! Enter data manually in jLog, save to a file and inspect the file to verify the syntax.

Saving and opening a file

The default filename used by jLog is 'Logbook.jdb'. Use this as the name for the most frequently used file to be placed in the jLog Home folder.

Menu Commands

The Mac OS X Application menu ("jLog") contains the "About jLog"(see Help->About)  and "Preferences" (corresponding to the "Profile", see Tools->Profile).

File

The commands Open, Save, Save As, Close, Recent and Exit are assumed to be self-explanatory. Other commands are:

Sort

If you import log info from different files with overlapping date/time, the sort command can be used to align the data. Sorting the log other than by Date/Time in Ascending order may be used to get an overview or to save a copy for special purposes.

Backup

This will make a copy of the current file in a predefined directory using a unique name and never overwriting a previous copy. The directory can be selected using the Tools->Profile command. If not set, the jLog installation directory is used. Note that you must manually delete files from time to time to recover disk space!!!

Replace

Replace all occurrences of a given value throughout the log file for either Mode, Frequency, RST Sent or RST Received fields.

Export and Import

Export all entries or only a subset of entries, i.e. selected or queued entries. Queued entries have the 'Q' column checked.

ADIF -adi

The Export and Import commands use the Amateur Data Interchange Format (ADIF) V3 to allow interchanging data with other log programs.

JLog support all ADIF 1 tags and almost all ADIF 2 tags:

ADDRESS, AGE, BAND, ARRL_SECT, CALL, CNTY, COMMENT, CONT, CONTEST_ID, CQZ, DXCC, FREQ, GRIDSQUARE, IOTA, ITUZ, MODE, NAME, NOTES, OPERATOR, QSLMSG, QSLRDATE, QSL_RCVD, QSLSDATE, QSL_SENT, QSL_VIA, QSO_DATE, QTH, PFX, PROP_MODE, RST_RCVD, RST_SENT, RX_PWR, SAT_MODE, SAT_NAME, SRX, STATE, STX, TEN_TEN, TIME_OFF, TIME_ON,
TX_PWR, VE_PROV

ADIF -adx

The Export and Import commands use the Amateur Data Interchange Format (ADIF) V3 to allow interchanging data with other log programs using an XML-format.

Cabrillo

Contest logs should be exported in the Cabrillo V2 format in to a file, typically named '<callsign>.cbr', e.g. 'LA3HM.cbr'.

Some information can be lost when exporting to a '.cbr'-file so preserve the original '.jdb'-file also.

HTML

Export log in HTML format to allow opening in any browser for display and optionally printing. Use File->Setup to select header, columns etc.

JDB

Use Import to merge a jLog database file into another database file. The resulting Log will be automatically sorted as part of the Import.

Setup

Setup configures the XML/HTML output to a Browser. Add a title and select the columns to be included.

Print Setup

jLog will initially make use of the printer defaults, but allows you to save specific setting for orientation and margins.
Note that whether margins are specified in 'cm' or 'inch' is depending on the Profile (Misc-tab) setting for Distance ('km' or 'miles').

Print

You may print the log using this command. It will display a Preview of all pages and "Print" button that will initiate the actual printing.

Properties

The Properties command provides additional data such as the number of entries on the log, a DXCC summary of total Confirmed and Worked and the number of prefixes worked.

Look and Feel

Change from e.g. Windows native to Java Look and Feel under Windows. The last used value is used when restarting jLog. This value is saved in the 'LAF.1' file and can be deleted to start with the system default value.

Linux users can choose the GTK Look and Feel to get better control using System Preferences (e.g. Reducing Font size for Applications from 10 to 9 and Changing Themes Controls to Raleigh and Windows Borders to Crux under Red Hat 9).

View

Find

Perform a simple search through all fields for a specified text string. The search starts at the currently selected row. The search stops at rows containing the specified text. Use Find Next (F3) to continue.

Find Next (F3)

Repeat the previous Find from the currently selected row.

Filter

This allows you to filter the Main Log Window based on e.g. a date range, CW-only and may be most important Configuration (i.e. to see only QSOs from your weekend QTH).

Search

The advanced Search is also available as a Button on the Main Window. Use Search to specify a complex search by combining dates, modes, etc. Note that when entering a date, 'yyyy' is interpreted as '01.01.yyyy'.

Bands

Allows you to select the bands that are actually used for various menus (to make the drop-down menus shorter and more user friendly).

Frequencies

Allows you to select the frequencies that are actually used for various menus (to make the drop-down menus shorter and more user friendly).

Columns

Use this command to tailor the view of jLog to your needs. Three different sets can be stored. Set '1' is always selected when jLog is started. When loading or saving a permanent setting, use the Radio buttons to select the set to be updated. You can also load the set currently used.

Push the User Defined button to choose the columns you prefer to see in the Main Window. You can hide/un-hide these columns like any other column using View 1, 2 or 3 or View All.

Modes

The Mode menu can be tailored; i.e. to only contain the modes you actually use. Select or deselect individual modes. Avoid using Submodes (an ADIF 1+ proposed extension that was never approved).

Contest IDs

The Contest ID menu can be tailored; i.e. to only contain the IDs you actually use. Select or deselect individual IDs.

View 1, 2, 3, All and Save View

The Main Window view is configurable with respect to each column's size, the sequence columns appear in and which columns that are shown. Rearrange columns as it suits you and save the current view as one of three predefined views using the Save View command.

Use one view for normal operation, one for contest operation, etc.

Entry

New

This opens the Entry form to allow entry of new QSOs.

 

Push the Set 'End' button to set the current computer time into the End Time field.

The State/Province field is only valid for US and Canadian callsigns. It lists all States or Provinces respectively.

County is only valid for US callsigns and displays all Counties within the Selected State (above).

Note that fields that are updated automatically are not changeable unless the "Auto" checkbox is unchecked. Power and Location are also considered to not need frequent updating (can be set using the Preset command).

Navigate from field to field using the TAB-key (and SHIFT-TAB to go backwards). The Enter key is used to select OK or APPLY (if this was used to end the previous entry). The idea is to use a minimum of keystrokes and mouse operations.

New entries are backed up until properly saved to the log file. If jLog or the computer suddenly crashes, new entries are read from the backup file the next time jLog is started. The User is asked whether these entries should be added or not.

Use the Prev/Next buttons to quickly navigate from entry to entry without closing the Form.

Open

Open the currently selected entry using the Entry form. If 'Edit' mode is checked, the "Auto" checkbox is automatically unchecked to allow editing. Modified information is shown in red colour. Consider carefully before saving it by clicking the OK button. If 'Edit' mode is unchecked, the entry is opened and changes will be ignored.

Insert

Allows you to insert a new entry in front of a selected row anywhere in the log.

QRZ

Online lookup from QRZ.com of the station of the currently selected row. The information is displayed in a separate window. Use ctrl-F5 to open the QRZ window from the entry window and ctrl-F6 to transfer relevant values.

FCC

Online lookup from the FCC Database of the station of the currently selected row. The information is displayed in a separate window. See http://www.hamdata.com/getcall.html for more info.

QSL MGR

Lookup the station of the currently selected row in the ON6DP QSL Manager database. The information is displayed in a separate window. Download the database file (QSL.FUL) from http://www.dd3kf.de/on6dp.htm.

Submit

Submit one or more selected entries to eQSL. Note that you must be connected to Internet when issuing this command. No specific confirmation will be issued if the operation is successful. You will observe that that QSL Sent will be checked and QSL via is set to eQSL. A dialog box is shown in case errors or warnings are issued by eQSL. Successful submissions are logged to the file 'save/eqsl-log.txt'.

Do not use this method to submit large amounts of data. ADIF export should be used in stead.

Add Remark

Use this command to add the same remark to a number of selected entries.

Goto

Position at the first entry of a specific date in the log.

Preset

Set the default values for Frequency, Mode, Power and Location to be used in the Entry form (see above). Note that the frequency and mode values are not used when a radio is connected to supply this information. The Power and Location values can be set directly or by using the values available using the buttons. The values are used as default values when creating new entries.

Use the 'Set Default' button to save the current values as the new start-up values.

Delete

The last entry entered can be deleted. Note that older entries cannot be deleted!

Hint: To remove an old entry in the log, set the date to a date newer than "today's" date. Sort the log and delete the last entry.

eQSL Submission

Allows submission of selected entries to eQSL. Note that User name and Password must have been setup in the Profile and manual submission must have been enabled.

LoTW Submisssion

Allows submission of selected entries to LoTW. Note that User name and Password must have been setup in the Profile and manual submission must have been enabled. TQSL Path and Location(s) must have been properly setup.

Auto

Set 'Auto' (i.e. "Radio present") mode as the default. Band and Mode are automatically filled in for new entries.

Edit

Check the Edit mode to allow changing existing entries. If unchecked, entries are opened in read-only mode.

Edit S/R

Values shown in the Main Window cannot be changed directly. An exception is the QSL Sent/Received Check Boxes. Check the Edit S/R to allow modifying these values directly from the Main Window.

Set configuration

Mark selected entries as belonging to a certain configuration (defined in the Profile). Configurations can be used to differentiate between callsigns, addresses, rigs, etc.

Set Contest ID

Set the Contest ID value for selected entries.

Map

Open the (experimental) Map to show the location of a selected entry. Note that this entry must contain either a Gridsquare or Position information (Lat/Lon).

QRZ

Lookup information regarding a selected entry from QRZ.com. Note that unless you are a registered, paying customer, only the Name and Country fields will be displayed. An XML license is needed as a minimum and user/password for QRZ must be registered in the Profile.

HamQTH

Lookup information regarding a selected entry from QRZ.com. User/password for HamQTH must be registered in the Profile.

FCC

Lookup registration information for US/CA-calls.

View eQSL

Display the QSL-card from eQSL provided that the "eR" column is checked.

eQSL Submission

Send selected entries to eQSL provided that you are on-line and User/Password for eQSL is registered in the jLog Profile.

LoTW Submission

Send selected entries to ARRL's Logbook of the World (LoTW) provided that you are on-line and User/Password for LoTW is registered in the Profile. Note that TQSL (from ARRL) must be installed onto the computer and related information must be registered in the jLog Profile.

Report

DXCC

Display the detailed DXCC status. The content is assumed to be self-explanatory.

Show

Show all log entries matching a selected country, e.g. to select the entry to be used as proof of contact. The result is displayed in the lower part of the Main Log Window.

OK

Close the DXCC display. Nothing is saved or modified but the displayed status is lost.

Save As

Save data as shown (e.g. with rearranged columns and sorted content) to a file, e.g. to be used by an external Spreadsheet program or a Word processor for further handling.

Sort

Sort the content to get a better view or before saving it to a file by clicking the appropriate column header.

WAC/WAS/WAZ/WPX/USCA/IOTA/VUCC

Display status for the Worked All Continents (WAC), Worked All States (WAS), Worked All Zones (WAZ), Worked all Prefixes (WPX), US Counties Award (USCA), Islands On The Air (IOTA) and VHF/UHF Century Club (VUCC) awards. The Save As commands are described above (under DXCC). Sort by clicking the appropriate column header.

Note that the WAS Report now handles the Primary Administrative Subdivision of many countries (e.g. CA, CH, BE, DE, DK, FR, NL, PT).

Mixed/CW/SSB/RTTY/SSTV/DIG/SAT/EME

Select 'Mixed', 'CW' or 'SSB', etc. to change the view for the different frequencies.

Show

Show all log entries matching a selected state, e.g. to select the entry to be used as proof of contact. The result is displayed in the lower part of the Main Log Window.

Contest

Note that this is experimental functionality only!

Use a separate log file when operating during the contest. This file can later be merged with your ordinary log.

Re-calc

Recalculate Multipliers and Points. Note that a contest mode (e.g. SAC, ARRL, CQWW, etc.) must be selected and Contest Mode turned on before Re-calc is activated. Multipliers and Points are updated in the log and the resulting numbers are displayed in a popup.

On

Turn On/Off Contest Mode (e.g. auto incrementing the Send sequence number).

Contest modes

Set the specific contest modes:

    ... description to be added ...

Setup

Set the current value of the Number series manually. This value is automatically incremented.

Fill in the Contest ID.

Header

Setup the Cabrillo V2 header to be used when exporting a contest log. Save the current values to a file named 'cab-hdr.cbr". Load these values later when exporting a log using File->Export.

Spot

Internet DX Spots (DX Clusters) are handled via Telnet or via the DX Concentrator (DXC) application. DXC must be installed on the same computer as jLog or on a computer accessible via a TCP/IP network (e.g. LAN or Internet). See the jLog Profile for setup.

Log

Open the Spot Log window to overview incoming DX Spot reports.

Visit

Set the frequency of the radio to the frequency of the currently selected entry in the Spot Log.

Connect

Open a connection to the host for receiving spots from the host chosen in the 'Spot' tab in the jLog Profile.

Disconnect

Close an open connection..

Tools

Clock

Show/Hide the Clock by checking this command.

The Clock always displays UTC format.

Keyer

Show/Hide the Keyer using this command.

mini-Keyer

Show the mini-Keyer.

eQSL Sync (Inbox)

On-line synchronization with eQSL.cc to update the status for received cards; i.e. sets the eQSL Received flag for entries corresponding to the current log.

eQSL Import (Outbox)

Import saved eQSL.cc "Logbook/OutBox" file to update the status for sent cards; i.e. sets the eQSL Sent flag for entries corresponding to the current log.

LoTW Sync...

On-line synchronization with LoTW.

US State/County QRZ Web-lookup

US State/County can be automatically looked up from QRZ.com via an Internet connection. The result is automatically entered for all selected entries provided that the callsign is found in the QRZ.com database.

Note: Select an area by first clicking on the start row (i.e. select it). Then, scroll to the last row to be selected, press SHIFT and click on the last row. The whole area should now appear as selected. You can select/deselect a specific row by holding down CTRL and clicking the row. Repeat for multiple rows.

Verify

Checks the currently open Log. The result is displayed in a new Log Window. One or more entries can be selected and opened, edited or made hidden. The latter relieves you of having to see warnings that have already been checked out.

QSO Number

The QSO Number value indicates the next QSO Number to be used for new entries.

Re-number the current log starting with the QSO Number specified (should normally be set to 1 if the whole log is to be renumbered).

Duplicates

Find duplicate entries and optionally remove them. Please note that only the fields Date, Time on, Station, Frequency, Mode, Send, Receive, Time off, Name and QTH are checked.

GeoCalc

Open the Geo Calculator dialog to allow various conversions of Latitude and Longitude values to/from Gridsquare. Note that various forms are accepted, e.g.

are all acceptable, but the latter is used when calculating Lat/Lon from Gridsquare.

QRZ

Lookup information regarding a selected entry from QRZ.com. Note that unless you are a registered, paying customer, only the Name and Country fields will be displayed. An XML license is needed as a minimum and user/password for QRZ must be registered in the Profile.

HamQTH

Lookup information regarding a selected entry from QRZ.com. User/password for HamQTH must be registered in the Profile.

Profile (for macOS: Application menu "Preferences")

See also the description in the Getting Started Chapter above. The Profile is unchanged when installing an updated version.

Misc tab

Home folder should be set to the folder where you keep your log files, etc.

Backup folder should be set to a dedicated folder, preferably on a different drive. Whenever the Backup button is pushed, a copy of the current (.jdb) log file is saved (with a '.tmp' extension). Remember to clean up from time to time.

Backup frequency can be used to make automatic copies of the log at regular intervals. make sure that you have the free space needed for may copies of the log. The interval is calculated from the previous automatic backup or last push of the Backup button.

Date format allows changing between the three formats: yyyy-mm-dd, dd.mm.yyyy and mm/dd/yyyy. The current log is updated when closing the profile.

Distance unit is used to display the distance part of the Rotor information (and will currently also affect Print Preview's choice of unit for margins ('cm' or 'inch').

Position at newest entry after Open will set the initial position to the last entry in stead of the first entry.

Show filename in title makes the filename that is always shown in the Status bar more visible (in case you have multiple copies of jLog running simultaneously).

Config tab

You should define at least one configuration and as a minimum fill in Callsign and Full Name fields. Verify that the Country is correct and also the CQ and ITU Zones in case they are not automatically set to an unambiguous value.

Configurations are typically used to reflect alternative QTHs, but can be used to reflect e.g. guest Operators or Rigs (in case multiple rigs can be used for a given frequency or mode).

Favourites tab

Setup values for Power Low/High buttons and the three Favourite frequency buttons.

Specify the Default signal strength to be used for new entries when no value is filled in.

Source for QSL Status tracking and DXCC Report determines the source and offers the choice between the Paper-based QSL columns, the eQSL columns or the LoTW columns. Note that you will have to re-load (i.e. save and re-open) the log file after changing these values in order for the status to be correct.

Enter values from QRZ offers the ability to fill in values from QRZ after either a fully automatic look-up or a manual look-up. Select the fields to be included. Note that the full QRZ lookup requires you to pay a yearly fee. Enter your QRZ login credentials in the Profile.

Radio tab

Setup the Radio and optional Keyer interface. The Keyer shares the COM port with the Radio. You must check the "Radio present" box even if you use a keyer only (see Radio Parameters in the Radio Interface below).

Port must select the built-in or USB-based serial port to be used. Note that you may have to re-start jLog after having checked "Radio present" in order to see any entries in the "Port" drop-down menu.

The remaining attributes are used by the Radio. Set the proper baudrate, manufacturer and model. You may have to experiment with different Refresh values and enable/disable the auto refresh depending on the radio model. A to high refresh rate may garble data or block the radio. Icom and Kenwood radios should not need to use auto refresh. They automatically updated.

Modem status is for information only and displays the actual status of the control signals.

Set controls allows you the activate DTR (should normally be activated, specifically if it is the source of power for other modem signals).

Flow control mode should normally be set to RTS ON unless a Keyer is used (in which case "KEYER" should be selected). Use the other alternatives only if your radio manual specifies that RTS/CTS signaling or XON/XOFF is to be used.

DX Clusters ("Spots") tab

Setup Telnet DX Spots (or indirect access via DXC or similar). Choose a predefined Host or specify Address and Port directly. The predefined hosts are defined in the file 'conf/cluster.dat' in the jLog installation folder. You can freely edit this file. The syntax is one host per line specifying  <name>,<IP Address>,<Port>.

eQSL tab

Allows real time or manual logging at eQSL. Successful submissions are logged to the file 'save/eqsl-log.txt'.

Specify the User name and Password to be used. You can make use of multiple IDs at eQSL, e.g. reflecting different Callsigns. eQSL ID can also be linked with a specific Configuration (see 'Config tab above)'. This will override the choice of Active ID in the Profile.

Enable real time logging with the Submit new entries automatically checkbox. When unchecked, entries must be manually submitted using the Entry->Submit command (and the same User name and Password).

Allow manual submission must be checked to allow manual submission using the Entry->Submit (eQSL) command (or corresponding pop-up menu command).

Auto-convert QSL-status for entries marked 'eQSL' in 'QSL Sent Via' field is only applicable when converting a log database file from V 3.x to V4. It allows you to automatically set the new eQSL S/R-fields using the previous combined S/R-fields and the value 'eQSL' in the 'QSL Sent Via' field. Verify manually and clear these "Assume..." fields when they are no longer needed.

LoTW tab

Allows manual logging at LoTW.

Specify the User name and Password to be used. You can make use of multiple IDs at LoTW, e.g. reflecting different Callsigns. LoTW ID can also be linked with a specific Configuration (see 'Config tab above)'. This will override the choice of Active ID in the Profile.

Entries must be manually submitted using the Entry->Submit command (and the same User name and Password).

Allow manual submission must be checked to allow manual submission using the Entry->Submit (eQSL) command (or corresponding pop-up menu command).

Path to TQSL Program must be setup properly.

TQSL Locations (comma separated list) must correspond to the Locations specified in the TQSL Program!

Version tab

You may introduce a warning when using the Help->Check for Updates command if you are not permanently connected to the Internet.

You can control the frequency of checking for updates. If you have a permanent connection to the Internet, frequent checking is recommended to be quickly warned in case a critical update is released; i.e. at least weekly. You can issue the "Help->Check for Updates" command any time regardless of this setting.

Entry tab

Specify how to handle an empty End-time field when closing the Entry form (dialogue).

You can force the Entry form to stay on-top; i.e. not be hidden by any other windows. There is a checkbox at the bottom of the Entry form that allow you to temporarily disable this functionality.

You can configure jLog to automatically fetch relevant info from QRZ.com and fill it into the Entry form. Note that this requires a permanent, fast Internet connection and the "Warn before accessing Internet" checkbox must be unchecked (see 'Version tab' and 'Favourites tab' above).

Fonts tab

Change the size of all fonts in jLog relative to their default size by adjusting the slider. This will be possible with Java 1.4 or newer, except for Linux with GTK.

Alternatively, replace and/or resize individual groups of fonts.

Relocating the Profile

The Profile (consisting of the files 'profile.1' and 'profile.xml') can be placed outside their normal location in jLog's '$HOME/jLog/save' folder. Create the file '$HOME/jLog/save/profile.txt' and insert a single line with the new location path, e.g. '/Users/john/Public/'.

This can be useful for Dual-boot setups, etc.

Help

On jLog

Display the jLog Help file (that should also be available from the Start Menu).

System Info

Display various System information related to the Java environment. Use Save As to save it to a file e.g. for sending it to support@jlog.org when requesting support.

Check for Update

On-line check for new versions. Make sure that you are connected to the Internet when using this command. The http-protocol is used in read-only mode so NOTHING is transferred from your computer! Existing files are renamed and new files added. Note that the main program file 'jlog.jar' cannot be updated directly. You must re-start jLog after downloading the update.

About (for macOS: Application menu "About jLog")

Displays the jLog and Java Versions and the address of the jLog Home Page (http://jlog.org/) and E-mail address ( mail@jlog.org) to be used for Support.

Navigating between and inside windows

The following keys are used for efficient navigation between the windows without using the mouse.

'Alt' + 'm'  or
'Alt' + 'M'
Switch focus to the Main Log window
'Alt' + 'l'  or
'Alt' + 'L'
Switch focus to the Log Entry window (if open)
'Alt' + 'k'  or
'Alt' + 'K'
Switch to the Keyer if open or otherwise the mini-keyer. If neither is open, a new entry is opened and the mini-keyer is started.

The following keyboard commands are available when a log entry has been selected in the Main Log or Previous Log windows:

' ' Open current entry
'e' or 'E' Edit current entry
'z' or 'Z'Switch between Main and Previous lists
'p' or 'P' Switch to Previous list (only available in Main Log)
'm' or 'M' Switch to Main list (only available in Previous Log)

Tracking QSLs

jLog allow for independent tracking of QSLs Sent/Received via

Each of them provide separate columns with checkboxes for sent and received. Make sure that 'Edit S/R' is enabled (i.e. Entry->Edit S/R toggles this flag).

Classic QSLs

QSL Status (S/R) is shown as a checkbox in the main Window. The values can be updated directly by clicking inside the checkbox provided that you have enabled this function. The value Entry->Edit S/R enables/disables this function (also available in the right-click pop-up menu). QSL status can also be updated in the Entry form.

Sending QSLs

If you use an external program to print QSLs or QSL labels, you may want to use ADIF Export to transfer all entries, or selected entries only. Use either multiple row selection or the Queue column. Multiple rows are selected by means of the Shift and/or Ctrl keys (slightly platform dependant). The Queue column behaves just like the QSL S/R columns. The ADIF Export pop-up contains checkboxes to allow only the selected or the queued entries to be exported.

Receiving QSLs

Use of the simple Search field in the Main Window is recommended to easily find the entry when updating the log after having received a QSL card.

Logbook of The World (LoTW)

jLog provides automatic and manual functions for interaction with ARRL's Logbook of The World (LoTW).

Profile

The LoTW User name and password must be entered into the Profile before this service can be used. The LoTW User name and password must be entered into the Profile before this service can be used. You can also choose whether or not to automatically send new log entries or also block manual sending of entries. In the latter case, ADIF Export must be used to transfer entries. The automatic functions obviously requires a permanent connection to the Internet.

jLog makes use of ARRL's TQSL program to sign entries before submission. The path to the TQSL program must therefore be set in the Profile. TQSL makes use of the term location when signing. Make sure that the location values are known in jLog. These values are presented as choices when establishing 'config' values in the Profile; i.e. a given config typically maps to a TQSL location.

Sending QSLs

QSLs are sent to LoTW in several ways

Receiving QSLs

Use the Tools->LoTW Sync command to update the eQSL Received status column.

Updating QSL status

To update the LoTW S/R status columns for previously sent entries, use the Tools->LoTW Sync command. Make sure that the log file corresponds to the LoTW log! Note that this may take a while to complete if the number of QSOs is large. Also note that this will not create new entries at either side. Please observe any irregularities by inspecting the log file 'import.txt'.

eQSL

jLog provides automatic and manual functions for interaction with eQSL.

Profile

The eQSL User name and password must be entered into the Profile before this service can be used. You can also choose whether or not to automatically send new log entries (using the eQSL "Real-time interface") or also block manual sending of entries. In the latter case, ADIF Export must be used to transfer entries. The automatic functions obviously requires a permanent connection to the Internet.

Sending QSLs

QSLs are sent to eQSL in several ways

Receiving QSLs

Use the Tools->eQSL Sync (Inbox) command to update the eQSL Received status column.

Updating QSL status

To update the eQSL Received status column, use the Tools-> eQSL Sync (Inbox) command. Make sure that the log file corresponds to the eQSL log! Note that this may take a while to complete if the number of QSOs is large. Also note that this will not create new entries at either side. Please observe any irregularities by inspecting the log file 'import.txt'.

To update the eQSL Sent status column, use the Tools->eQSL Import (Outbox) command. Prior to this, visit the eQSL Outbox tab and click on the 'Download Log in ADIF format ' link, save to a local file (to be imported in jLog).

The Keyer(s)

The built-in keyer can be used when a radio set is connected to the computer. Two Keyer interfaces are available; the standard Keyer and a mini-Keyer (visible only when adding new entries). Switch to a keyer from Log input using ALT+'k' and back again using ALT+'l'.

Send user defined text using Function Keys F5 to F12 or type in text using the keyboard. All characters represented by the Morse code can be transmitted. In addition, unused characters are used to represent special sequences as follows:

+ KN
& AR
% AS
< KA
> SK
_ EEEEEEEE

The following keys are used to indicate that specific values should be inserted:

* Your own callsign is inserted (as defined in the Profile)
@ The other station's callsign (from an open new entry only) is inserted
$ The 'Sent RS(T)' (from an open new entry only) is inserted
# The 'Send Serial Number' (from an open new entry in contest mode only) is inserted

These characters can be used both in F5 - F12 character strings and typed in from the keyboard.

Keys F2 - F4 are used as follows (may change in the future):

F2 FLUSH transmission buffer (i.e. cancel all transmission)
F3 Increase Speed (same as PageUp)
F4 Decrease Speed (same as Page Down)

The Keyer uses the Radio interface port selected in the Profile. The RTS pin (7) is used for keyer output. Ground is pin 5.

The Radio Interface

A Radio interface module is included with jLog to allow automatic logging of frequency and mode. When a radio is properly connected, the current frequency and mode is displayed in the lower right corner. Click in this field to update the frequency or turn on Auto update in the Profile. Note that older radios may not be suited for automatic update. ICOM radios will always update automatically.

If you do not need the radio interface, turn off the 'Radio present' tab in the Profile.

Setting up communication

Please visit the jLog Web site (installer page) for updated, platform specific instructions.

Physical connection

Please refer to the equipment manual. The following guidelines are valid for my own Icom IC-765:

Using a standard 9-pin D-type female connector for the PC, the Radio need only be connected to pin 2 (TX), 3 (RX) and 5 (GND).

However, pins 1 (DCD), 4 (DTR), 6 and 9 must be interconnected at the computer end. Pins 7 (RTS) and 8 (CTS) must be interconnected if a Keyer is not used. If a Keyer is used, pin 8 must be connected to pin 4 (with 1, 6 and 9) and pin 7 used as output to the Keyer as shown below:

See http://www.qsl.net/g3vgr/civ.html for a suitable ICOM - PC signal converter. Similar solutions may be needed for older Kenwood and Yaesu models.

Radio parameters

The radio parameters can be configured using the Tools->Profile menu. Please report back positive and negative experiences.

Set values using recommendations in the computer and radio manuals.

To interface a Keyer without using the Radio (CAT) interface:

Register jLog

The downloadable version of jLog allows a maximum of 200 entries, mainly for evaluation purposes. Register jLog and receive a Registration Code that opens up more capacity free of charge(!) to registered amateurs (i.e. with a valid Callsign). The penalty of ordering too high capacity is the corresponding memory requirement. So unless you have a very powerful computer with lots of RAM, you should start with a reasonable value and re-register later if you need to increase the capacity. Remember that when more than one log file is used, the capacity must match the size of the largest file.

The following information is required:

Note that Callsign and Name will appear on the Main screen (top right). These values must be entered exactly as they are entered in the Profile. These values will be used when e.g. creating Contest Log Headers in the Cabrillo format.

Send this information to register@jlog.org and receive a Registration Code similar to this '3-119-5829-3190' in return. Use Help->Register to enter the received code.

When restarting jLog, observe that the 'Unregistered copy' is replaced by 'Registered to: <name> (<callsign>)'. The Help->About command can be used to verify that the desired capacity is available. If values do not match, jLog will continue as an unregistered version, i.e. with a 200-entry capacity. A common error is that the name in the Profile does not match exactly the name supplied with the registration request.

FAQ

Q: Registration fails. jLog is still 'unregistered'...
A: Make sure that Callsign and Name in the 'Profile' is entered exactly as specified in you registration e-mail. This should solve your problem.

Q: I get lots of 'Check Config' warnings when I run Verify...
A: Please fill in at least one entry in the Profile under the 'Config' tab, including a Config Abb. Go to the Main window and mark all (Ctrl-A) or a subset of the entries, right-click and choose 'Set Configuration'. Choose the relevant abbreviated Configuration name.