gtpc2m79C/C++ Language Support User's Guide

tape_close-Close a General Tape

This function closes a general tape, forcing a logical dismount from the system and causing the tape to be physically rewound and unloaded from the tape drive. The named tape must be physically mounted, logically open, and not currently assigned to the issuing ECB.

Format

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

name
This argument is a pointer to type char, which must be a 3-character string identifying the tape to be closed. This function can only be called for a general tape.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example closes a tape with name VPH.

#include <tpftape.h>

  ·
  ·
  ·
tape_close("VPH");

Related Information

tape_open-Open a General Tape.