Creating a macro instruction definition

You can define your own macros to add to the IBM®-supplied macro definitions contained in the IBM macro files provided with the product.

To create a new assembler 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 Macro Instructions tab in the Manage Macro Files dialog.
5. Click on the New button next to the list of assembler instructions.
   The Create Macro Instruction wizard appears.
6. Specify the name of the macro instruction in the Name field.
7. Optional. Specify a description for the macro 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 macro instruction definition to any definition with the same name in the base macro file.
   • Replace definition: this will replace the macro instruction definition in the base macro file with the current one.
   • Remove definition: this will remove the macro instruction definition from the base macro file when loaded into the parser, thus making the macro 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.