IBM Z Software


This portal is to open public enhancement requests against IBM Z Software products. To view all of your ideas submitted to IBM, create and manage groups of Ideas, or create an idea explicitly set to be either visible by all (public) or visible only to you and IBM (private), use the IBM Unified Ideas Portal (https://ideas.ibm.com).


Shape the future of IBM!

We invite you to shape the future of IBM, including product roadmaps, by submitting ideas that matter to you the most. Here's how it works:

Search existing ideas

Start by searching and reviewing ideas and requests to enhance a product or service. Take a look at ideas others have posted, and add a comment, vote, or subscribe to updates on them if they matter to you. If you can't find what you are looking for,

Post your ideas

  1. Post an idea.

  2. Get feedback from the IBM team and other customers to refine your idea.

  3. Follow the idea through the IBM Ideas process.


Specific links you will want to bookmark for future use

Welcome to the IBM Ideas Portal (https://www.ibm.com/ideas) - Use this site to find out additional information and details about the IBM Ideas process and statuses.

IBM Unified Ideas Portal (https://ideas.ibm.com) - Use this site to view all of your ideas, create new ideas for any IBM product, or search for ideas across all of IBM.

ideasibm@us.ibm.com - Use this email to suggest enhancements to the Ideas process or request help from IBM for submitting your Ideas.

Add a new idea Subscribe
Status Delivered
Workspace z/OS Connect
Created by Guest
Created on Jan 28, 2019

RELATED IDEAS

Help identify corrupt APIs in seconds

Together with a customer we ran a zCEE v3 PoC. We ran into trouble where we could not connect to the APIs on the zCEE server anymore and not all APIs were loaded, receiving cryptic error messages in the Eclipse GUI and in zCEE messages.log. We could see in messages.log that not all APIs were installed. But we didn't have any clue which of these APIs were causing the errors. The error messages unfortunately don't specify which API has an issue.

To fix this we had to copy the API .aar files that were not loaded to another dir and copy them one by one back with intermediate zCEE server restarts to see which one was the culprit. At the end we identified the culprit API, but this is not a method you want to be performing in a production situation.

If zCEE would write an informational message in message.log at startup which API it is installing, spotting a potential corrupt API can be done in seconds. Below a log snippet on how this could look like. Msgid GEORDY01I is the message I propose. If GEORDY01I is not followed by BAQR7000I, you can assume that that API has an issue.

Log snippet:

GEORDY01I: z/OS Connect API package gpiforclients_api is being installed.
BAQR7000I: z/OS Connect API package gpiforclients_api installed successfully.
GEORDY01I: z/OS Connect API package getfindetailsapi is being installed.
BAQR7000I: z/OS Connect API package getfindetailsapi installed successfully.
GEORDY01I: z/OS Connect API package getfaulty_api is being installed.
CWWKE0701E: [com.ibm.zosconnect.internal.ApiManagerImpl(312)] The activate method has thrown an exception Bundle:com.ibm.zosconnect(id=120) java.lang.NullPointerException
at com.ibm.zosconnect.internal.ApiManagerImpl.getMappingRoot(Unknown Source)
at com.ibm.zosconnect.internal.ApiManagerImpl.processApiPackage(Unknown Source)
at com.ibm.zosconnect.internal.ApiManagerImpl.activate(Unknown Source)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:90)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:55)

Idea priority High
  • Guest
    Reply
    |     Jul 24, 2019

    This requirement is addressed by z/OS Connect Enterprise Edition V3.0.21 / APAR PH11043:
    https://www-01.ibm.com/support/docview.wss?crawler=1&uid=swg1PH11043

    BAQ7xxxE messages now contain service and API names.

    For further details about API and Service deployment messages, refer to the “z/OS Connect EE Runtime Messages” topic in the z/OS Connect EE V3.0 Knowledge Center:
    https://www.ibm.com/support/knowledgecenter/SS4SVW_3.0.0/messages/com.ibm.zosconnect.internal.resources.ZosConnectMessages.html

  • Guest
    Reply
    |     Apr 9, 2019

    We have also experienced this problem and luckily it was a very small environment without too many APIs, so we eliminated 1 X 1 until we identified the problem API.

  • Guest
    Reply
    |     Jan 30, 2019

    Apologies for the previous comment, I misunderstood that the message in your log snippet above (GEORDY01I) was your SUGGESTED improvement for an additional message, not one that is already in the product today.

    The RFE had enough information as it is written and I’ll move it onto the next stage to be evaluated by our development team.

    Thank you again for bringing this requirement to our attention.

  • Guest
    Reply
    |     Jan 30, 2019

    Thank you for this RFE.

    First of all, I think you may be experiencing a problem that can sometimes be caused when using .aars that have been created with the new version of the API toolkit (3.0.6) on servers older than 3.0.16. There is an easy work around to fix the problem described here: https://www-01.ibm.com/support/docview.wss?uid=ibm10795584

    As for the RFE itself, we have the following error messages for specific API install issues already in the product:

    BAQR7024E: z/OS Connect API package install failed. The API contains an invalid package.xml file or does not exist.
    BAQR7025E: z/OS Connect API package install failed. The file is not a valid z/OS Connect API package.
    BAQR7026E: z/OS Connect API package install failed. An IO error occurred during installation.

    For this and other more generic error scenarios, the message before the error in the log (GEORDY01I) states which API was being installed so this will be the API that caused the error since there was no BAQR7000I success message for that API

    GEORDY01I: z/OS Connect API package getfaulty_api is being installed.
    CWWKE0701E: [com.ibm.zosconnect.internal.ApiManagerImpl(312)] The activate method has thrown an exception Bundle:com.ibm.zosconnect(id=120) java.lang.NullPointerException

    Hopefully the above messages along with GEORDY01I are sufficient to meet your requirement. If so, please let me know and I will close the RFE.

    If however there is something more you need then please can you provide further detail as to what you need and why over and above what we have in the product today.

By clicking the "Post Comment" or "Submit Idea" button, you are agreeing to the IBM Ideas Portal Terms of Use.
Do not place IBM confidential, company confidential, or personal information into any field.