IBM Support

OA67980: SYSTEM_SHUTDOWN COMMANDS DO NOT EXECUTE WHEN USING SCOPE=ONLY AND INGREQ ALL

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Running INGREQ ALL with SCOPE=ONLY is the default, and the
    SYSTEM_SHUTDOWN commands do not exectute.
    If SCOPE=ALL is the default, the System_Shutdown commands
    execute as expected.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM Z System Automation.        *
    ****************************************************************
    * PROBLEM DESCRIPTION: When initiating a system shutdown       *
    *                      using INGREQ ALL REQ=STOP SCOPE=ONLY    *
    *                      the extended system shutdown commands   *
    *                      from entry SYSTEM_SHUTDOWN in the MVC   *
    *                      component are not executed. Using       *
    *                      INGREQ ALL REQ=STOP SCOPE=ALL the       *
    *                      extended system shutdown commands are   *
    *                      triggered as expected.                  *
    ****************************************************************
    When checking whether extended system shutdown commands need to
    be executed or not an automation manager query is done against
    the SYG resource to distinguish and set the shutdown type
    according to existing votes. This was only done for requests of
    type MAKEUNAVAILABLE (SCOPE=ALL), whilst requests of type
    MAKEUNAVAILABLESO (SCOPE=ONLY) were not honoured.
    

Problem conclusion

  • The routine responsible for distinguishing and setting the
    shutdown type was changed to properly check for both request
    types before deciding whether to set a shutdown type or not.
    Thus, if an INGREQ ALL REQ=STOP is issued the extended shutdown
    commands (if defined) will be triggered for the system shutdown
    regardless of the SCOPE specification.
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA67980

  • Reported component name

    SYSTEM AUTO Z/O

  • Reported component ID

    5698SA300

  • Reported release

    430

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-05-27

  • Closed date

    2025-06-13

  • Last modified date

    2025-07-02

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

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

    UJ97411

Modules/Macros

  • AOFRDWN3 INGRTERM
    

Fix information

  • Fixed component name

    SYSTEM AUTO Z/O

  • Fixed component ID

    5698SA300

Applicable component levels

  • R430 PSY UJ97411

       UP25/06/27 P F506

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSWRCJ","label":"Tivoli System Automation for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"430","Line of Business":{"code":"LOB70","label":"Z TPS"}}]

Document Information

Modified date:
02 July 2025