{
{      The purpose of this request is to receive the contents of a
{ file from an established connection.  This interface will use the
{ NAM/VE or RHFAM/VE send /receive data routines to perform the file transfer
{ phase protocol exchange.
{
{      The data transfer phase protocol that is used is defined in the
{ RHF A to A Interface Spec (ARH4260).
{
{       NFP$RECEIVE_FILE (CONNECTION_FID, FILE_NAME, FACILITIES,
{             TRANSFER_MODE, BLOCK_SIZE, MIN_TIMEOUT, PROTOCOL_VERSION,
{             NETWORK_TYPE, VALIDATION_RING, ACTIVATE_PROTOCOL_TRACE,
{             FILE SIZE, PROTOCOL_STATE_CONSISTENT, TRANSFER_STATE, STATUS)
{
{ CONNECTION_FID: (input) This parameter specifies the identifier
{   of an open NAM or RHFAM connection to receive the file from.
{
{ FILE_NAME: (input) This parameter specifies the file reference of the
{   file to be received.
{
{ FACILITIES: (input) This parameter specifies the application
{   facilities that have been selected for this connection.
{
{ TRANSFER_MODE: (input) This parameter specifies the data type of the
{   file transfer to perform.
{
{ BLOCK_SIZE: (input) This parameter contains the maximum block
{   size to use for the file transfer. (value is number of bytes)
{
{ MIN_TIMEOUT: (input) This parameter specifies the minimum amount
{   of time to wait between network responses. (value in seconds)
{
{ PROTOCOL_VERSION: (input) This parameter specifies the version
{   of protocol being used.
{
{ NETWORK_TYPE: (input)  This parameter specifies the network that
{   will be used to perform the file transfer.  (NAM/VE or LCN)
{
{ VALIDATION_RING: (input) This parameter specifies the minimal ring
{   requirements for the file to be received.
{
{ ACTIVATE_PROTOCOL_TRACE: (input) This parameter specifies if the protocol
{   trace information is displayed in the joblog.
{
{ FILE_SIZE: (output) This parameter specifies the size of the file
{   transferred.
{
{ PROTOCOL_STATE_CONSISTENT: (output) This parameter specifies
{   whether or not the send_file routine has completed (normally or
{   abnormally) the file transfer phase protocol.
{
{ TRANSFER_STATUS: (output)  This parameter returns the status of the file
{       transfer.
{       CONDITIONS:
{             nfe$application_time_out
{             nfe$protocol_anomaly
{             nfe$terminate_transfer_message
{             nfe$transfer_rejected_message
{
{ STATUS: (output) This parameter returns the results of the request.
{       CONDITIONS:
{             nfe$access_method_timeout
{             nfe$application_protocol_error
{             nfe$application_timeout
{             nfe$connection_closed_by_peer
{
