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()