Troubleshooting

Edit online

  • If a warning about missing copybooks is displayed after preparing COBOL for transformation, open the log file for more information. The log file can be found in your VS Code workspace in .wcaztmi\log\Scan.log.

    Some common issues found in the log file are:
    • S-EMSG220 Error
      S-EMSG220 Error: File could not be opened: <name of missing copybook>

      The COBOL program being prepared for transformation references a copybook that could not be found in the VS Code workspace. If the copybooks are necessary for transformation, locate them and add them to the copybooks folder in your VS Code workspace.

    • E-EMSG10010 Error
      E-EMSG10010 Error: Variable not in symbol table: <variable>

      The COBOL program being prepared for transformation references an unknown variable. This message usually occurs if the unknown variable is defined in a missing copybook, therefore this message will usually be resolved once any missing copybooks (EMSG220) are resolved.

  • If the Java™ development tools do not fully start when you open your first Java file and you see no outline view or some refactoring operations are missing from the menus, try one or more of the following actions:

    • Try closing and reopening the file.

    • Select the menu item in the Java Projects view and select Clean Workspace.

    • Restart the editor by using the menu View > Command Palette and select the command Developer: Reload Windows.

  • If you get other errors when generating Java methods, try opening the COBOL program that you are transforming and confirm that the program does not have any errors and that the Outline view is correctly populated with content.

  • If you see incorrect content in the "Review Java identifiers" view, or you want to start over after saving the mapping, delete the folder .wcaz from your VS Code workspace and start over. Note, this works only for saved mappings. After you submit the mappings and generated Java code that these files are not used anymore.

  • To analyze other issues for generating classes and methods, you can use the log view.

    • To open the log view, select the menu View > Output.

    • In the Output view, select the drop-down on the right and select "IBM Watson®® Code Assistant for Z"

    • Review the content and use any error message logged here with any interactions with technical support.

    • By default the view shows only warning and error messages. It might be necessary to increase the log level.

    • To change the log level open your VS Code user settings, search for "watsonx", and select the DEBUG level in the drop down labeled Zopeneditor > Watsonx > Watsonx Code Assistant for Z: Log Level

    • Now, the log view shows more detailed information to trace its operations.