Troubleshooting

VS Code editor focus

If the editor window is not in focus, the watsonx Code Assistant™ for Z menu item might not show up.

Solution: Left-click in the file that you want an explanation for before you click right.

VS Code noneditor focus

When a noneditor window (like a WebView) is opened, right-clicking within the window can shift the focus to the noneditor window, which can make explanation behave in unexpected ways

Solution: Close any noneditor windows before trying to generate explanations.

VS Code open editor with selection

When the name hyperlink is clicked; sometimes after the file opens, the selection will be made and will disappear immediately.

Solution: Try to click the name hyperlink again.

LLM CloudPak support

CloudPak for Data option is not available for JCL Code Explanation.

Solution: JCL Code Explanation is only a SaaS feature and when the Z Code Assistant > Platform setting is set to Cloud Pak for Data, JCL Code Explanation is disabled. Change the setting to IBM Cloud® and update the URL settings to re-enable JCL Code Explanation.

LLM context window

There is a limit to the amount of input that the large language model (LLM) can take in at one time.

Solution: Generate multiple smaller explanations instead of one large one.