When using SAS Enterprise Miner, the diagram that you attempt to open might be locked. Or, your diagrams might continue to run even after you select the Stop icon, or after you restart SAS Enterprise Miner.

SAS Enterprise Miner locks diagrams only when they are currently in use. However, a previous session might have terminated without releasing the lock so that you need to manually break the lock.

To break the lock, follow these steps.

1. Determine the project path

   Start SAS Enterprise Miner and open the project that contains the locked diagram.

   In the SAS Enterprise Miner project, select the project name in the Project Panel. The dialog box shows the value for Path. This is the location of the project on the server. Note this path.

2. Determine the diagram ID

   In the SAS Enterprise Miner project, select the diagram name in the Project Panel. The dialog box shows the ID for this diagram. It is EMWS, EMWS2, or something similar. Note this value.

3. Exit SAS Enterprise Miner
4. Delete lock and status files

   From a shell window for the server machine, open the directory that is specified in the Project Path property. From there, open the directories: workspaces ► EMWS[n] ► System. This system directory contains the indicator files for the status of the diagram.

   Delete all the following files that exist in the system directory:

   ALL files with a "lck" extension

   ALL files with an "st" extension.

   ALL files with a "pid" extension.

   The most important files to delete are the *.st files and the wsrun.lck file.

5. Open your SAS Enterprise Miner project and confirm that you can open the diagram. Indicators that the diagram is locked and/or running should now be gone. If these steps did not correct the problem, then see the "alternative steps" section below.

To break the lock, follow these steps.

1. Determine the project path

   Start SAS Enterprise Miner and open the project that contains the locked diagram.

   In the SAS Enterprise Miner project, select the project name in the Project Panel. The dialog box shows the value for Path. This is the location of the project on the server. Note this path.

2. Determine the diagram ID

   In the SAS Enterprise Miner project, select the diagram name in the Project Panel. The dialog box shows the ID for this diagram. It is EMWS, EMWS2, or something similar. Note this value.

3. Exit SAS Enterprise Miner
4. Delete lock and status files

   From a shell window for the server machine, open the directory that is specified in the Project Path property. From there, open the directories: workspaces ► EMWS[n] ► System. This system directory contains the indicator files for the status of the diagram.

   Delete all the following files that exist in the system directory:

   ALL files with a "lck" extension

   ALL files with an "st" extension.

   ALL files with a "pid" extension.

5. Restart the SAS Analytics Platform Server

   If you started SAS Enterprise Miner with "Personal Workstation" not selected, then there are additional in-memory locks that are held by the SAS Analytics Platform server . The SAS Analytics Platform server should recognize the orphaned process and release the project after about 10 minutes. If the project is not unlocked after that time, then restarting the SAS Analytics Platform server flushes the in-memory locks.

6. Open your SAS Enterprise Miner project and confirm that you can open the diagram. Indicators that the diagram is locked and/or running should now be gone.

As a circumvention to breaking a lock, you can bypass the diagram lock by changing the diagram ID. Use this as a circumvention only if you cannot perform the preceding steps and only if your diagram does not contain a SAS^® Text Miner node.

1. Open the Workspaces directory immediately under the SAS Enterprise Miner project directory.
2. Open the file "workspaces.txt" and edit the value by incrementing the number by 1. For example, if workspaces.txt contains "EMWS2", then edit the value so that it reads "EMWS3". Save and close this file.
3. Determine the ID property value for the locked diagram. Do this by opening the SAS Enterprise Miner project and selecting the diagram in the Project Panel. The Property Panel displays the ID as a value such as EMWS[n], where n is either nothing or an integer. For example, the ID might read "EMWS2".
4. Rename the EMWS[n] directory in the Workspaces directory so that it matches the new value in the workspaces.txt file. For example, rename the directory EMWS2 to EMWS3.
5. Open the file "wsmeta.txt" from within the EMWS[n] directory you just renamed. Edit line two so that the string that follows #!NAME% matches the EMWS[n] value in the workspaces.txt file. Save and close the wsmeta.txt file.

Most recent release

To unlock a SAS Enterprise Miner diagram in the most recent release, see 43711 "Unlocking a SAS^® Enterprise Miner diagram ™".

Operating System and Release Information