== Using Callbooks == DXKeeper can use a Callbook to * populate items in a new QSO you're logging * fill in missing information in a QSO you've already logged, or in a group of QSOs you've already logged * replace information in a QSO you've already logged, or in a group of QSOs you've already logged * augment information in a QSO [[QSOImport|being imported]] from an ADIF or tab-delimited file * augment information in a QSO logged from an instance of WSJT-X that is [[GettingStartedwithK1JTModesDirect|directly interoperating with DXLab]] If DXKeeper is running, !WinWarbler can be configured to populate items in a new QSO from the Callbook selected in DXKeeper. Your QSO partner's first name is placed in the QSO's '''name''' item. Your QSO partner's full name and postal address are placed in the QSO's '''address''' item. You can use any of the three Callbooks delivered on CD-ROM: * [[http://hamcall.net/haminfo.html|HamCall]] * [[http://www.callbook.biz|RAC]] * [[https://secure.qrz.com/store/qrz_cd.html|QRZ]] Access to information from will be considerably faster if you install the Callbook's database files onto a hard drive in your PC. You can also use one of three Online Callbook Services: * [[http://hamcall.net/hamonline.html|HamCall Online]] (paid subscription required) * [[http://www.qrz.com/i/subscriptions.html|QRZ XML Data]] (paid subscription required) * [[http://www.hamqth.com/|HamQTH]] ([[http://www.hamqth.com/register.php|free registration]] required) These services offer information that is more up-to-date than that supplied via CD-ROM, but with slower access: a lookup over a fast internet connection with no congestion will take 5-10 seconds. With a slower connection and/or a busy server, lookup times can exceed 30 seconds. DXKeeper also enables you to use [[http://www.qrz.com|QRZ.com]] as a Callbook by using its ability to extract information from web pages downloaded by [[https://www.dxlabsuite.com/pathfinder/|Pathfinder]]; these web pages include advertising -- which is what enables QRZ to offer this service for free, but which further increases lookup times over those of the subscription-based services. As described below, DXKeeper can optionally be configured to check a second Callbook if the first Callbook is inaccessible or does not have information for the callsign. === Configuring DXKeeper === Callbook configuration is accomplished using the '''Callbook''' tab of DXKeeper's '''Configuration''' window. No matter which Callbook you're using, set two options at the bottom of this tab: * '''Automatically use callbook data to initialize new QSOs''': if you enable this option, DXKeeper will automatically perform a Callbook lookup when you type a callsign into the '''Capture''' window or the '''Main''' window's '''Log QSOs''' tab and strike the '''Enter''' or '''Tab''' keys; information from the Callbook will be used to fill in missing items, but will not replace items you've already specified, items [[CreateEntityOverride|specified in an override]], or items harvested from previously logged QSOs with the station ([[https://www.dxlabsuite.com/dxkeeper/Help/Configuration.htm#Display%20Previous%20QSOs%20on%20Lookup%20checkbox|if enabled]]) * '''Warn when Callsign Lookups fail''': if you enable this option, DXKeeper will display a small window that informs you when the Callsign you've looked up was not found in the selected Callbook === Configuring DXKeeper to use a Callbook CD-ROM === If you've installed one of the Callbook CD-ROMs, then select it on the '''Callbook''' tab, and select the appropriate folder name: * RAC: the pathname of the folder containing the RAC file '''Callbook.exe''' * !HamCall: the pathname of the folder containing the !HamCall file '''hamcall.dat''' * QRZ: the pathname of the folder containing the QRZ file '''callbkc.dat''' If you've installed a !HamCall CD-ROM dated May 2013 or later, use Windows Explorer to navigate to your DXKeeper folder, and delete the file {{{Hamcal32.dll}}} . === Configuring DXKeeper to use an Online Callbook Service === If you have a paid '''!HamCall Online''' subscription (available [[http://hamcall.net/hamonline.html|here]]) 1. select '''!HamCall Online''' 1. specify your callsign 1. specify your password 1. set the '''!HamCall Online timeout''' to 60 If you have a free '''HamQTH''' account (available [[http://www.hamqth.com/register.php|here]]), 1. select '''HamQTH''' 1. specify your callsign 1. specify your password 1. set the '''HamQTH timeout''' to 60 If you have a paid '''QRZ XML Data''' subscription (available [[https://shop.qrz.com/collections/home-page/products/xml-logbook-data-subscription-1-year|here]]), then in the '''QRZ.com''' panel, 1. select '''XML Data''' 1. specify your callsign 1. specify your password 1. set the '''QRZ.com timeout''' to 60 1. if you are pursuing awards that depend on each QSO's grid square, check the '''Ignore geocoded grid squares''' box ("geocoding" means determining an approximate location from a postal address) Note: [[QRZTwoFactor|QRZ's Two-Factor Authentication]] === Configuring DXKeeper to use QRZ.com via Pathfinder === If you'll be using '''QRZ.com via Pathfinder''' for free access to callbook information from QRZ.com, then 1. if you don't have a free QRZ.com account, register your callsign for one via [[https://secure.qrz.com/support?op=newacct]] 1. start Pathfinder, open its '''Config''' window a. check the '''Hide script error notification''' box a. in the '''QRZ.com Online Callbook''' panel i. enter the callsign you registered in step 1 into the '''username''' box i. enter the password you received in step 1 into the '''password''' box i. check the '''Automatic login''' box * automatic login will not succeed if you have QRZ.com configured to employ two-factor authentication i. check the '''Warn if not logged in''' box a. in the '''Internet Explorer''' panel, if the '''Update Emulation''' button is enabled, click it 1. on Pathfinder's Main window, depress the CTRL key while clicking the '''QRZ''' search button; in the '''Pathfinder search''' window that appears, a. check the '''Auto''' box a. click the '''Save...''' button 1. in the '''QRZ.com''' panel on the '''Callbook''' tab of DXKeeper's '''Config''' window, a. select '''QRZ.com via Pathfinder''' a. set the '''QRZ.com timeout''' to 60 a. if you are pursuing awards that depend on each QSO's grid square, check the '''Ignore geocoded grid squares''' box ("geocoding" means determining an approximate location from a postal address) Note: [[QRZTwoFactor|QRZ's Two-Factor Authentication]] === Testing the Callbook Lookup mechanism === To verify that the Callbook lookup mechanism is working, 1. log a test QSO 1. on the '''Main''' window's '''Log QSOs''' tab, a. select the test QSO in the '''Log Page Display''' a. click the '''CBA''' button DXKeeper should fill in missing items -- e.g. name, QTH, address, state, province, county -- by performing a callbook lookup === Initiating Lookups from the Capture Window === Typing a callsign into the Capture window's '''Call''' textbox and then striking the '''Enter''' or '''Tab''' key or clicking the '''Lookup''' button will query the selected Callbook and add information to the appropriate Capture window textboxes, but will not replace information already present. Depressing the '''CTRL''' key while clicking the '''Lookup''' button will remove information already present before querying the selected Callbook. === Initiating Lookups using the CBA function on the Main window's "Log QSOs" tab === Clicking the '''CBA''' button on the '''Main''' window's '''Log QSOs''' tab will lookup the current QSO's callsign in the Callbook selected on the '''Config''' window's '''Callbook''' tab, the lookup the the current QSO's callsign in the '''DXCC Database''' (taking into account information from '''overide''' specified in [[DxInfo|DXView]] and from the USAP database, if [[DxInfo|DXView]] is running), and use the resulting information to fill in any items not specified in the QSO; information already present in the QSO's items will not be modified. If you want information gained from the Callbook and DXCC database lookups to replace information in the current QSO, depress the '''Ctrl''' key while clicking the '''CBA''' function. Note that for QSOs with stations in the United States, Alaska, and Canada, DXKeeper will update the QSO's DXCC entity to match the State returned by the Callbook or DXCC database; for example, a QSO whose DXCC entity is set to USA but whose State is determined by the Callbook to be Hawaii will have its DXCC entity change to Hawaii. To perform a "lookup and fill in but don't modify" operation on all QSOs in the '''Log Page Display''', depressing the '''Alt''' key while clicking the '''CBA''' button; note that if '''QRZ.com via Pathfinder''' is selected, the rate is limited to one lookup per every 4 seconds. To perform a "lookup and replace" operation on all QSOs in the '''Log Page Display''', depressing both the '''Alt''' and '''Ctrl''' keys while clicking the '''CBA''' button; note that if '''QRZ.com via Pathfinder''' is selected, the rate is limited to one lookup per every 4 seconds. '''Note''': Callbook lookups should only be applied to relative recent QSOs; applying them to older QSOs is risky, and the information found in the Callbook and DXCC database may be incorrect as of the date of the QSO. === Augmenting Information in a QSO Being Imported from an ADIF or Tab-delimited Tile === To augment information in a QSO being imported from an ADIF or tab-delimited file, check the '''Query callbook and available databases for missing items''' box in the '''Options''' panel on the Main window's '''Import QSOs''' tab === Augmenting Information in a QSO Logged from an Instance of WSJT-X that is Directly Interoperating with DXLab === To augment information in a QSO logged from an instance of WSJT-X that is [[GettingStartedwithK1JTModesDirect|directly interoperating with DXLab]], check the '''Callbook''' box in the '''WSJT-X''' panel on the '''Spot Sources''' tab of !SpotCollector's Configuration window. === Checking a Second Callbook if the first Callbook Lookup is Unsuccessful === To configure DXKeeper to automatically query a second Callbook if the first Callbook is inaccessible or does not return information, in the '''Secondary Callbook''' panel at the bottom of the Configuration window's '''Callbook''' tab * use the '''Callbook''' selector to specify the second Callbook to be used in this circumstance * check the '''Enable''' box === Configuring WinWarbler to Initiate Callbook Lookups === On the '''Log''' tab of !WinWarbler's Configuration window, check the '''QSO Info''' panel's '''Automatic Lookup''' box. Configured in this way, double-clicking on a received callsign or striking the enter key in the callsign textbox will direct DXKeeper to produce a filtered display showing previous QSOs with that callsign and perform a callbook lookup (if enabled on the '''Callbook''' tab of DXKeeper's Configuration window). === Configuring JTAlert to Initiate Callbook Lookups === In the '''DXLab DXKeeper''' section of the '''Logging''' section of [[GettingStartedwithK1JTModesWithJTAlert|JTAlert's]] '''Settings''' window, check the '''Instruct DXKeeper to query its enabled callbook''' box. ---- [[DXLabDiscussionGroup|Post a question or suggestion on the DXLab Discussion Group]] [[Logging]] [[GettingStarted|Getting Started with DXLab]]