gtpc2m32 | C/C++ Language Support User's Guide |
This function interchanges or flips the contents of 2 block
reference words (CBRWs), file address reference words (FARWs), file address
reference word extensions, and detailed error bytes (SUDs, or CE1SUDs).
Format
#include <tpfapi.h>
void flipc(enum t_lvl level1, enum t_lvl level2);
- level1
- 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 is
the first data level that participates in the status interchange.
- level2
- 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 is
the second data level that participates in the status interchange.
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
- Specifying the same data level for both parameters results in no action
being taken. Specifying an invalid data level results in a system error
with exit.
- Neither level specified may have an I/O operation in progress where the
status of the storage block is unknown until a subsequent waitc
call.
Examples
The following example interchanges CBRWs, FARWs, file address reference
word extensions, and detail error bytes on levels D2 and DF.
#include <tpfapi.h>
·
·
·
flipc(D2,DF);
Related Information
None.