Editing custom instruction colors

Edit online

A custom instruction color file stores data about how particular instructions must be colored in the HLASM parser. You can modify the contents of this file through the Custom Instruction Colors dialog box.

Procedure

To edit a custom instruction color file, complete the following steps:

  1. In the navigation pane of the Preferences window, do one of the following:
    • Select z/OS UNIX Subprojects > Target Environments > Editor Options to open the Editor Options preference page.
    • Select LPEX Editor > z Systems LPEX Editor > HLASM Parser to open the HLASM Parser preference page.
  2. To specify the custom instruction color:
    • In the Custom Instruction Color File field, type the name of the local or remote custom instruction color file that you want to use. You can specify the name of this file using environment variables.
    • Click Browse to browse for the location of the custom instruction color file that you want to use. This file must have a .xml file name extension.
    Note: You can define a maximum of 34 new colors in the custom instruction color file. LPEX Editor style bits are used to define the colors; if other parsers define values for the same styles, a conflict occurs.
  3. Click Edit to open the Custom Instruction Colors dialog box.
    Custom Color Instruction dialog box
  4. In the Groups section, click New to add a new instruction group.
    Each group contains a list of instructions and an associated color.
  5. In the Group Name field, type the name that you want to use to identify this instruction group.
    For example, if you plan to color all branch instructions with a specific color, you can name the instruction group Branch Instruction colors.
  6. In the Instructions group, do the following for each instruction that you want to add to the instruction group:
    1. In the entry field, type the name of the instruction that you want to add to this instruction group.
      For example, BR.
    2. Click Add to add the instruction to the list of instructions contained in this instruction group.
  7. Click Edit Colors to open the Custom Colors dialog box.
  8. Click New to create a new color for your instruction group.
  9. In the Color Name field, type a name for the new color.
    For example, Black on Yellow.
  10. To change the foreground color and select the text color, do the following:
    1. Click Change to open the Color dialog box.
    2. Select the color that you want to apply to the text, and then click OK to apply your changes and close the dialog box.
  11. To change the background color and select the highlight color:
    1. Click Change to open the Color dialog box.
    2. Select the color that you want to apply to the highlight, and then click OK to apply your changes and close the dialog box.
  12. From the Color drop-down list, select the new color that you created.
    The instruction group will color each instruction contained in the group using this color.
  13. Click OK to save your changes to the selected custom instruction color file.