Changing the defaults for compiler options

You can change the defaults for compiler options, and can override fixed compiler options.

Observe the following requirements when coding the changed IGYCOPT macro call:

• Place continuation character (X in the source) in column 72 on each line of the IGYCOPT invocation except the last line. The continuation line must start in column 16. You can break the coding after any comma.
• Do not put a comma in front of the first option in the macro.
• Specify options and suboptions in uppercase. Only suboptions that are strings can be specified in mixed case or lowercase.
• If one of the string suboptions contains a special character (for example, an embedded blank or unmatched right or left parenthesis), the string must be enclosed in apostrophes ('), not in quotation marks ("). A null string can be specified with either contiguous apostrophes or quotation marks.

  To obtain an apostrophe (') or a single ampersand (&) within a string, two contiguous instances of the character must be specified. The pair is counted as only one character in determining whether the maximum allowable string length has been exceeded and in setting the effective length of the string.

• Avoid unmatched apostrophes in any string that uses apostrophes. The error cannot be captured within IGYCOPT itself. Instead, the assembler produces a message such as:

  
  IEV03  *** ERROR ***  NO ENDING APOSTROPHE
  

  This message bears no spatial relationship to the offending suboption. Furthermore, none of the options is properly parsed if this error is committed.
• Code only those options whose default value you want to change. The IGYCOPT macro generates the default value for any option that you do not code.

  For a worksheet to help you plan your default compiler options, see IGYCDOPT worksheet for compiler options. For descriptions of the options, see Enterprise COBOL compiler options.

• Place an END statement after the macro instruction.

Note: When the assembler encounters an unknown keyword on any macro call, like the call to IGYCOPT in igycdopt.asm, it treats the keyword as a positional parameter. Because the current version of the IGYCOPT macro did not check for positional parameters, those unknown keywords were completely ignored. Now, the IGYCOPT macro has been changed so that it detects these positional parameters and emits appropriate error messages. If you rebuild an existing customization macro that used to assemble RC=00, it might fail with assembly errors due to either unknown compiler options that were previously treated as positional parameters and thus ignored, or compiler options coded with incorrect syntax such as OPTION() instead of OPTION= in the COBOL customization macro. You must remove or correct these unknown or improperly coded options and rebuild the IGYCDOPT module.

For additional details about how to code macro calls, see the High Level Assembler for z/OS® Language Reference.