gtpc2m7z | C/C++ Language Support User's Guide |
This function swaps the storage block that is held in a data event control
block (DECB) with an entry control block (ECB) data level.
Format
#include <c$decb.h>
void tpf_decb_swapblk(TPF_DECB *decb, enum t_lvl level);
- decb
- A pointer to the DECB.
- level
- One of 16 possible values representing a valid ECB data level from
enumeration type t_lvl, expressed as Dx, where x
represents the hexadecimal number of the level (0-F).
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
- The DECB is an alternative to standard ECB data level information, which
is used to specify information about I/O request core block reference word
(CBRW) and file address reference word (FARW) fields. The DECB fields
specify the same CBRW and FARW information without requiring the use of an ECB
data level. All the same requirements and conditions that apply to the
CBRW and FARW in the ECB also pertain to the same field information in the
DECB.
- Applications that use DECBs must be compiled with the C++ compiler.
- Only the CBRW is swapped; the FARW in both the ECB data level and
DECB remain unchanged.
- This function is implemented in dynamic link library (DLL)
CTAD. You must use the definition side-deck for DLL CTAD to link-edit
an application that uses this function.
Examples
The following example swaps the core block and associated information
between ECB data level 2 (D2) and the indicated DECB.
#include <c$decb.h>
·
·
·
TPF_DECB *decb;
·
·
·
tpf_decb_swapblk(decb, D2); /* swap storage block on decb and D2 */
·
·
·
Related Information
See TPF Application Programming for more
information about DECBs.