Separating IMS suboptions

Because of the concatenation of multiple SQLIMS option specifications, you can separate IMS suboptions (which might not fit in one CBL statement) into multiple CBL statements.

About this task

The options that you include in the suboption string are cumulative. The compiler concatenates these suboptions from multiple sources in the order that they are specified. For example, suppose that your source file contains the following code:


//STEP1 EXEC IGYWC, . . .
//  PARM.COBOL='SQLIMS("string1")'
//COBOL.SYSIN DD *
    CBL SQLIMS("string2")
    CBL SQLIMS("string3")
    IDENTIFICATION DIVISION.
    PROGRAM-ID. DRIVER1.

During compilation, the compiler passes the following suboption string to the IMS SQL coprocessor:


"string1 string2 string3"

The concatenated strings are delimited with single spaces. If the compiler finds multiple instances of the same SQLIMS suboption, the last specification of that suboption in the concatenated string takes effect. The compiler limits the length of the concatenated IMS suboption string to 4 KB.

Related concepts  
IMS SQL coprocessor