Skip to main content

Invalid configuration location when launching CICS Explorer from shared network drive


Technote (troubleshooting)


Problem(Abstract)

When starting CICS Explorer, you see a Pop-up box that says 'Invalid configuration location'. The pop-up indicates that "a common reason is the file system or Runtime Environment does not support file locking for that location." You have CICS Explorer on a shared network drive so that multiple users can launch it from the remote drive.

Symptom

This is the complete text within the pop-up titled 'Invalid configuration location':

Locking is not possible in the directory "<shared drive id>; \CICS_Explorer\configuration\org.eclipse.osgi". A common reason is the file system or Runtime Environment does not support file locking for that location. Please choose a different location, or disable file locking passing "-Dosgi.locking=none" as a VM agent.
<shared drive id>:\CICS_Explorer\configuration\org.eclipse.osgi\.manager\.fileTableLock
(Access is denied.)

Cause

Multi-user install on shared network drive is not configured correctly for Eclipse.

Diagnosing the problem

!ENTRY org.eclipse.osgi 4 0 2012-12-03 14:49:37.466
!MESSAGE Error reading configuration: T:
\CICS_Explorer\configuration\org.eclipse.osgi\.manager\.fileTableLock
(Access is denied.)
!STACK 0
java.io.FileNotFoundException: T:\CICS_Explorer\configuration\org.
eclipse.osgi\.manager\.fileTableLock (Access is denied.)
at java.io.RandomAccessFile.open(Native Method)
at java.io.RandomAccessFile.<init>(RandomAccessFile.java:222)
at org.eclipse.core.runtime.internal.adaptor.Locker_JavaNio.lock
(Locker_JavaNio.java:33)
at org.eclipse.osgi.storagemanager.StorageManager.lock(StorageManager.
java:387)
at org.eclipse.osgi.storagemanager.StorageManager.open(StorageManager.
java:688)
at org.eclipse.osgi.internal.baseadaptor.BaseStorage.initFileManager
(BaseStorage.java:213)
at org.eclipse.osgi.internal.baseadaptor.BaseStorage.initialize
(BaseStorage.java:147)
at org.eclipse.osgi.baseadaptor.BaseAdaptor.initializeStorage
(BaseAdaptor.java:114)
at org.eclipse.osgi.framework.internal.core.Framework.initialize
(Framework.java:185)
at org.eclipse.osgi.framework.internal.core.Framework.<init>(Framework.
java:157)
at org.eclipse.core.runtime.adaptor.EclipseStarter.startup
(EclipseStarter.java:286)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.
java:175)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke
(NativeMethodAccessorImpl.java:48)
at sun.reflect.DelegatingMethodAccessorImpl.invoke
(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:600)
at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:620)
at org.eclipse.equinox.launcher.Main.basicRun(Main.java:575)
at org.eclipse.equinox.launcher.Main.run(Main.java:1408)

Resolving the problem

Review the CICS information center topic Installing on a remote network drive.

Review Eclipse documentation on Eclipse multi user installs.

Re-deploy the shared install by following these steps.

  1. Unzip a fresh copy of CICS Explorer into the install directory
  2. Run <install_directory>\cicsexplorer.exe -initialize (this initializes the basics of the configuration area without any real user-specific data)
  3. Make <install_directory> read only for all your end users

At this point each user that starts Explorer will get their own workspace in <userdir>\.cicsexplorer and their own configuration area in <userdir>\.eclipse\...

If you want the workspace or configuration area to be in a different place (for instance n:\.cicsexplorer_workspace and n:\.cicsexplorer_configuration) then you can add a -data option to your cicsexplorer.ini file as per usual, or -Dosgi.configuration.area=... to the cicsexplorer.ini file *after* the -vmargs line. You would need to edit the cicsexplorer.ini file before you made the install directory read-only!

Product Alias/Synonym

CICS/TS CICS TS CICS Transaction Server

Rate this page:

(0 users)Average rating

Copyright and trademark information

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Rate this page:


(0 users)Average rating

Add comments

Document information

CICS Transaction Server

Explorer


Software version:
4.2


Operating system(s):
z/OS


Reference #:
1620316


Modified date:
2013-03-02

Translate my page

Content navigation