Using IDMSBALI or #BALI

Products

• IDMS
• IDMS - Database

Issue/Introduction

This article describes the use of the #BALI macro. For example, when it is required and what it does exactly.

Environment

Release: All supported releases.

Resolution

Either by specifying INCLUDE IDMSBALI during the link edit or by coding the #BALI macro in a user-mode assembler application program, the constant IDCSACON will be included in the program. This is a small CSECT that contains a full-word to hold the IDMS CSA address which is needed for many IDMS assembler commands/macros. 

DML REF ASSEMBLER 
Chapter: DML Precompile, Assembly, and Link-Edit JCL 
Section: Link-Edit Considerations 

"The modules involved in the link edit of an application program contain six external references. Some must be resolved depending on the mode of operation. The following table lists and explains the external references; unresolved references should be checked against this table to ensure proper linkage to the program." 

Relevant portion of the table:

Reference	Referenced by	Resolved by	Comments
ABORT	Application Program	IDMSCANC	Should be resolved
IDCSACON	Application Program	IDMSBALI	Must be resolved; alternatively, include the #BALI macro in the application program if you use the #RETURN macro