gtpc2m8uC/C++ Language Support User's Guide

tsync-Synchronize a Tape

This function forces the synchronization of any general or realtime tape. Synchronization ensures that the physical tape position is the same as the application's detection of the tape position. This eliminates any discrepancies introduced by buffering, either logical (tapes mounted in blocked mode) or physical (tapes mounted on a device operating in buffered mode).

Format

#include   <tpftape.h>
void       tsync(const char *name);

name
This argument is a pointer to type char, which must be a 3-character string identifying the tape to be synchronized.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example synchronizes the VPH tape.

#include <tpftape.h>

  ·
  ·
  ·
waitc(); tsync("VPH"); if (waitc()) { serrc_op(SERRC_EXIT,0x1234,"ERROR SYNCHRONIZING VPH TAPE",NULL) ; }

Related Information