DFHEIB - Execute Interface Block
Enhanced Definition
The `DFHEIB` (Execute Interface Block) is a CICS control block that provides an application program with information about the current task and the results of the most recently executed CICS command. It is automatically defined and populated by CICS for every task, serving as the primary communication area between CICS and the application program. The Execute Interface Block (DFHEIB) is a control block automatically created and managed by CICS (Customer Information Control System) for each active task. It serves as the primary communication area between a CICS application program (e.g., written in COBOL, PL/I, Assembler) and the CICS Transaction Server, providing crucial system and command-specific information.
Key Characteristics
-
- Automatic Generation: CICS automatically defines and populates the
DFHEIBfor every CICS task, making it available to the application program without explicit declaration (though aCOPY DFHEIBLKstatement is typically used in COBOL). - Task-Specific Information: It contains vital information about the current task, such as the transaction ID (
EIBTRNID), terminal ID (EIBTRMID), program name (EIBPGM), and the date and time (EIBDATE,EIBTIME). - Command Response Codes: The
DFHEIBholds the response code (EIBRESP) and a more detailed response code (EIBRESP2) for the last CICS command executed, indicating success or the type of error encountered. - Read-Only for Applications: Most fields within the
DFHEIBare read-only for the application program; CICS is responsible for updating them. Attempting to modify them can lead to unpredictable behavior or program abends. - Language-Agnostic Structure: While its definition varies slightly by language (e.g.,
DFHEIBLKfor COBOL,DFHEIBfor PL/I), the logical structure and content are consistent across CICS-supported programming languages. - Addressability: In COBOL, it's typically included using
EXEC CICS ADDRESS EIB(DFHEIBPTR)orEXEC CICS ASSIGN EIBADDR(DFHEIBPTR)to establish addressability, though modern COBOL compilers often handle this implicitly whenDFHEIBLKis copied.
- Automatic Generation: CICS automatically defines and populates the
Use Cases
-
- Error Handling: After any CICS command, the application program checks `EIBRESP
Related Products
Related Vendors
IBM
646 products
Applied Software
7 products