IBM Support

PH31267: FOR WSGRID STEP_COMPLETE_EXECUTION_FAILED SHOULD BE RC -14 BUT THROWS -16

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users of IBM WebSphere Application      *
    *                  Server                                      *
    *                  V8.5 and 9.0                                *
    ****************************************************************
    * PROBLEM DESCRIPTION: A Java batch job submitted with the     *
    *                      WSGrid                                  *
    *                      utility that ends in execution failed   *
    *                      state has an exit code of -16, but the  *
    *                      documentation indicates -14.            *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The current documentation for batch return codes indicates -14
    for
    "Job failed and is in execution failed state" and -16 for
    "Catastrophic failure - WSGrid utility".  -16 was a WSGrid
    specific
    return code that reflected both a Catastrophic failure or
    execution
    failed state.
    

Problem conclusion

  • An update was made to allow the WSGrid utility to exit with -14
    for a batch job that ends in execution failed state.  This
    behavior can be enabled with a new Job Scheduler custom property
    
    com.ibm.websphere.batch.execution.failed.wsgrid.rc
    
    Define this property with true to enable WSGrid to return the
    execution failed return code (-14) when the batch job fails
    and is in execution failed state. By default, WSGrid will
    return -16 for this status.
    
    The aforementioned documentation has been updated to reflect
    the new property, and to more clearly differentiate return
    codes associated with Java batch jobs in general and those
    unique to the WSGrid utility.
    
    The fix for this APAR is targeted for inclusion in fix pack
    8.5.5.19 and 9.0.5.7.
    
    For more information, see 'Recommended Updates for WebSphere
    Application Server':
    https://www.ibm.com/support/pages/node/715553
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH31267

  • Reported component name

    WEBSPHERE FOR Z

  • Reported component ID

    5655I3500

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-11-04

  • Closed date

    2021-01-12

  • Last modified date

    2021-01-12

  • 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

    WEBSPHERE FOR Z

  • Fixed component ID

    5655I3500

Applicable component levels

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"850"}]

Document Information

Modified date:
13 January 2021