At least one, and as many as three run control files are used to customize the settings of xviewsdts.
 

RUN CONTROL FILE	DESCRIPTION
/etc/xviewsdtsrc.first	Host-wide defaults for all users.
$HOME/.xviewsdts/xviewsdtsrc	Defined for a specific user, overrides the above.
/etc/xviewsdtsrc.last	Host-wide requirements for all users, overrides the above.

The format of all three files is the same.  Normally only /etc/xviewsdtsrc.first need be installed.  If a single user wishes to create a personal run control file, he or she may create .xviewsdts/xviewsdtsrc in his or her home directory.  (Please note that the directory name .xviewsdts/ begins with a dot.)  Rarely, if ever, will there be a need to create /etc/xviewsdtsrc.last.  This would only be necessary if the system administrator felt the need to override any unfriendly settings that a user might set in his or her personal run control file.

What follows is a list of all the items currently supported by the run control files.  It is probably a good idea to include all items in /etc/xviewsdtsrc.first, but each item need only appear in one file.  So it unnecessary (although permissible) to put any items in $HOME/.xviewsdts/xviewsdtsrc other than the ones to be customized.  No items should appear in /etc/xviewsdtsrc.last except those which the system administrator wishes to override.
 

ITEM	DESCRIPTION
dlg_directory	Directory at the top of the tree containing the SDTS files.
fips55_pathname	Directory and name of the file containing the FIPS 55 codes for states, counties, and townships.
gnis_directory	Directory containing the GNIS files.
init_lat	Initial latitude to display at center of window.  Range is -90 to 90.  Fractional values are ok (e.g., 43.6875).
init_lon	Initial longitude to display at center of window.  Range is -180 to 180 (remember, North America is negative).  Fractional values are ok (e.g., -72.3125).
init_series	Initial map series to display.  Must be 2000000, 100000, or 24000.
init_zoom	Initial zoom level.  Range is 0 to 8  (See Zoom for definitions of zoom levels.)
lookup_24_pathname	Directory and name of lookup file for 1:24000 series surfaces.
lookup_100_pathname	Directory and name of lookup file for 1:100000 series surfaces.
lookup_2000_pathname	Directory and name of lookup file for 1:2000000 series surfaces.
mdd_24_path	Directory containing the Master Data Dictionary for 1:24000 series surfaces.
mdd_100_path	Directory containing the Master Data Dictionary for 1:100000 series surfaces.
mdd_2000_path	Directory containing the Master Data Dictionary for 1:2000000 series surfaces.
recursive_depth	Maximum number of subdirectories to search below the directory named by dlg_directory.

The point defined by init_lat, init_lon, and init_series must, of course, correspond to a surface in your SDTS collection (unless you enjoy looking at a blank window).  Most of the other items will never need to be changed from the values defined in the  /etc/xviewsdtsrc.first file supplied in the XViewSDTS package.

Here is a sample run control file:

dlg_directory=/var/share/usgs/

recursive_depth=5

mdd_24_path=/var/share/usgs/dlg24/Master/

mdd_100_path=/var/share/usgs/dlg100/Master/

mdd_2000_path=/var/share/usgs/dlg2000/Master/

fips55_pathname=/usr/local/share/nist/fips55/all

gnis_directory=/var/share/usgs/gnis/

lookup_24_pathname=/var/share/usgs/dlg24/lookup

lookup_100_pathname=/var/share/usgs/dlg100/lookup

lookup_2000_pathname=/var/share/usgs/dlg2000/lookup

init_lat=43.6875

init_lon=-72.3125

init_series=24000

init_zoom=3

Copyright © 2002 by Dapper Mapper