FILE2SDR(1)							  ICI executables						       FILE2SDR(1)

NAME

       file2sdr - SDR data ingestion test program

SYNOPSIS

       file2sdr configFlags fileName

DESCRIPTION

       file2sdr stress-tests SDR data ingestion by repeatedly writing all text lines of the file named fileName to one of a series of non-volatile
       linked lists created in a test SDR data store named "testsdrconfigFlags".  By incorporating the data store configuration into the name
       (e.g., "testsdr14") we make it relatively easy to perform comparative testing on SDR data stores that are identical aside from their
       configuration settings.

       The operation of file2sdr is cyclical: a new linked list is created each time the program finishes copying the file's text lines and starts
       over again.  If you use ^C to terminate file2sdr and then restart it, the program resumes operation at the point where it left off.

       After writing each line to the current linked list, file2sdr gives a semaphore to indicate that the list is now non-empty.  This is mainly
       for the benefit of the complementary test program sdr2file(1).

       At the end of each cycle file2sdr appends a final EOF line to the current linked list, containing the text "*** End of the file ***", and
       prints a brief performance report:

	       Processing I<lineCount> lines per second.

EXIT STATUS

       0   file2sdr has terminated.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       Diagnostic messages produced by file2sdr are written to the ION log file ion.log.

       Can't use sdr.
	   ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

       Can't create semaphore.
	   ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

       SDR transaction failed.
	   ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

       Can't open input file
	   Operating system error.  Check errtext, correct problem, and rerun.

       Can't reopen input file
	   Operating system error.  Check errtext, correct problem, and rerun.

       Can't read from input file
	   Operating system error.  Check errtext, correct problem, and rerun.

BUGS

       Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

SEE ALSO

       sdr2file(1), sdr(3)

perl v5.14.2							    2012-05-25							       FILE2SDR(1)