Difference between revisions of "WDSCi troubleshooting"

From MidrangeWiki
Jump to: navigation, search
(WDSCi troubleshooting)
 
(Added fix for Context-sensitive (F1) help not working in 9.0.1)
 
(38 intermediate revisions by 8 users not shown)
Line 3: Line 3:
 
First, [http://archive.midrange.com/wdsci-l/ search the archives]
 
First, [http://archive.midrange.com/wdsci-l/ search the archives]
  
'''How do I clear the cache?'''
+
 
 +
 
 +
==How do I clear the [[cache]]?==
  
 
There are two caches to be cleared:
 
There are two caches to be cleared:
Window > Preferences > Remote Systems > File Cache > Clear-"Clear cached files"
+
*Window > Preferences > Remote Systems > File Cache > Clear-"Clear cached files"
  
Window > Preferences > Remote Systems > iSeries > Cache > Clear-"clear the current cache"
+
*Window > Preferences > Remote Systems > iSeries > Cache > Clear-"clear the current cache"
  
 +
*NOTE! You must restart your workspace immediately after clearing the cache!
  
'''Where is my workspace stored?'''
+
You can also set a maximum cache size here as well.  The File Cache is stored on disk in your [[workspace]] under {{code|\Workspace\RemoteSystemsTempFiles\(connection name)\(name...)}}
 +
 
 +
==Where is my [[workspace]] stored?==
 
File > Switch workspace
 
File > Switch workspace
 +
 +
==Where is the error log stored?==
 +
* In your [[workspace]], in a directory called {{code|.metadata}}, in a file called {{code|.log}} 
 +
* Certain errors are not captured/logged by WDSC, but by the underlying Eclipse platform.  There is an Eclipse view that allows you to look at Eclipse errors: {{code|Window->Show View->Other->PDE Runtime->Error Log}}
 +
 +
==I'm getting a 'Workspace in use' error==
 +
*Use Windows Explorer and drill down into your workspace. 
 +
*There's a directory called '''.metadata''' 
 +
*Inside that directory is a file called '''.lock''' 
 +
*Delete that file and restart WDSC. 
 +
*If you can't delete that file, you may have some bits of Eclipse still running. 
 +
*Either reboot your PC or use the Windows task manager to kill eclipse.exe 
 +
*You may also have to kill the Java Virtual Machine, too.  It'll be called javaw.exe.
 +
*Unfortunately, you'll probably have more than one 'javaw.exe'.  I'd kill the one using the most memory, but that's no guarantee to be the right one, so watch out!  In this case a reboot is a safer mechanism.
 +
 +
==Compile buttons/keystrokes not working and other miscellaneous problems==
 +
A plethora of errors and odd behaviors can often be corrected by starting with the "-clean" switch appended to the command used to start the workbench.  e.g.,  For WDSC V7, start the workbench with the following command: "'''C:\Program Files\IBM\SDP70\eclipse.exe -product com.ibm.etools.iseries.wdsc.welcome.ide -clean'''".  Substitute the location of exclipse.exe where it is installed on your computer--i.e., "Program Files\IBM\SDP70" may be different.
 +
 +
*Exit the workbench.
 +
*Right-click on the icon used to start the workbench.
 +
*Select properties.
 +
*Copy the Target command string by pressing Ctrl+C.
 +
*Click Cancel.
 +
*Click Start, then Run.
 +
*Paste the command string by pressing Ctrl+V.
 +
*Type a space followed by '''-clean'''
 +
*Press '''Enter'''.
 +
 +
The workbench will start.  It will take longer than usual while many internal structures and links are rebuilt.
 +
 +
==Workspace crashes error  V6 ==
 +
You should do a back up save of the workspace first.
 +
 +
*Try deleting the .registry file
 +
*Shut down WDSCi.
 +
*Delete  the .registry file.
 +
*When WDSCi restarts it should rebuild the file.
 +
 +
* Recent install of the Arcad Software plugins and since then most of the iSeries languages are not showing colored tokenization.
 +
 +
* Upgrade problem  from 6.0.0 to 6.0.1. 
 +
* It turned out some of the IBM plugins were not being picked up by Eclipse. 
 +
* Resolved the problem by navigating to:
 +
 +
\IBM\WDSC\6.0\eclipse\configuration
 +
Move the folders named:
 +
org.eclipse.core.runtime
 +
org.eclipse.osgi
 +
org.eclipse.update
 +
To a backup location and then start WDSC. 
 +
This will force it to rebuild its plugin configuration based on what is installed.
 +
*Assuming the problem is fixed, you can then just delete the folders you moved as they will have been recreated.
 +
 +
* If this does not fix the problem you most likely need to do a reinstall.
 +
 +
==Workspace crashes error  V7 ==
 +
You should do a back up save of the workspace first.
 +
 +
*You could try to delete
 +
\.metadata\.plugins\org.eclipse.core.resources\.snap
 +
and
 +
\.metadata\.plugins\org.eclipse.core.resources\.root\.markers.snap
 +
 +
==I have a custom compile command.  How do I get the error list back into WDSC?==
 +
See the Custom Compile Command tip at [[WDSC_tips#Custom_Compile_Commands|WDSC tips]]
 +
 +
==RSEF1002E Error ==
 +
 +
Operation failed. File system input or output error.
 +
*Exit WDSCi and reboot your PC.
 +
*I changed my password recently. For some reason my password got disabled. Also my Netserver password was disabled. (see Disabled User IDs in Netserver via Navigator.)
 +
*I reset my password, had my Netserver ID enabled and rebooted, all was OK.
 +
 +
 +
==Debug SEP and UPDPROD(*NO)==
 +
* Error message, 'Member <membername> cannot be opened while UPDPROD(*NO)'
 +
In WDSC prior to Rational v7.5 try:
 +
*Preferences
 +
*Run/Debug
 +
*iSeries Debug,
 +
you'll see an Update Production Files checkbox.
 +
 +
In Rational for i v7.5 try:
 +
*Window
 +
*Preferences
 +
*Run/Debug
 +
*IBM i Debug
 +
you'll see an Update Production Files checkbox.
 +
 +
== JVM Terminated. Exit Code = 1==
 +
The Rational Knowledge Base article [http://www-1.ibm.com/support/docview.wss?uid=swg21255195 1255195] says that this might be a problem with the cache being used by the {{code|-Xshareclasses:singleJVM}} switch in the {{code|eclipse.ini}} file.  Their solution:
 +
 +
To resolve the problem, the corrupted cache needs to be destroyed. It will be rebuilt the next time the product is launched). To destroy the cache:
 +
 +
  1. Open a command prompt.
 +
  2. Navigate to {{code|.../SDP70/jdk/jre/bin}}
 +
  3. Enter the following command:
 +
          * On Microsoft® Windows®:
 +
            {{code|javaw.exe -Xshareclasses:destroy}}
 +
          * On Linux®:
 +
            {{code|./javaw -Xshareclasses:destroy}}
 +
  4. The product should now launch normally
 +
 +
==Outline view file not showing fields==
 +
If the outline view of an externally defined file does not show the fields coming from it, check to see that the file is in a library you are authorised to.  You will need *CHANGE authority to the library.
 +
 +
==Compiles not working: no error, just no compile==
 +
Check to see that the back end servers are running:
 +
 +
Right click on the iSeries Objects node of your connection and select "Verify  Connection".
 +
 +
Connection to Central service . . . . . . . . . . . . .successful
 +
Connection to Command service . . . . . . . . . . . . .successful
 +
Connection to Data Queue service . . . . . . . . . .successful
 +
Connection to File service . . . . . . . . . . . . . . . .successful
 +
Connection to Record Access service . . . . . . .successful
 +
Connection to Signon service . . . . . . . . . . . . . .successful
 +
 +
If that doesn't help, try changing the job description to {{code|log(4 0 *seclvl)}} and observe the messages in the job log.
 +
 +
If that doesn't work, try compiling interactively to see if the symptoms change:
 +
{{code|Remote Systems->iSeries->Command Execution}}
 +
 +
===Resolutions reported===
 +
* EVFEVENT file was set to MAXMBRS(1).  Normally, it is set to MAXMBRS(*NOMAX).
 +
* Apparently the root cause is running an iSeries Search without an EVFEVENT file in *CURLIB.  The search creates one with MAXMBRS(1).
 +
* Either delete the EVFEVENT file or use CHGPF to set it to MAXMBRS(*NOMAX).
 +
 +
==Context Sensitive help stops working==
 +
Normally in RDi9, pressing F1 on an OPCODE in RPG, or a command in CL, or a verb in COBOL will bring up the relevant section of the appropriate manual in a browser window.  At times the structures needed to support this can get corrupted.  To fix them, you can rename two directories in your workspace.
 +
 +
Here's the necessary steps (courtesy of Mike Hockings on the mailing list):
 +
*Shut down RDi.
 +
*Rename the directory C:\Users\<your-userid>\.eclipse\org.eclipse.platform_4.2.0_2139427097\configuration\com.ibm.ut.help.common\ to C:\Users\<your-userid>\.eclipse\org.eclipse.platform_4.2.0_2139427097\configuration\com.ibm.ut.help.common-original
 +
*Rename the directory <workspace>\.metadata\.plugins\org.eclipse.core.runtime\.settings\org.eclipse.help.base.prefs to <workspace>\.metadata\.plugins\org.eclipse.core.runtime\.settings\org.eclipse.help.base.prefs-original
 +
*Restart RDI 9.0.1 and again enjoy your F1 help goodness!
 +
 +
==Categories==
 +
 +
[[Category:WDSC]]

Latest revision as of 20:23, 11 April 2014

Tips on troubleshooting WDSCi:

First, search the archives


How do I clear the cache?

There are two caches to be cleared:

  • Window > Preferences > Remote Systems > File Cache > Clear-"Clear cached files"
  • Window > Preferences > Remote Systems > iSeries > Cache > Clear-"clear the current cache"
  • NOTE! You must restart your workspace immediately after clearing the cache!

You can also set a maximum cache size here as well. The File Cache is stored on disk in your workspace under \Workspace\RemoteSystemsTempFiles\(connection name)\(name...)

Where is my workspace stored?

File > Switch workspace

Where is the error log stored?

  • In your workspace, in a directory called .metadata, in a file called .log
  • Certain errors are not captured/logged by WDSC, but by the underlying Eclipse platform. There is an Eclipse view that allows you to look at Eclipse errors: Window->Show View->Other->PDE Runtime->Error Log

I'm getting a 'Workspace in use' error

  • Use Windows Explorer and drill down into your workspace.
  • There's a directory called .metadata
  • Inside that directory is a file called .lock
  • Delete that file and restart WDSC.
  • If you can't delete that file, you may have some bits of Eclipse still running.
  • Either reboot your PC or use the Windows task manager to kill eclipse.exe
  • You may also have to kill the Java Virtual Machine, too. It'll be called javaw.exe.
  • Unfortunately, you'll probably have more than one 'javaw.exe'. I'd kill the one using the most memory, but that's no guarantee to be the right one, so watch out! In this case a reboot is a safer mechanism.

Compile buttons/keystrokes not working and other miscellaneous problems

A plethora of errors and odd behaviors can often be corrected by starting with the "-clean" switch appended to the command used to start the workbench. e.g., For WDSC V7, start the workbench with the following command: "C:\Program Files\IBM\SDP70\eclipse.exe -product com.ibm.etools.iseries.wdsc.welcome.ide -clean". Substitute the location of exclipse.exe where it is installed on your computer--i.e., "Program Files\IBM\SDP70" may be different.

  • Exit the workbench.
  • Right-click on the icon used to start the workbench.
  • Select properties.
  • Copy the Target command string by pressing Ctrl+C.
  • Click Cancel.
  • Click Start, then Run.
  • Paste the command string by pressing Ctrl+V.
  • Type a space followed by -clean
  • Press Enter.

The workbench will start. It will take longer than usual while many internal structures and links are rebuilt.

Workspace crashes error V6

You should do a back up save of the workspace first.

  • Try deleting the .registry file
  • Shut down WDSCi.
  • Delete the .registry file.
  • When WDSCi restarts it should rebuild the file.
  • Recent install of the Arcad Software plugins and since then most of the iSeries languages are not showing colored tokenization.
  • Upgrade problem from 6.0.0 to 6.0.1.
  • It turned out some of the IBM plugins were not being picked up by Eclipse.
  • Resolved the problem by navigating to:
\IBM\WDSC\6.0\eclipse\configuration
Move the folders named:
org.eclipse.core.runtime
org.eclipse.osgi
org.eclipse.update
To a backup location and then start WDSC.  
This will force it to rebuild its plugin configuration based on what is installed.
  • Assuming the problem is fixed, you can then just delete the folders you moved as they will have been recreated.
  • If this does not fix the problem you most likely need to do a reinstall.

Workspace crashes error V7

You should do a back up save of the workspace first.

  • You could try to delete
\.metadata\.plugins\org.eclipse.core.resources\.snap
and
\.metadata\.plugins\org.eclipse.core.resources\.root\.markers.snap

I have a custom compile command. How do I get the error list back into WDSC?

See the Custom Compile Command tip at WDSC tips

RSEF1002E Error

Operation failed. File system input or output error.

  • Exit WDSCi and reboot your PC.
  • I changed my password recently. For some reason my password got disabled. Also my Netserver password was disabled. (see Disabled User IDs in Netserver via Navigator.)
  • I reset my password, had my Netserver ID enabled and rebooted, all was OK.


Debug SEP and UPDPROD(*NO)

  • Error message, 'Member <membername> cannot be opened while UPDPROD(*NO)'

In WDSC prior to Rational v7.5 try:

  • Preferences
  • Run/Debug
  • iSeries Debug,

you'll see an Update Production Files checkbox.

In Rational for i v7.5 try:

  • Window
  • Preferences
  • Run/Debug
  • IBM i Debug

you'll see an Update Production Files checkbox.

JVM Terminated. Exit Code = 1

The Rational Knowledge Base article 1255195 says that this might be a problem with the cache being used by the -Xshareclasses:singleJVM switch in the eclipse.ini file. Their solution:

To resolve the problem, the corrupted cache needs to be destroyed. It will be rebuilt the next time the product is launched). To destroy the cache:

  1. Open a command prompt.
  2. Navigate to .../SDP70/jdk/jre/bin
  3. Enter the following command:
         * On Microsoft® Windows®:
            javaw.exe -Xshareclasses:destroy
         * On Linux®:
            ./javaw -Xshareclasses:destroy
  4. The product should now launch normally

Outline view file not showing fields

If the outline view of an externally defined file does not show the fields coming from it, check to see that the file is in a library you are authorised to. You will need *CHANGE authority to the library.

Compiles not working: no error, just no compile

Check to see that the back end servers are running:

Right click on the iSeries Objects node of your connection and select "Verify Connection".

Connection to Central service . . . . . . . . . . . . .successful
Connection to Command service . . . . . . . . . . . . .successful
Connection to Data Queue service . . . . . . . . . .successful
Connection to File service . . . . . . . . . . . . . . . .successful
Connection to Record Access service . . . . . . .successful
Connection to Signon service . . . . . . . . . . . . . .successful

If that doesn't help, try changing the job description to log(4 0 *seclvl) and observe the messages in the job log.

If that doesn't work, try compiling interactively to see if the symptoms change: Remote Systems->iSeries->Command Execution

Resolutions reported

  • EVFEVENT file was set to MAXMBRS(1). Normally, it is set to MAXMBRS(*NOMAX).
  • Apparently the root cause is running an iSeries Search without an EVFEVENT file in *CURLIB. The search creates one with MAXMBRS(1).
  • Either delete the EVFEVENT file or use CHGPF to set it to MAXMBRS(*NOMAX).

Context Sensitive help stops working

Normally in RDi9, pressing F1 on an OPCODE in RPG, or a command in CL, or a verb in COBOL will bring up the relevant section of the appropriate manual in a browser window. At times the structures needed to support this can get corrupted. To fix them, you can rename two directories in your workspace.

Here's the necessary steps (courtesy of Mike Hockings on the mailing list):

  • Shut down RDi.
  • Rename the directory C:\Users\<your-userid>\.eclipse\org.eclipse.platform_4.2.0_2139427097\configuration\com.ibm.ut.help.common\ to C:\Users\<your-userid>\.eclipse\org.eclipse.platform_4.2.0_2139427097\configuration\com.ibm.ut.help.common-original
  • Rename the directory <workspace>\.metadata\.plugins\org.eclipse.core.runtime\.settings\org.eclipse.help.base.prefs to <workspace>\.metadata\.plugins\org.eclipse.core.runtime\.settings\org.eclipse.help.base.prefs-original
  • Restart RDI 9.0.1 and again enjoy your F1 help goodness!

Categories