Creating a machine instruction definition

The HLASM parser ships with predefined machine 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.

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

1. Do one of the following actions:
   • 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 Machine Instructions tab in the Manage Macro Files dialog.
5. Click on the New button next to the list of machine instructions.
   The Create Machine Instruction wizard appears.
6. Specify the name of the machine instruction in the Name field.
7. Optional. Specify a description for the machine 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 machine instruction definition to any definition with the same name in the base macro file.
   • Replace definition: this will replace the machine instruction definition in the base macro file with the current one.
   • Remove definition: this will remove the machine instruction definition from the base macro file when loaded into the parser, thus making the machine instruction definition unrecognized.
9. Optional. Click Next.
10. Optional. Create any desired parameters.
11. Optional. Click Next.
12. Optional. Order any created parameters.
13. Click Finish.