DGR2FILE(1)							  DGR executables						       DGR2FILE(1)

NAME

       dgr2file - DGR reception test program

SYNOPSIS

       dgr2file

DESCRIPTION

       dgr2file uses DGR to receive multiple copies of the text of a file transmitted by file2dgr, writing each copy of the file to the current
       working directory.  The name of each file written by dgr2file is file_copy_cycleNbr, where cycleNbr is initially zero and is increased by 1
       every time dgr2file closes the file it is currently writing and opens a new one.

       Upon receiving a DGR datagram from file2dgr, dgr2file extracts the content of the datagram (either a line of text from the file that is
       being transmitted by file2dgr or else an EOF string indicating the end of that file).  It appends each extracted line of text to the local
       copy of that file that dgr2file is currently writing.  When the extracted datagram content is an EOF string (the ASCII text "*** End of the
       file ***"), dgr2file closes the file it is writing, increments cycleNbr, opens a new copy of the file for writing, and prints the message
       "working on cycle cycleNbr."

       dgr2file always receives datagrams at port 2101.

EXIT STATUS

       0   dgr2file has terminated.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       can't open dgr service
	   Operating system error.  Check errtext, correct problem, and rerun.

       can't open output file
	   Operating system error.  Check errtext, correct problem, and rerun.

       dgr_receive failed
	   Operating system error.  Check errtext, correct problem, and rerun.

       can't write to output file
	   Operating system error.  Check errtext, correct problem, and rerun.

BUGS

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

SEE ALSO

       file2dgr(1), dgr(3)

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