c_tprew - Rewinds a tape

SYNTAX

#include "tapeio.h"

FUNCTION c_tprew (unit, mode, opt1)

     long          *unit;
     long          *mode;
     long          *opt1;

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.

mode (input, integer)

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.

opt1 (input, integer)

Flag that allows just rewinding the tape by setting it to REWIND (1) or to REWOFFL (2) to optionally take the drive off-line.

DESCRIPTION

The c_tprew() call is used to rewind a tape device.

RETURN VALUE

c_tprew() returns

     TAPE_SUCC (0) -->  successful completion
     TPREW_REW     -->  device error