Tabular data handling toolkit  
SGPR home  


Manual page for CONFIG(TDH)

YOUR PROJECT CONFIG FILE




SYNTAX

The config file should have the syntax of
	label: value
	label: value
	..etc.

label is one of the parameters described below, and is always followed by a colon, then one or more spaces, then a value. For example:
	varvalue:  PROJDIR=/steve/proj1
	scriptdir: @PROJDIR/pages

Lines beginning with // and blank lines are skipped. Lines may include @variables. Use varvalue to set a variable.


DEFAULTS AND OVERRIDES

Most of these attributes have defaults that will be in effect if the attribute is not set in the config file. If a TDH program has a command line option that is equivalent in meaning to a config file attribute, the command line option will override the config setting.


PARAMETERS

scriptdir:

Path name of directory where scripts are kept. Default is ./
Example: scriptdir: /steve/proj1/pages

tmpdir:

A directory to be used for temporary files. Default is /tmp.

fdfpath:

Path name of directory where any fdf files are kept. Default is ./

joinprog:

Full path name for psqlj. This is needed because psqlj is executed to perform joins.

dbnull:

Symbol used by external database for a missing or zero length value. Default is null.

dbquote:

Quote character used by external database for quoting alpha values. Default is double quote (").

dbquoteesc:

Character that #dataprep will insert before any embedded dbquote characters, in order to prepare fields for database update. dbquoteesc is not used if htmlqhmode is in effect.

htmlqhmode:

HTML quote handling mode. Default is yes. If yes, #dataprep will convert any embedded double quote (") characters to single quote (') in order to prepare fields for database update. Convenient for use with HTML forms. Your dbquote character must be double quote ("). htmlqhmode may also be set dynamically using #control . When in effect htmlqhmode overrides dbquoteesc.

tabfields:

yes or no. If yes, TDHkit utility programs such as fldfmt(1) expect TAB-delimited fields on standard input and write TAB-delimited fields to standard output. Implies utilfieldterm: tab. Equivalent to the -t option that many of the TDH utilities have.

fieldnameheaders:

yes or no. If yes, TDHkit utility programs such as fldfmt(1) expect the first line of input to be a field name header line. This does not cause a field name header line to be generated on output. May be overridden using the -h or -h- command line options that many of the TDH utilities have.

utilfieldterm:

Character to be used to delimit fields in output from TDH utility programs that output data records. Allowable values are tab, space, or any single character. Default is space.

varvalue:

Preset a variable to a value. This may be used as many times as desired within the config file to set various variables. This may also be used to set a variable that will be referenced later in the config file.
Example: varvalue: MODE=normal

putenv:

Set an environment variable for current process and all subprocesses. This may be used as many times as desired within the config file to set various environment variables. THDkit environment variables are listed here .

decpt:

Set the character to be used as a decimal point. Default is .


DATE-RELATED

dateformat:

Set the default date format . Default is mmddyy.
Example: dateformat: yyyy-mmm-dd

pivotyear:

two digit year that should be used to convert two-digit years to four-digit years. If two-digit years are used, year values that are less than the pivot year are assumed to be 21st century years. Default is 77. See also date format
Example: pivotyear: 70

months:

Set three-character month abbreviations, all lower case.
Example (Spanish):
months: ene feb mar abr pue jun jul ago sep oct nov dic

months.abbrev:

Set three-character month abbreviations, mixed case.
Example (Spanish):
months.abbrev: Ene Feb Mar Abr Pue Jun Jul Ago Sep Oct Nov Dic

months.full

Set full month names.
Example (Spanish):
months.full: Enero Febrero Marcha Abril Pueda Junio Julio Agosto Septiembre Octubre Noviembre Diciembre

weekdays

Set weekday names.
Example (Spanish): weekdays: Dom Lun Mar Mie Jue Vie Sab

omitweekends

omit weekends when doing date calculations, e.g. a Friday will be adjacent to the following Monday. yes or no. Default is no.

strictdatelengths

be strict about date lengths, e.g. an mm/dd/yy date must always be 8 or 10 chars long, otherwise an error will result. yes or no. Default is yes.


Tabular data handling toolkit 
Copyright Steve Grubb


Markup created by unroff 1.0,    August 02, 2001.