Defining macro files for Assembler programs (z Systems LPEX Editor)

You can define macro files for remote Assembler resources that are open in the z Systems® LPEX Editor in a remote property group or on the HLASM Parser preference page. For local Assembler resources, you must define them in the HLASM Parser preference page. This topic describes how the z Systems LPEX Editor locates macro files. For High Level Assembler files, the HLASM Editor and the z Systems LPEX Editor locate and support copy and macro files differently. For a summary of defining libraries for the two editors, see Copy and macro library support in HLASM files.

About this task

You can define the location of IBM® supplied base macro files and user macro files in two locations:

In a remote property group that is associated with a resource.
In the HLASM Parser preference page. For more information about this preference page, see Setting HLASM Parser preferences.

You can use a user macro file to hide the IBM shipped macros defined in the base macro file from the HLASM parser or to define custom macro syntax to the parser.

Important: User macro file definitions in remote property groups take precedence over the user macro definitions on the HLASM Parser preference page. If an Assembler resource has a remote property group associated with it, but the user macro file is not defined in the property group, then no user macro file is used.

Procedure

To define macro files in a remote property group:

Open a remote property group and click the Assembler tab.
The Assembler Settings page opens.
Click Editor Options in the navigation pane.
The Editor Options page opens.
To specify the macro file that stores the IBM-supplied macro definitions, in the Base Macro File field, click Browse to navigate to the location of the macro file, or type the fully qualified name of the file by using a drive letter or UNC path. You can use environment variables such as %ENVVARS%\tpfhlasm.dat, where %ENVVARS% points to the location of the file. You can also specify a partitioned data set member or a sequential data set.
To specify a user macro file that stores user macro definitions, do these steps:
1. Create a user macro file with any file-name extension.
2. In the User Macro File field, click Browse to navigate to the location of the macro file, or type the fully qualified path of the file, for example, \\HOSTNAME\MyFolder\my_macro_file.dat. You can use environment variables such as %ENVVARS%\tpfhlasm.dat, where %ENVVARS% points to the location of the file. You can also specify a partitioned data set member or a sequential data set.
Optionally, specify the CICS® level that the HLASM parser is to use when EXEC CICS statements are encountered.
Press Ctrl+S to save your changes.

What to do next

If you modify the base macro file, you need to reload it in the editor by doing one of these steps:

Type the following command in the editor command line:
```
reloadTPFMacrosFile
```
Right-click in the editor and select Reload Base Macros File.

To reload a user macro in the z Systems LPEX Editor, do one of these steps:

Type the following command in the editor command line:
```
 reloadUserMacrosFile
```
Right-click in the editor and select Reload User Macros File.