For the latest version of JMP Help, visit JMP.com/help.


Scripting Guide > Creating Projects > Run Startup Scripts to Control Workspaces
Publication date: 05/05/2023

Run Startup Scripts to Control Workspaces

A workspace is either a project window or the windows that are not in a project (for example, the home window). A default workspace loads when JMP starts, and then each time you create or open a project, JMP creates another workspace.

Consider writing a workspace startup script to customize variables for a specific project. You might also construct a new customized window in a workspace startup script to put a copy of that window in each project. This is an alternative to having a single copy of the script that runs outside of projects.

The workspace startup script runs each time a new workspace loads. This means that the workspace startup script runs once when JMP starts (when the “default workspace” loads) and then runs again each time a new project is loaded. The workspace startups script runs in the context of the project, so any windows it opens or variables it sets are for that project only.

Name the script workspaceStart.jsl and place it in one of the following folders, as appropriate for your operating system. When JMP starts, JMP looks for the workspaceStart.jsl script in these folders in the order in which they are listed here. The first one that is found is run, and the search immediately stops.

Note: Some path names in this section refer to the “JMP” folder. On Windows, in JMP Pro, the “JMP” folder is named “JMPPro”.

On Windows:

1. C:\Users\<username>\AppData\Roaming\SAS\JMP\17

2. C:\Users\<username>\AppData\Roaming\SAS\JMP

On macOS:

1. /Users/<username>/Library/Application Support/JMP/17

2. /Users/<username>/Library/Application Support/JMP

The workspaceStart.jsl script runs only for a particular user on a computer. You can add a script named workspaceStartAdmin.jsl in one of the following places, as appropriate for your operating system. This script is run for every user on a computer. JMP runs workspaceStartAdmin.jsl first if found. Then JMP runs workspaceStart.jsl if found.

On Windows:

1. C:\ProgramData\SAS\JMP\17

2. C:\ProgramData\SAS\JMP

On macOS:

1. /Library/Application Support/JMP/17

2. /Library/Application Support/JMP

Want more information? Have questions? Get answers in the JMP User Community (community.jmp.com).