# Register User Utilities

Run external programs from within the HyperStudy interface, such as within the Directory.

Register user utilities in HyperStudy or by editing the preferences file.

## Register User Utilities in HyperStudy

1. From the menu bar, click Edit > Register User Utility.
The Register User Utility dialog opens.
2. Add a user utility.
1. Click Add User Utility.
2. In the Add dialog, enter a label for the user utility and click OK.
3. In the Path column, enter the location of the user utility to be registered.
4. Optional: In the Arguments column, enter any arguments for the user utility.
5. Click Close to exit the user utility registration.

## Register User Utilities by Editing the Preferences File

Register user utilities in the *BeginUserUtilityDefaults section of the preferences_study.mvw file.

1. In a text editor, open the preferences_study.mvw file.
You can find the preferences_study.mvw file in the HyperWorks installation directory under <install directory>/hw/prefinc/.
2. Search for the syntax *BeginUserUtilityDefaults.
3. If you are working with a Windows operating system, append the first list of *RegisterUserUtility statements. Otherwise, you will need to append the second list of *RegisterUserUtility statements.
4. Immediately following the existing *RegisterUserUtility statements, register further user utilities using the following syntax:
*RegisterUserUtility (script_name,"script_label","utility interpreter", "utility path")
where:
script_name
Unique name for the utility.
script_label
Name used within HyperStudy to reference the utility.
Note: This name must be enclosed in double quotes.
utility interpreter
Full path of the interpreter of the utility, including file name and extension.
For example, wish.exe for a Tcl script.
utility path
Full path of the utility, including the file name and extension.
5. Save the preferences_study.mvw file.

### Example: Register Tcl Script in the Preferences File

In this example, a Tcl script is added to the user utility defaults section of the preferences_study.mvw file for a Windows operating system.
*BeginUserUtilityDefaults()
*RegisterUserUtilityScript(u_1,"U1","C:\wish.exe","C:\param.tcl")
*EndUserUtilityDefaults()