Understanding User Module Locking; Edit Locking - Keithley 4200-SCS Reference Manual

Section 8: Keithley User Library Tool (KULT)

Understanding user module locking

Edit locking

When user libraries are stored on a network, they can be shared between multiple users who are
operating multiple Model 4200-SCS systems. However, in such a situation, multiple users can
simultaneously edit the same user module and then attempt to save it under the same name. To
avoid such conflicts, when a user module is first opened, KULT creates a temporary lock file in the
directory %KI_KULT_PATH%\<library name>\lock.
saving the user module while it is open, unless they rename it (another user may still access and
edit the user module but cannot save the edited module without changing its name).
Effects of edit lock files
When a user tries to access a user module that is already open, a message box appears stating
that another user has locked the module. For example, if two users attempt to access the VSweep
user module in the my_2nd_lib user library (created in
returns data
Figure 8-50
Example of edit-lock caution message
After the second user clicks OK, the user module opens normally. However, if the second user
edits the module while it is locked by the first user, the second user must save it under a new
name, using the KULT File
cannot be the name of any other user module that is located in the %KI_KULT_PATH% directory.
Otherwise, KULT will not allow the user module to be saved.
Edit lock-file naming and content
The lock file is named as follows:
%KI_KULT_PATH%\<library name>\lock\<module name>.lck
For example, when a user opens the VSweep user module in the my_2nd_lib user library, the
following lock file is created:
%KI_KULT_PATH%\my_2nd_lib\lock\VSweep.lck
5. %KI_KULT_PATH% specifically, and %NAME% generally, are environment variables. Each such environment variable
is a string variable that stores a directory-path string. For example, the content of %KI_KULT_PATH% is the location
where KITE and KULT look for user libraries and user modules. The default content of %KI_KULT_PATH% is
C:\S4200\kiuser\usrlib. Use KCON or the
%KI_KULT_PATH%
C:\S4200\YourName\usrlib. For more information about changing the content %KI_KULT_PATH%, refer to
Changing the active user-library directory
8-56
arrays), the second user sees a message similar to the one in
>
Copy Module menu selection. The new name must be unique; it
to another location, for example, to a personal user-library location, such as
earlier in this section.
Return to Section Topics
5
This lock file prevents other users from
Tutorial 2: Creating a user module that
command-line utility to change the content of
set
Model 4200-SCS Reference Manual
Figure 8-50.
4200-901-01 Rev. S / May 2017