gtpc2m80 | C/C++ Language Support User's Guide |
This function validates that a specified data event control block (DECB) is
an active and valid DECB.
Format
#include <c$decb.h>
DECBC_RC tpf_decb_validate(TPF_DECB *decb);
- decb
- A pointer to the DECB.
Normal Return
DECBC_OK.
Error Return
DECBC_NOTVALID.
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.
- 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 validates a DECB address.
#include <c$decb.h>
·
·
·
TPF_DECB *decb;
·
·
·
if ( tpf_decb_validate(decb) == DECBC_OK )
{
/* DECB is valid */
} else
{
/* DECB is not valid */
}
Related Information
See TPF Application Programming for more
information about DECBs.