Skip to content

Error Messages and Troubleshooting

Unidentified Nested Exception at ZMF

Error Message

The following unidentified message displays when the ZMF web services are unable to establish a connection to ChangeMan ZMF.

    Return Code: 8
    Reason Code: 8
    Message: ;nested exception is:
Explanation

The most common cause of this error is a web application server that has not been started as a service under Windows.

Resolution

To fix this problem, start — or stop and then restart — the web application server used by ZMF for Eclipse.

From the Windows Start menu, navigate to Administrative Tools | Services. From the list of services shown, select your web application server (for example, Apache Tomcat or WebSphere Application Server), then click Start or Restart.

Logoff Fails Due to Invalid Session

Error Message

Depending on the security settings on your z/OS mainframe, you may get the following message when you select the Disconnect option to logoff from ZMF:

Logoff failed
Reason: Invalid session.

Resolution

This occurs if your ZMF for Eclipse session with z/OS has timed out. You have already been logged off. No corrective action is required.

Component Browse Function Fails

Error Message

When attempting to browse ChangeMan ZMF components, the following error occurs: Could not initialize the editor

Explanation

This error occurs when a network firewall blocks access to the XCH (Sernet Connect) and/or ZMF (CMN) ports for the target ChangeMan ZMF instance on the mainframe.

Resolution

To resolve this problem, first determine the XCH and ZMF port numbers for the ZMF instance you are trying to access. These can be found on the ZMF server information tab in the Serena perspective of ZMF for Eclipse.

Provide the XCH and ZMF port numbers to your network administrator and request that these be opened for client access over the TCP/IP network where your web application server resides.

Checkout to IDz Project Fails

Error Message

After selecting ZMF-IDz | Checkout from the Serena Explorer contextual menu and providing a valid IDz project and subproject name, you may encounter a message like the following: Project undefined or no data set

Explanation

This error occurs when no PDS libraries or zFS directories have been linked to the subproject targeted by the checkout. An IDz project or subproject is a logical collection, not a physical container for checked out files. A physical library or directory from the IDz Remote Explorer view must be linked to an IDz subproject before ZMF checkout.

Resolution

Link a physical library or directory in the IDz Remote Explorer view to an appropriate IDz subproject. Then retry the ZMF checkout.

Exception When Sharing an Eclipse Project

Error Message

If the ZDDOPTS configuration library is not installed with ChangeMan ZMF on the mainframe, or if the ECLIPSE member of that library is missing or incorrect, you will encounter the following message when you attempt to share an Eclipse project with ZMF:

  ‘Share Eclipse project with ZMF’ has encountered a problem -
  Exception running background job Share Eclipse with ZMF

Explanation

Each ChangeMan ZMF instance on the mainframe must be configured to support access from ZMF for Eclipse. To do this, your ZMF administrator must install the ZDDOPTS configuration library on each ZMF instance that will be accessed using ZMF for Eclipse. In addition, the ECLIPSE member of each library must be appropriately configured for library type mapping between the mainframe and your Eclipse project.

Resolution

Instructions for ZDDOPTS installation and setup are provided in the ChangeMan ZMF for Eclipse Installation and Setup document.

Code Page Issues with Comments in ZDDOPTS

Error Message

The first time you execute a ZMF process that uses the XML specification in a ZDDOPTS configuration library, you may encounter an error such as the following:

ChangeMan [ChangeMan ZMF instance] on server [ChangeMan ZMF server] 
has invalid XML data specified for ZDDOPTS in [library(member)].

Missing equals sign between attribute and attribute value.

Explanation

This message occurs when in an XML comment in ZDDOPTS is processed using a non-English character code page. Serena supplies sample ZDDOPTS members on the product media for ChangeMan ZMF and ZMF for Eclipse. The sample members were created for use with English-language character code pages on the mainframe. If you are using different code pages, you may need to modify the XML comments in these sample ZDDOPTS members.

All ZDDOPTS members use standard XML syntax for comments, as follows: <!-- Some comment text -->

In English-language code pages, the hexadecimal code for the exclamation point (!) is x’5A’. This hexadecimal code translates into other characters in certain code pages you may use on the mainframe. This can cause XML parsing errors. The following table shows the character translation for the English exclamation character code (x’5A’) in common mainframe code pages:

Code Page Language Character Translation
00424 Hebrew !
00875 Greek ]
01140 English-US,Portuguese !
01141 German Ü
01142 Danish,Norwegian _
01143 Finish,Swedish _
01144 Italian é
01145 Spanish ]
01146 English-UK !
01147 French §
01148 Malay ]
01149 Icelandic Æ
01153 Polish, Hungarian ]
01154 Russian ]
01155 Turkish Ð
01156 Latvian,Lithuanian !
01157 Estonian _
01158 Ukrainian ]
01164 Vietnamese ]

Resolution

To correct this problem, do either of the following:

  • COPY ZDDOPTS from the ChangeMan ZMF sample library to your production library. Then manually edit all the comments in all ZDDOPTS members to ensure that all comments begin with <!-- when rendered using your currently installed code page.

  • UPLOAD the ZDDOPTS sample delivered with ZMF for Eclipse from the client to the mainframe. The upload process will replace character code x’5A’ with the correct exclamation character code for your currently installed code page.

ZDDOPTS Updates Do Not Affect Workbench

Symptom

Changes are made to a ZDDOPTS configuration member on the mainframe, but the behavior of ZMF for Eclipse does not reflect the change.

Explanation

You must refresh the ZMF server settings on the client for the new settings to take effect in ZMF for Eclipse.

Resolution

Disconnect from and reconnect to the ZMF server. It is not necessary to restart the ZMF started task.

Back to top