SYNTAX

#include "tapeio.h"

FUNCTION c_tpfsf (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/output, integer)

Number of files to be skipped. If an error such as TAPE_EOT (end of tape) or TAPE_EOV (end of volume) occurs, the number of files actually skipped is returned in parameter count.

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_tpfsf() call is used to skip over count files on a tape device. Some examples of c_tpfsf() follow:

     Tape location before,             Tape location after call, 
     called with count = 1             returns TAPE_SUCC, count = 1
                |                                       |
                V                                       V
  ------------------------------     ------------------------------
  |   |E|   |E|    |E|     |E|E|     |   |E|   |E|    |E|     |E|E|
  |   |O|   |O|    |O|     |O|O|     |   |O|   |O|    |O|     |O|O|
  |   |F|   |F|    |F|     |F|F|     |   |F|   |F|    |F|     |F|F|
  ------------------------------     ------------------------------

     Tape location before,             Tape location after call, 
     called with count = 4             returns TAPE_EOV, count = 2
                |                                               |
                V                                               V
  ------------------------------     ------------------------------
  |   |E|   |E|    |E|     |E|E|     |   |E|   |E|    |E|     |E|E|
  |   |O|   |O|    |O|     |O|O|     |   |O|   |O|    |O|     |O|O|
  |   |F|   |F|    |F|     |F|F|     |   |F|   |F|    |F|     |F|F|
  ------------------------------     ------------------------------

     Tape location before,             Tape location after call, 
     called with count = 4             returns TAPE_EOT, count = 2
                |                                                 |
                V                                                 V
  ------------------------------     ------------------------------
  |   |E|    |E|     |E|     |E|     |   |E|    |E|     |E|     |E|
  |   |O|    |O|     |O|     |O|     |   |O|    |O|     |O|     |O|
  |   |F|    |F|     |F|     |T|     |   |F|    |F|     |F|     |T|
  ------------------------------     ------------------------------

RETURN VALUE

c_tpfsf() returns

     TAPE_SUCC (0) -->  successful completion
     TPFSF_FSF -->  device error
     TAPE_EOV  -->  end of volume
     TAPE_EOF  -->  end of file
     TAPE_EOT -->  end of tape

      Tape location before,             Tape location after call,
      called with count = 4             returns TAPE_EOT, count = 2
       |                                                         |
       V                                                         V
  ------------------------------     ------------------------------
  |    |E|    |E|        |E|E|E|     |    |E|    |E|        |E|E|E|
  |    |O|    |O|        |O|O|O|     |    |O|    |O|        |0|O|O|
  |    |F|    |F|        |F|F|T|     |    |F|    |F|        |F|F|T|
  ------------------------------     ------------------------------