gtpc2m7d | C/C++ Language Support User's Guide |
This function writes a record to a general tape.
Format
#include <tpftape.h>
void tape_write(const char *name, enum t_lvl level);
- name
- This argument is a pointer to type char, which must be a
three-character string identifying the tape to be written to. This
function can only be called for a general tape.
- level
- One of 16 possible values representing a valid data level from the
enumeration type t_lvl, expressed as Dx, where x
represents the hexadecimal number of the level (0-F). This
argument identifies the CBRW containing the record to be written to
tape.
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
- The specified tape must have been opened using tape_open, and
must NOT be currently assigned to the issuing ECB. On completion of
this function, the tape is left in the reserved state, making it
available for use by any ECB.
- The status of the I/O operation can never be determined by the operational
program.
- The working storage block resident on the CBRW level specified as argument
level is released and is no longer available to the operational
program.
- The FARW on the level indicated by argument level is not
altered.
Examples
The following example opens and writes a copy of the record on level D1 to
the VPH tape.
#include <tpftape.h>
·
·
·
tape_open("VPH", OUTPUT);
tape_write("VPH", D1); /* Write block on D1 to tape */
Related Information