== Correcting Logged DXCC Entities with "Fix" Scripts ==

==== de Joe W4TV ====

The '''ARRL''' defines a unique, immutable '''Entity Code''' for each DXCC entity in
[[https://www.arrl.org/files/file/DXCC/2022_DXCC_Current.pdf]]

The [[https://adif.org.uk/ADIF_Current|ADIF specification]] provides a tag named [[https://adif.org.uk/ADIF_Current#QSO_Field_DXCC|DXCC]] to convey each QSO's '''Entity Code'''. If your ADIF file
specifies a '''DXCC''' tag for each QSO, then DXKeeper will accurately recover the DXCC entity you logged with each of your QSOs with no additional action required on your part.

Unfortunately, some logging applications do not include the DXCC tag in exported ADIF files. When DXKeeper imports an ADIF record that doesn't specify an Entity Code, it determines the QSO's DXCC entity by analyzing the callsign -- using ''today's'' callsign-to-entity rules. If you logged a QSO with KA1DX back in 1952, and your logging application exports this QSO without the Entity Code for Minami Torishima (which in ADIF would be '''<DXCC:3>177'''), then DXKeeper will assign the imported QSO's DXCC entity to be the continental US (Entity Code 291). To automate the correction of such QSO's, Joe W4TV created a set of '''Fix''' scripts that inspect each QSO in DXKeeper's log, apply the callsign-to-entity rules ''in force as of the date of the QSO'', and if appropriate modify the QSO's DXCC entity, CQ zone, ITU zone, Continent, and IOTA tag. You'll find these scripts in DXKeeper's '''Scripts''' sub-folder:

 * FIX_EU.txt
 * FIX_USSR.txt
 * FIX_KH.txt
 * FIX_MISC.txt

Before running one of these scripts, backup your log by clicking the '''Backup''' button on the '''Configuration''' window's '''Log''' tab.

To run a script, click the button labeled '''~''' in the '''Filter''' panel at the bottom of the '''Main''' window's '''Log QSOs''' tab; this will cause a '''Scripts''' button to
appear. Click the Scripts button, and use the resulting '''Run Script''' window to navigate to DXKeeper's Scripts sub-folder and select the Fix script you wish to run. 

If you select a script that potentially modifies your QSOs (as all Fix scripts do), you'll be given the opportunity to make a log backup before running the
script; agreeing to create such backups is a good idea. After a script runs, DXKeeper will display a report that summarizes the changes made. More
information about Scripts can be found in [[http://www.dxlabsuite.com/dxkeeper/Help/Scripts.htm]], or by clicking one of DXKeeper's '''Help''' buttons and navigating to the '''Filtering, Modifying, and Reporting with Scripts''' topic in the '''Logging and Managing QSOs''' section.

----
[[DXLabDiscussionGroup|Post a question or suggestion on the DXLab Discussion Group]]

[[Logging|Getting Started with Logging]]

[[QSLing|Getting Started with QSLing]]

[[AwardTracking|Getting Started with Award Tracking]]

[[GettingStarted|Getting Started with DXLab]]