Creating an assembler instruction definition

The HLASM parser ships with predefined assembler instructions. You can add to this list of instructions recognized by the parser by creating machine instructions of your own in your user macro file.

Procedure

To create a new assembler instruction definition in your user macro file, complete the following steps:

  1. Do one of the following tasks:
    • In the HLASM tab of the Editor Options preference page, type the name of your user macro file in the User Macro File field.
    • In the HLASM Parser preference page, type the name of your user macro file in the User Macro File field.
  2. Click on the Manage button next to the User Macro File field.
    The Manage Macro Files dialog appears and, if specified, it will load the macro file from the User Macro File field.
  3. Select the desired file from the Macro File combo box, import an existing file, or create a new file.
    The macro file will be loaded into the dialog.
  4. Select the Assembler Instructions tab in the Manage Macro Files dialog.
  5. Click on the New button next to the list of assembler instructions.
    The Create Assembler Instruction wizard appears.
  6. Specify the name of the assembler instruction in the Name field.
  7. Optional. Specify a description for the assembler instruction.
    Note: The description will appear when content assist is invoked.
  8. Select one of the following from the Behavior combo:
    • Add definition: this will add the current assembler instruction definition to any definition with the same name in the base macro file.
    • Replace definition: this will replace the assembler instruction definition in the base macro file with the current one.
    • Remove definition: this will remove the assembler instruction definition from the base macro file when loaded into the parser, thus making the assembler instruction definition unrecognized.
  9. Optional. Click Next.
  10. Optional. Create any desired parameters.
  11. Optional. Click Next.
  12. Optional. Define any desired relationships.
  13. Optional. Click Next.
  14. Optional. Order any created parameters.
  15. Click Finish.