IFCSA (HLI function)

From m204wiki
Revision as of 21:09, 11 July 2016 by ELowell (talk | contribs)
Jump to navigation Jump to search

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