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):