NAME

       file2dgr - DGR transmission test program

SYNOPSIS

       file2dgr remoteHostName fileName [nbrOfCycles]

DESCRIPTION

       file2dgr uses DGR to send nbrOfCycles copies of the text of the file named fileName to the
       dgr2file process running on the computer identified by remoteHostName.  If not specified
       (or if less than 1), nbrOfCycles defaults to 1.  After sending all lines of the file,
       file2dgr sends a datagram containing an EOF string (the ASCII text "*** End of the file
       ***") before reopening the file and starting transmission of the next copy.

       When all copies of the file have been sent, file2dgr prints a performance report:

               Bytes sent = I<byteCount>, usec elapsed = I<elapsedTime>.

               Sending I<dataRate> bits per second.

EXIT STATUS

       "0" file2dgr has terminated.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

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

       Can't open dgr service.
           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 acquire DGR working memory.
           ION system error.  Check for earlier diagnostic messages describing the cause of the
           error; 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.

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

BUGS

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

SEE ALSO

       file2dgr(1), dgr(3)