Modifying Multiple QSOs En Masse

DXKeeper Online Help Contents

Changes can be applied to all QSOs in the Log Page Display  in a single operation by

• using the Advanced Logs Sorts, Filter, and Modifiers window's Modify QSOs panel

• running a Script

• filling in or replacing the information in each QSO by performing a Callbook Update 

Like all power tools, these can be dangerous if not carefully applied. Its a good idea to make a backup copy of your log before using them, as doing so enables a quick recovery if after inspection the change you specified turns out to be incorrect.

Using the Modify QSOs panel

To display the Advanced Logs Sorts, Filter, and Modifiers window, click the Adv button at the bottom of the Main window's Log QSOs tab, or click the Advanced button at the bottom of the Main window's Awards tab.

The Modify QSOs panel lets you designate an item and provide a new value for that item. When you click the panel's Modify button, the designated item of each QSO in the Log Page Display will be set to the specified value. To designate an item, use the panel's Item's ADIF field name selector to choose the item's name. Enter the desired new value in the panel's New item value setting. Clicking the panel's Modify button applies the change to every QSO in the Log Page Display; if you intend to change only some of the QSOs in your log, first filter the Log Page Display so that only the QSOs to be modified are present.

• If you set the Item name selector to DXCCPrefix and click the panel's Modify button, DXKeeper will automatically set the DXCCID item of each modified QSO to the country code corresponding to the DXCC prefix you selected in New item value. Conversely, if you set the Item name selector to DXCCID and click the panel's Modify button, DXKeeper will automatically set the DXCCPrefix item of each modified QSO to the DXCC prefix corresponding to the country code you selected in Item new value. In this way, consistency between DXCCPrefix and DXCCID is maintained.
  

• If you set the Item name selector to GridSquare and click the panel's Modify button, DXKeeper will automatically set the lat and lon items of each modified QSO to match the specified GridSquare; in any modified QSO that specifies an antenna path, the dist item will also be updated based on the operator's QTH, as specified by a myQTHID item that specifies a QTH that includes a valid latitude and longitude, or as specified in the default QTH latitude and longitude.
  

• If you set the Item name selector to Lat or Lon and click the panel's Modify button, DXKeeper will automatically set the grid 1 items of each modified QSO to match its lat and lon items; in any modified QSO that specifies an antenna path, the dist item will also be updated based on the operator's QTH, as specified by a myQTHID item that specifies a QTH that includes a valid latitude and longitude, or as specified in the default QTH latitude and longitude.
  

• If you set the Item name selector to Ant_Path and click the panel's Modify button, DXKeeper will automatically set the dist items of each modified QSO based on its lat and lon items and the operator's QTH, as specified by a myQTHID item that specifies a QTH that includes a valid latitude and longitude, or as  specified in the default QTH latitude and longitude.
  

• You can use <current> in the New item value to represent the item's current value in the logged QSO; thus an  Item name of Call and an Item new value of <current>/KH6 will change AA6YQ to AA6YQ/KH6 and K4IK to K4IK/KH6. 
  

• You can use <capitalized> in the New item value to represent the item's current value in the logged QSO with its first letter capitalized; thus an  Item name of QTH and an Item new value of <capitalized> will change paris to Paris and will change new london to New london. 
  

• You can use <AppendUDI> in the New item value to append information to the the item's current value in the logged QSO with information from other user-defined items in that QSO specified by user-defined item number, in comma-delimited format.

  • Suppose, for example, you've been  recording QSOs with stations in multiple COTA identifiers
    

    User-defined Item number	Caption	Contents
    0	WCA-1	C-008
    1	WCA-2	C-110
    2	WCA-3	F-052
    3	WCA-4	F-072

  
  
  • To append the contents of user-defined items 1, 2, and 3 to the contents of user-defined item 0,
    
    1. change the Style of user-defined item 0 to Comma-delimited List
       
    2. In the Modify QSOs panel,

       • set the Item name selector to APP_DXKEEPER_USER_DEFINED_0

       • set the Item new value to <AppendUDI 1,2,3>

       • click the Mod button
         
         

  • the results:
    

  User-defined Item number	Caption	Contents
  0	WCA-1	C-008, C-110, F-052, F-072
  1	WCA-2	C-110
  2	WCA-3	F-052
  3	WCA-4	F-072

  
  
  • You can then clear user-defined items 1, 2, and 3, or use them to record other information.




• If the  Item name selector is set to APP_DXKEEPER_FILE, you can use <filename> in the New item value to represent the filename component of the pathname in the logged QSO's file item; thus an  Item ADIF field name of APP_DXKEEPER_FILE and an Item new value of c:\dxlab\files\<filename> will change 

c:\program files\dxlab suite\files\7O1DX_license.jpg 

to 

c:\dxlab\files\7O1DX_license.jpg 

• You can use  <compute> in the Item new value to compute the value of certain items from other items in the QSO. If the Item name selector is tx band or rx band,  <compute> is available as the last choice in the Item new value selector.

• You can adjust the contents of a QSO's QSO_Begin or QSO_End item with a Item new value that begins with a + (to add a time interval) or - (to subtract a time interval). For example,

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 adjust the contents of a QSO's freq or rx_freq item with a Item new value that begins with a + (to add a frequency offset in MHz), - (to subtract a frequency offset in MHz), x (to multiply by a number), or / (to divide by a number). For example,
  
  

  Item new value	Effect
  + 36	adds 36 MHz
  - .1	subtracts 100 KHz
  x 1000	multiplies by 1000
  / 1000	divides by 1000

• Changing the contents of a QSO's freq or rx_freq item automatically updates its tx band or rx band item respectively
  
• You can reduce the precision of a gridsquare item to 4 characters by setting the Item New Value to <ShortGrid>
  
• You can use <Item name> in the Item new value to represent the value of the designated item in the current QSO.  If the Item name is set to Comment and the Item new value is

worked <Name> on <Band>

then a 20m QSO with ON4UN will have its comment item set to  

    worked John on 20m

• Each instance of<newline> in the Item new value will be replaced by a newline character. You could use this to insert a QSO's callsign into the first line of its address by setting the Item name selector to address and setting the Item new value to

<call><newline><address>

You can prevent DXKeeper from interpreting a word between angle brackets as a "command" by preceding it with a backslash character (\). For example, setting the Item new value to \<call> would replace the  Item name 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.

Modifications to some items can require that the current log's Realtime Award Progress and the current Spot Database (if SpotCollector is running) be updated via recomputation. If recomputation is required, DXKeeper will notify you, and offer to initiate the process. If you are planning more modifications, complete all 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 QSOs panel changing a QSO's Club Log Status item from Y to M.  You can accomplish this by using the to Modify QSOs panel to change the Club Log Status item in the selected QSOs.

If the Subdivisions box is checked on the Config window's Awards tab and your modification results in one or more QSOs with DXCC entities that formally specify Primary or Secondary Administrative Subdivisions specifying an invalid primary or secondary administrative entity, a message window informing you of this situation will appear at the conclusion of the operation. You can invoke the Broke filter to display QSOs specifying invalid primary or secondary administrative entities.