Difference between revisions of "WDSCi troubleshooting"
m |
(Added fix for Context-sensitive (F1) help not working in 9.0.1) |
||
(21 intermediate revisions by 5 users not shown) | |||
Line 2: | Line 2: | ||
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]]?== | ||
Line 11: | Line 13: | ||
*NOTE! You must restart your workspace immediately after clearing the 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 {{code|\Workspace\RemoteSystemsTempFiles\(connection name)\(name...)}} | ||
==Where is my [[workspace]] stored?== | ==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== | ==I'm getting a 'Workspace in use' error== | ||
Line 22: | Line 30: | ||
*If you can't delete that file, you may have some bits of Eclipse still running. | *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 | *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. | + | *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 == | ==Workspace crashes error V6 == | ||
Line 33: | Line 56: | ||
*When WDSCi restarts it should rebuild the file. | *When WDSCi restarts it should rebuild the file. | ||
− | * Recent install | + | * 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. | * Upgrade problem from 6.0.0 to 6.0.1. | ||
Line 44: | Line 67: | ||
org.eclipse.osgi | org.eclipse.osgi | ||
org.eclipse.update | 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. | *Assuming the problem is fixed, you can then just delete the folders you moved as they will have been recreated. | ||
Line 60: | Line 82: | ||
==I have a custom compile command. How do I get the error list back into WDSC?== | ==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 == | ==RSEF1002E Error == | ||
Line 74: | Line 94: | ||
==Debug SEP and UPDPROD(*NO)== | ==Debug SEP and UPDPROD(*NO)== | ||
* Error message, 'Member <membername> cannot be opened while UPDPROD(*NO)' | * Error message, 'Member <membername> cannot be opened while UPDPROD(*NO)' | ||
− | + | In WDSC prior to Rational v7.5 try: | |
*Preferences | *Preferences | ||
*Run/Debug | *Run/Debug | ||
*iSeries Debug, | *iSeries Debug, | ||
you'll see an Update Production Files checkbox. | 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== | ==Categories== | ||
+ | |||
[[Category:WDSC]] | [[Category:WDSC]] |
Latest revision as of 20:23, 11 April 2014
Tips on troubleshooting WDSCi:
First, search the archives
Contents
- 1 How do I clear the cache?
- 2 Where is my workspace stored?
- 3 Where is the error log stored?
- 4 I'm getting a 'Workspace in use' error
- 5 Compile buttons/keystrokes not working and other miscellaneous problems
- 6 Workspace crashes error V6
- 7 Workspace crashes error V7
- 8 I have a custom compile command. How do I get the error list back into WDSC?
- 9 RSEF1002E Error
- 10 Debug SEP and UPDPROD(*NO)
- 11 JVM Terminated. Exit Code = 1
- 12 Outline view file not showing fields
- 13 Compiles not working: no error, just no compile
- 14 Context Sensitive help stops working
- 15 Categories
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!