IFCSA (HLI function)
The conventions used on this page are described in Function call notation conventions.
Summary
- Description
- The IFCSA call (Common System Area) passes the address of the Common System Area to the CICS interface in IFAM2.
- Thread type
- multiple cursor IFSTRT, single cursor IFSTRT
- IFCALL function number
- 96
Syntax
IFCSA(CSA_ADDR)
- Compile-only form
- Not available
- Execute-only form
- Not available
| Parameter | Description |
|---|---|
| CSA_ADDR | [I,i,r] The CSA (Common System Area) address is a required input parameter for the CICS interface. Specify the address as an integer value. |
Usage notes
Note: The IFCSA call is still provided for purposes of upward compatibility, but it no longer performs any function.
Use the IFCSA call only for an IFAM2 host language job with CICS. IFCSA is valid for use Model 204 releases before Version 3.1. For Model 204 Version 3.1 and later, the CSA control block is no longer needed and therefore, the IFCSA call is not required.
Coding examples
Before a program issues any operational Host Language Interface calls, the address of the CSA must be passed to the interface by using one of the following special calls in the host language program:
| COBOL: | CALL 'IFCSA' USING DFHCSADS |
|---|---|
| PL/1 Optimizer: | CALL IFCSA (DFHCSADS) |
| Assembler: | CALL IFCSA, ((13)),VL |
where the address is declared as:
DCL IFCSA ENTRY OPTIONS (ASM ENTER):