c_tpweof - Writes count EOF marks on tape

SYNTAX

#include "tapeio.h"

FUNCTION c_tpweof (unit, count, mode)

     long          *unit;
     long          *count;
     long          *mode;

PARAMETERS

unit (input, integer)

Unit number to be used as a reference for the drive. This number is set by c_tpopen() and should not be altered.

count (input, integer)

Number of EOFs to be written.

mode (input, integer)

A value of NO_HANDLE (0) specifies that errors are to be returned to the calling program. A value of HANDLE (1) specifies that when an error occurs the routine is to return an error to the calling program and display a message to the terminal.

DESCRIPTION

The c_tpweof() call is used to write count EOFs on a tape device.

RETURN VALUE

c_tpweof() returns

     TAPE_EOT      -->  end of tape encountered
     TAPE_SUCC (0) -->  successful completion
     TPWEOF_WEOF   -->  device error