Setting HLASM parser properties at the file level

When you open an Assembler file in the z Systems® LPEX Editor that uses the HLASM parser, an additional LPEX Editor preference page appears for this file. You can use this preference page to set HLASM parser properties at the file level.

1. Open an Assembler file in the z Systems LPEX Editor.
2. In the navigation pane of the Preferences window, double-click the LPEX Editor node to open the tree of available preference pages.
3. From the list of LPEX Editor preference pages, double-click the node that represents the path of the file you are editing to open the list of available file-level preference pages.
4. Click HLASM Parser to open the HLASM Parser preference page.
5. From the Case Sensitivity Level group, do one of the following:
   • Click the No Case - Never Enforce Case radio button to select the least sensitive level. Use this level to specify all opcodes and operands in any case.
   • Click the Default Case - Default Assembler Case radio button to select the default level that is used by the assembler and the parser. Use this level to specify opcode in any case; you can specify operands in any case, excluding macro instructions. However, if you are using a macro that has the keyword operand KEY=A, it is not case sensitive.
   • Click the All Case - Always Enforce Case radio button to select the most sensitive level. This level does not allow any conversion to text before parsing. The opcode must appear in the same case as in the syntax description or in the user macro file description. Operands are parsed in their current state and no changes are made.
   The case sensitivity level determines what is acceptable and what should be flagged as an error. Depending on the case sensitivity level that is set, the parser ignores or flags case mismatches. By default, the parser is set to the same case sensitivity level as the assembler. However, if you change the case sensitivity level of the assembler, you can change the case sensitivity level of the parser.
6. Select the Use Branch Label Coloring check box to determine if invalid branch labels are flagged as errors.
   This feature indicates when you are branching to a label that does not exist. Nonexistent labels are colored red in your file to indicate an error. References to labels are updated each time that a label is inserted into or removed from the file.

   Tip: This feature can significantly decrease the speed when parsing large files. Clear theUse Branch Label Coloring checkbox to disable this feature if you experience performance issues when parsing large files.
7. Select the Use Custom Instruction Coloring check box to indicate that you want to use the custom instruction color file (and the color associations specified in that file) to color the instructions in the file that you are currently editing.
8. Click Save as Custom Defaults to persist your settings and apply them as default settings to all files that use the HLASM parser.
9. Click Clear Custom Defaults to restore all default settings to the default values that were shipped with the product.
   All files that do not specify values for the parameters on this preference page use the shipped defaults.
10. Click Restore Defaults to apply the default settings that were shipped with the product to the file that you are currently editing.
    Note: This does not cause the current file to use the default settings that are stored in the custom defaults file.
11. Click Apply to save your selections in the preference page. The settings that you selected are only applied to the current file that you are editing.