{
{      The purpose of this request is to send the contents of an batch file
{ across an established connection.  This interface will use the NAM/VE or
{ RHFAM/VE send / receive data routines to perform the data transfer
{ phase protocol exchange.
{
{      The data transfer phase protocol is defined in the RHF
{ A to A Interface Spec (ARH4260).
{
{     NFP$SEND_BATCH_FILE (CONNECTION_FID, FILE_NAME,
{           LOCAL_FILE_NAME, FACILITIES, TRANSFER_MODE, BLOCK_SIZE,
{           MIN_TIMEOUT, PROTOCOL_VERSION, DESTINATION_USAGE,
{           QUEUE_FILE_PASSWORD, DISPOSITION_CODE, ACTIVATE_PROTOCOL_TRACE,
{           FILE_POSITION, PROTOCOL_STATE_CONSISTENT, TRANSFER_STATUS, STATUS)
{
{ CONNECTION_FID: (input) This parameter specifies the identifier
{   of an open NAM or RHFAM connection on which to send the file.
{
{ FILE_NAME: (input) This parameter specifies the file reference of
{   the source file (an input or output queue file).
{
{ LOCAL_FILE_NAME: (input) This parameter specifies the file reference
{   to a local file (as opposed to a queue file).  Specify OSC$NULL_NAME
{   to transfer the queue file specified by the FILE_NAME parameter.
{   If this parameter is not null, then the local file is transferred
{   instead of the queue file.
{
{ 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.
{
{ VALIDATION_RING: (input) This parameter specifies the minimal ring
{   requirements for the source file.
{
{ DESTINATION_USAGE: (input) This parameter specifies the destination
{   usage of the source file.
{
{ QUEUE_FILE_PASSWORD: (input) This parameter specifies the password
{   required to open the input or output queue file.
{
{ DISPOSITION_CODE: (input) This parameter specifies the destination usage
{   of the queue file.
{
{ ACTIVATE_PROTOCOL_TRACE: (input) This parameter specifies if the protocol
{   trace information is displayed in the joblog.
{
{ FILE_POSITION: (output) This parameter specifies the position of the
{   file upon exit of this routine.  Can be used to re-start a file from
{   where it left off in case of error.
{
{ 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$receiver_problem_no_retry
{             nfe$receiver_problem_retry
{             nfe$sender_problem_no_retry
{             nfe$sender_problem_retry
{             nfe$terminate_transfer_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
{
