Creating a user macro definition file

Edit online

You can create new user macro definitions for the HLASM parser and store these definitions in a user macro file.

Procedure

To create a user macro definition, complete the following steps:

  1. Do one of the following actions:
    • In the HLASM tab of the Editor Options preference page (see Editing HLASM options), 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.
    • In the Editor Options section on the Assembler page of the Properties Editor, type the name of your user macro file in the User Macro File field.
  2. Click the Manage button next to the User Macro File field.
    The Manage Macro Files dialog appears and, if a macro file is specified in the User Macro File field, it is loaded.
  3. Create a macro file as follows:
    1. Click New next to the macro file combo. The New File dialog is displayed.
    2. Specify the file to create, or click Browse to locate the file.
    3. Click Finish .
    The file is loaded into the Manage Macro File dialog.
  4. Optional. Click the General tab and specify general HLASM parser options.
  5. Optional. Click the Macro Instruction tab and add new macros instruction definitions.
  6. Optional. Click the Assembler Instruction tab and add new assembler instruction definitions.
  7. Optional. Click the Machine Instruction tab and add new machine instruction definitions.

What to do next

Tip: If you change values for the User Macro File field and you already have files open in z Systems® LPEX Editor, you must close and reopen your files for your changes to take effect. Alternatively, you can use the updateProfile command to register your changes with the parser. If you change this file after the preference is already set, you must reload it for the parser to reread the file and load any new definitions. To reload the user macro file, right-click in the file to open the menu. Select Reload User Macros File to reload the file or issue the reloadUserMacrosFile command.