Mainframe Call Generator (MCG) Refresh - Micro Focus

Mainframe Call Generator Refresh
DB2 precompiler
ATTACH option
Confidential - 10 - December 2004
Randy Witek
Micro Focus Development
MFA Server
attachment type
COBOL compiler
call option
CAF RRSAF NODYNAM -991
CAF RRSAF DYNAM -991
CAF CAF DYNAM OK
CAF CAF NODYNAM OK
RRSAF RRSAF NODYNAM OK
RRSAF RRSAF DYNAM OK
RRSAF CAF DYNAM -981
RRSAF CAF NODYNAM -981
TSO RRSAF NODYNAM -927
TSO RRSAF DYNAM OK
TSO CAF DYNAM OK
TSO CAF NODYNAM -927
Not specified RRSAF NODYNAM -927
Not specified RRSAF DYNAM OK
Not specified CAF DYNAM OK
Not specified CAF NODYNAM -927
Explanation for SQL return codes:
SQL result
-981 The SQL statement failed because the RRSAF connection is not in a state that allows
SQL operations.
-927 The language interface was called when the connecting environment was not
established. The program should be invoked under the DSN command.
-991 Call attach was unable to establish an implicit connect or open to DB2.
The table shows that the combination of the COBOL DYNAM option for dynamic program calls
and the ATTACH(TSO) DB2 precompilation option (or simply omitting the ATTACH option)
provides flexibility in the actual connection type. This is because the ATTACH(TSO) and
ATTACH() specifications generate a call to entry point DSNHLI for SQL execution. MFA Server
provides a dummy DSNHLI entry point that becomes the target of dynamic calls. The MFA
Server DSNHLI routine routes the SQL execution to the attachment facility (RRSAF or CAF) that
has been selected, or defaulted, at startup. The ATTACH(RRSAF) and ATTACH(CAF)
specifications generate calls to DSNHLIR and DSNHLI2, respectively, and no dummy entry points
are provided for these attachments. Therefore, the real DB2 interface routines are selected,
either statically or dynamically, and these interface routines expect the required attachment to
have been activated by MFA Server.