IBM Support

PI13403: Rational Developer for System z (RDz) Unable to recover a MVS project with an invalid character in project name

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Rational Developer for System z - RDz - v8.5.1.4
    
    No error is given when an MVS project name is changed even
    though it contains an invalid character in the name.
    
    This also occurs on the RDz v9.0.1 client.
    To recreate this problem start with an MVS project name of New
    Then, rename it to New/Update.
    
    In the .log file the following error can be seen:
    Contains: / is an invalid character in resource name
    'wdz_proj_New/update_New'.
    Contains: OK
    !SUBENTRY 1 org.eclipse.core.resources 4 77 2014-02-24
    12:18:55.172
    !MESSAGE Invalid project description.
    !SUBENTRY 2 org.eclipse.core.resources 4 77 2014-02-24
    12:18:55.172
    !MESSAGE / is an invalid character in resource name
    'wdz_proj_New/update_New'.
    !SUBENTRY 2 unknown 0 0 2014-02-24 12:18:55.172
    !MESSAGE OK
    
    
    The New.xml in wdz_proj_New_New had been updated to point to
    wdz_proj_New_update, which no longer existed.
    
    ***************************************************************
    Local fix:
    The project directory name does not actually get changed, but
    the file New.XML gets deleted.
    
    To recover your workspace
    First, close the RDz client.
    Create a file called New.XML in the wdz_proj_New directory,
    and point it to the new directory, which is the project
    directory.
    
    This xml file needs to contain the following information:
    ??xml version='1.0' encoding='UTF-8'??
    ?PROJECT-STRUCTURE?
    ?WSED-VERSION?7.5.0.0?/WSED-VERSION?
    ?PROJECT?
    ?PROJECT-NAME?New?/PROJECT-NAME?
    ?PROJECT-TYPE?zos-project?/PROJECT-TYPE?
    ?SYSTEM/?
    ?STATE?
    ?STATE-IS-OFFLINE?false?/STATE-IS-OFFLINE?
    ?/STATE?
    ?SUBPROJECT-LIST?
    ?SUBPROJECT?
    ?SUBPROJECT-NAME?New?/SUBPROJECT-NAME?
    ?SUBPROJECT-FULL-PATH?wdz_proj_New_New?/SUBPROJECT-FULL-PATH?
    ?/SUBPROJECT?
    ?/SUBPROJECT-LIST?
    ?/PROJECT?
    ?/PROJECT-STRUCTURE?
    
    Then, edit the New.xml file in wdz_proj_New_New directory, which
    is the subproject directory, to point to the correct project
    directory of the project.
    
    Ensure that the Subproject full path statement is correct:
    ?SUBPROJECT-FULL-PATH?New/New?/SUBPROJECT-FULL-PATH
    
    Ensure that the File full path statement is correct:
    ?FILE-FULL-PATH?New/New/CANDYL.COBOL/CBLDBGEX.cbl?/FILE-FULL-PAT
    H?
    
    Finally, start the RDz client.
    

Local fix

Problem summary

  • When a z/OS Project (or MVS Subproject) is renamed and the name
    contains invalid characters, no error is given and the project
    (or subproject) becomes unusable.
    

Problem conclusion

  • RDz now presents an "unexpected error" message dialog, where the
    error details show an OperationFailedException that explains
    that the new name contains an invalid character.   This is less
    friendly than validating the name while it is being entered but
    we had to work within the limitations of the Eclipse RSE rename
    dialog.
    
    The problem listed in this APAR has been resolved with
    IBM Rational Developer for System z V8.5.1.5 Fix Pack which
    is available from the Recommended Fixes support download page:
    http://www-1.ibm.com/support/docview.wss?rs=2294&uid=swg27006335
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI13403

  • Reported component name

    RATL DEV FOR SY

  • Reported component ID

    5724T0700

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-03-10

  • Closed date

    2014-06-27

  • Last modified date

    2014-06-27

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    RATL DEV FOR SY

  • Fixed component ID

    5724T0700

Applicable component levels

  • R851 PSY

       UP

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSTRMM","label":"IBM Developer for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"850","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
17 October 2021