Since version 2.4 the parameters of SHM are maintained in a setup text file, by default this is located in $SH_INPUTS/shm-config.txt. If an environment variable named $SH_USER_PARAM is defined and points to an existing file this takes precedence. The data lines of this file are of the simple structure
<keyword> <value>
where neither <keyword> nor <value> may contain blanks. Please look in the file $SH_INPUTS/shm-config-default.txt for a complete list and explanation of possible parameters. All keywords are predefined and hardwired in the program code except keywords starting with v$. These v$-keywords are used for defining the station button names of the MiniSEED read dialog box. Entries like v$read_dialog_stations_01, v$read_dialog_stations_02, ... and so on are used for defining up to 99 different read dialog boxes. The corresponding value is a list of up to 32 comma-separated (no blanks) button names. Names 1-30 label the 30 station buttons, elements 31 and 32 give names to the two subset buttons of the dialog box. Two subsets of buttons may be grouped using brackets in the comma list and can be selected/deselected using the subset buttons. Example:
v$read_dialog_stations_01 [abc,bcd,cde],---,---,[xyz,xxx,yyy,zzz]
In this case the first three and last four button can be selected together with the first and second subset button, respectively. Names consisting of three hyphens (---) result in not selectable buttons. Names starting with a $ refer to a corresponding v$-station list variable holding the names of a station set. Example:
v$read_dialog_stations_02 $net1,$net2,xyz,abc
v$net1 n1a,n1b,n1c,n1d,n1e,n1f,nxx
v$net2 n2x,n2y,n2z,nxx
In this case a click on the $net1-button selects the stations n1a,n1b,n1c,n1d,n1e,n1f,nxx together. More than one station list button may be combined and selected, resulting stations lists are merged and possible double selections are corrected, like station nxx in above example if $net1 and $net2 are both selected.
Please have a look in the $SH_INPUTS/shm-config-default.txt file to see more examples.
This page last modified 22-May-2006