gtpc2m7p | C/C++ Language Support User's Guide |
This function causes the record on the specified data level to be written
to a real-time tape, and returns the block to the available pool.
Format
#include <tpftape.h>
void tourc(const char *name, enum t_lvl level);
- name
- This argument is a pointer to type char, which must be a
3-character string identifying the tape to be written to. This function
can only be called for a real-time 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). The
working storage block on this level is the record to be written to
tape.
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
- Use this function to write a record to a real-time tape when the storage
block used for a buffer is no longer needed by the application. If an
invalid tape name is passed as an argument, return is made to the caller with
no action taken.
- Specifying an invalid data level results in a system error with
exit.
- The status of the operation can never be determined by the operational
program.
- If the tape is mounted in blocked mode, the application should not assume
that the execution of this function causes either any physical I/O to be
initiated or the application time-out value to be reset.
Examples
The following example writes the working storage block on level D9 to the
RTA tape. On return, the block is no longer available to the
operational program.
#include <tpftape.h>
·
·
·
tourc("RTA",D9);
Related Information