The LoadLayout command specifies a filename containing a Log Page Display layout file, which is loaded and applied. This allows a layout optimized for a particular report to be instituted, the report generated, and the normal Log Page Display layout restored:

        LoadLayout C:\Program Files\DXKeeper\Configurations\GridReport.txt
    Filter Band='6m'
    Report Grids C:\Program Files\DXKeeper\Reports\<operator>6M grids.txt
        LoadLayout C:\Program Files\DXKeeper\Configurations\Primary.txt

Modify, ModifyWithoutBackup

The Modify command designates an item and provides a new value for that item. The ModifyWithoutBackup   command is functionally identical, but does not cause DXKeeper to offer to backup your log before running your script. Consider the following  Modify commands:

Modify DXCCid 20
Modify DXCCprefix KH1
Modify CQZ 31
Modify ITUz 61

These commands will change the DXCCid, DXCCprefix, CQZ, and ITUz items of each QSO in the Log Page Display. If placed after the above Filter command, these four Modify commands would update all pre-1979 QSOs with Baker and Howland Islands to contain the correct country code, DXCC prefix, CQ zone, and ITU zone.

Within the new value, the character sequence <current> represents the item's current value. Thus the commands

Filter (QSO_Begin > #6/21/2003#) and QSO_Begin < #6/22/2003#)
Modify COMMENT <current> (solar flux = 144)

will append (solar flux = 144)to the comment item of every QSO logged on 21-Jun-2003. 

Within the new value, the character sequence '' means "clear the designated item". Thus the commands

Filter Band='6m'
Modify PROP_MODE ''

will clear the propagation mode item logged with every 6m QSO.

Within the new value, the character sequence <today> is replaced the current UTC date in YYYY-MM-DD format.. 

Within the new value, the character sequence <capitalized> represents the item's current value with its first letter capitalized. Thus the commands

Filter DXCCprefix = 'F'
Modify QTH <capitalized>

will change a QTH containing paris to Paris in all QSOs with French stations.

Within the new value of a file item, the character sequence <filename> represents the simple filename component of the pathname specified in the current value. Thus the commands

Filter DXCCprefix = 'F'
Modify APP_DXKEEPER_FILE c:\HamRadio\QSO_Files\French\<filename>

will change a QSO's file item from

 c:\dxlab\dxkeeper\QSO_Files\F5IN_Transceiver_Schematic.jpg

to

c:\HamRadio\QSO_Files\French\F5IN_Transceiver_Schematic.jpg

Within the new value, you can reference the contents of any other item in the QSO by enclosing that item's item name in angle brackets. Thus the commands

    Filter true
    Modify PROP_MODE <COMMENT>

would set every QSO's propagation mode to the contents of its comment item.

Each instance of<newline> will be replaced by a newline character. Thus the commands

Filter true

Modify ADDRESS <CALL><NEWLINE><ADDRESS>

will insert each QSO's callsign into the first line of its address.

You can use the new value field to add or subtract a time interval from the QSO_Begin or QSO_End item of each selected QSO by beginning the new value with + or - and ending the new value with y, m, d, h, n, or s - as illustrated in the table below:

Neither fractions nor combinations are permitted; if you want to add 3 hours and 30 minutes to each QSO's start time, for example,  use +210n.

You can use the new value field to computationally modify a QSO's freq or rx_freq item by by specifying a new value that begins with +, -, x, or / - as illustrated in the table below:

• modifying a a QSO's freq item automatically updates its band item
  
• modifying a QSO's rx_freq item automatically updates its rx band item

You can prevent DXKeeper from interpreting a word between square brackets as a "command" by preceding it with a backslash character (\). For example, setting the new value to \<call> would replace the item in each QSO with <call> rather than with the contents of each QSO's callsign item. Note that \<filename> in a File or AudioFile item does not result in removal of the backslash.

A Modify command will only be executed if the most recent Filter command succeeded; thus the first command in a script file must be a Filter command. After a Modify command is executed, the number of QSOs modified is recorded in the script log file, and then the most recent Filter command is re-executed; this ensures that any subsequent Modify commands are applied to the intended subset of logged QSOs. Prior to execution, the Modify command verifies that the designated item is valid, and that the specified new value for that item is appropriate; any error will prevent the Modify command from being executed, and will be recorded in the script log file.

Modifications made by script execution to any of the following items can require that the current log's Realtime Award Progress and the current Spot Database (if SpotCollector is running) be updated via recomputation:

• Band
• Call
• CQ
• DXCC Prefix
• eQSL Rcvd
• LotW Rcvd
• Mode
• PropMode
• QSL Rcvd
• SatName

If recomputation might be required, DXKeeper will notify you, and offer to initiate the process. If you are planning to execute more scripts that modify logged QSOs, complete those modifications; then initiate recomputation after the last change has been made.

Changes that if made manually would change a QSO's Club Log Status item from Y to M do not result in the  Modify or  ModifyWithoutBackup commands changing a QSO's Club Log Status item from Y to M.  You can accomplish this by using a second Modify or  ModifyWithoutBackup command to change the Club Log Status item in the selected QSOs.

DXKeeper's /Scripts folder contains several preconstructed scripts for updating older QSOs to reflect up-to-date DXCC country codes, DXCC prefixes, CQ zones, and ITU zones. These can be used to correct QSOs that were imported without DXCCID tags, and as examples of script construction.

Plot

The Plot command conveys all QSOs in the Log Page Display to DXView for display on the world maps(s) it manages.


Report and AppendReport

The Report and AppendReport commands direct the generation of a log or progress report into a specified filename. Their generic formats are

         Report Kind ReportFilename

         AppendReport Kind ReportFilename

Kind can be one of the following values