IBM Support

JR49727: NULLPOINTEREXCEPTION OCCURS WHEN REST API PERFORMANCE QUERY WITHOUT SNAPSHOT FILTER

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When executing the following REST query
    "/rest/bpm/wle/v1/performance/query" without the filter
    parameter "snapshot", it will result in a NPE .  By design a
    snapshot is required. However, the error returned does not
    clarify that. An error should be returned identifying the
    missing parameters.
    

Local fix

  • Workaround: Add the snapshot as filter to the query.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  IBM Business Process Manager (BPM)          *
    *                  Advanced                                    *
    *                  IBM BPM Standard                            *
    *                  IBM BPM Express                             *
    ****************************************************************
    * PROBLEM DESCRIPTION: When executing the following REST       *
    *                      query                                   *
    *                      "/rest/bpm/wle/v1/performance/query"    *
    *                      without the filter                      *
    *                      parameter "snapshot", it will result    *
    *                      in a NPE .                              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Utilizing REST API to query for performance data results in a
    NullPointerException if a snapshot ID is not provided. The
    following is a sample REST API request that will cause the
    NullPointerException:
    http://localhost:9085/rest/bpm/wle/v1/performance/query?filter=b
    pd%7C25.12df730b-3c1f-4658-98c9-cb99eefbc9ad
    By design this REST API requires a snapshot ID to be supplied.
    However, a better error message should be thrown in place of
    the NullPointerException.
    More information can be found regarding the API in the
    following Information Center document:
    http://pic.dhe.ibm.com/infocenter/dmndhelp/v8r5m0/index.jsp?topi
    c=%2Fcom.ibm.wbpm.ref.doc%2Frest%2Fbpmrest%2Frest_bpm_wle_v1_per
    formance_query_get.htm
    

Problem conclusion

  • The NullPointerException has been replaced with a more
    meaningful error message to allow debugging easier.  The
    following error message will be returned in the response:
     ¢â‚¬ “CWTBG0077E: The 'filter' query parameter value is incorre
    Missing 'snapshot' id. ¢â‚¬  ½
    
    A fix is available for IBM BPM v8.5.0.0.
    
    On Fix Central (http://www.ibm.com/support/fixcentral), search
    for JR49727:
    1.Select IBM Business Process Manager with your edition from
    the product selector, the installed version to the fix pack
    level, and your platform, and then click Continue.
    2.Select APAR or SPR, enter JR49727, and click Continue.
    When you download fix packages, ensure that you also download
    the readme file for each fix. Review each readme file for
    additional installation instructions and information about the
    fix.
    

Temporary fix

Comments

APAR Information

  • APAR number

    JR49727

  • Reported component name

    BPM ADVANCED

  • Reported component ID

    5725C9400

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-03-25

  • Closed date

    2014-05-19

  • Last modified date

    2014-05-19

  • 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

    BPM ADVANCED

  • Fixed component ID

    5725C9400

Applicable component levels

  • R800 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.5","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
19 May 2014