hdr2rdb


NAME

hdr2rdb - Extract the HXDS header metadata into an /rdb table


DESCRIPTION

This program converts a file with the header of the form:

#name0:\tvalue0 #name1:\tvalue1 #.....:\t...... #nameN:\tvalueN

Into an /rdb table of the form:

Every attempt has been made to determine the correct type for the column, but it is still up to the user to decide whether they are correct or not. For example, for the instance which the file was run to make the template, the field may have been a numeric but for another instance of the file, the same numeric along with a comment could have been entered (which makes the column a string) . If the value of a line is empty then a dash (-) will be output as the description field. Due to time constraint, this program is not general enough to translate into /rdb table any other header format other than the one stated above.


Usage

hdr2rdb [clobber+ headeronly=?? help+ input=?? output=?? template=?? version+ ]

The options are :

clobber.
If clobber+ then the program will overwrite the existing output file, in this case the /rdb header shall be written out. If clobber- then the program shall append the result to the existing file, in this case the /rdb header will not be written out

headeronly.
If headeronly+ then only the header and the description field shall be written out.

help.
help+ causes this message to be written out

input.
The absolute path of the input filename

output.
The absolute path of the output filename

template.
The absolute path of the template file. It is recommended that the user begin the process of generating the database by running the program with the headeronly+ option to generate the template file. S/he may want to edit the file manually afterwards to update the column description which has an entry of the form `-' and to verify that the description is correct for all instances of the file. See the last paragraph of the synopsis.

version.
If version+ then the version number of the program will be written out

.