bdfp1m19 | Programming Concepts and Reference |
Use this function to free an entry control block (ECB) data level.
You can specify the following:
- A specific data level as a number (0x00 to 0x15)
- An open subfile, which frees the data level held by that subfile
- All levels held by SW00SR references.
Format
void dffrl_lev(dft_lvl lev);
- lev
- is the data level you want to free, which can be in the range
D0-DF.
Entry Requirements
None.
Normal Return
The specified data level is freed.
Error Return
The error indicators in the SW00RTN field of the SW00SR slot have no
meaning for this function.
Programming Considerations
- The type definitions (for example, dft_fil,
dft_ref, and dft_kyl) are defined in the
c$cdfapi.h header file.
- If you are processing traditional (P-type) files together with TPFDF
files, you cannot be sure whether the required ECB levels are free. To
avoid conflict, you can ensure that a required ECB level is free by specifying
a dffrl function before calling a program or function that uses a
specific data level.
Examples
The following example frees level DB.
dffrl_lev(DB);
Related Functions
None.