IBM Support

IT22113: "DB2INSTANCE -LIST" MAY NOT SHOW ALERTS WHEN "DB2CLUSTER -CFS -LIST -FILESYSTEM <FSNAME> -DISK" IS ISSUED BY ROOT.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Alerts may not be generated when "db2cluster -cfs -list
    -filesystem <fsname> -disk" command
    is issued by root ID. Whereas if the "db2cluster -cfs -list
    -filesystem <fsname> -disk" command
    is issued by instance user ID, alerts will be shown properly in
    "db2instance -list".
    
    Here is an example output:
    
    $ db2cluster -cfs -list -filesystem fsname -disk (by instance
    owner)
     ...
    $ db2instance -list
    ID        TYPE     STATE  HOME_HOST   CURRENT_HOST  ALERT  ...
    --        ----     -----  ---------   ------------  -----
    0       MEMBER   STARTED      psm00          psm00     NO  ...
    1       MEMBER   STARTED      psm01          psm01     NO
    128     CF       PRIMARY      pscf0          pscf0     NO
    129     CF          PEER      pscf1          pscf1     NO  ...
    
    HOSTNAME           STATE  INSTANCE_STOPPED        ALERT
    --------           -----  ----------------        -----
       pscf1          ACTIVE                NO          YES    <<<
    shows ALERTs correctly
       pscf0          ACTIVE                NO          YES
       psm01          ACTIVE                NO          YES
       psm00          ACTIVE                NO          YES
    
    
    # db2cluster -cfs -list -filesystem fsname -disk (by root user)
     ...
    $ db2instance -list
    ID        TYPE     STATE  HOME_HOST   CURRENT_HOST  ALERT  ...
    --        ----     -----  ---------   ------------  -----
    0       MEMBER   STARTED      psm00          psm00     NO  ...
    1       MEMBER   STARTED      psm01          psm01     NO
    128     CF       PRIMARY      pscf0          pscf0     NO
    129     CF          PEER      pscf1          pscf1     NO  ...
    
    HOSTNAME           STATE  INSTANCE_STOPPED        ALERT
    --------           -----  ----------------        -----
       pscf1          ACTIVE                NO           NO    <<<
    no ALERTs
       pscf0          ACTIVE                NO           NO
       psm01          ACTIVE                NO           NO
       psm00          ACTIVE                NO           NO
    

Local fix

  • - Set environment variable DB2INSTANCE=<instancename> for the
    root user using command "export DB2INSTANCE=<instanceUserName>"
     Or,
    - Issue "db2cluster -cfs -list -filesystem fsname -disk" by the
    instance user
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * ALL                                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See Error Description                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Upgrade to Db2 11.1 Mod 4 Fixpack 4 or higher                *
    ****************************************************************
    

Problem conclusion

  • First fixed in Db2 11.1 Mod 4 Fixpack 4
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT22113

  • Reported component name

    DB2 FOR LUW

  • Reported component ID

    DB2FORLUW

  • Reported release

    B10

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-08-23

  • Closed date

    2018-11-27

  • Last modified date

    2018-11-27

  • 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

    DB2 FOR LUW

  • Fixed component ID

    DB2FORLUW

Applicable component levels

  • RB10 PSN

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEPGG","label":"Db2 for Linux, UNIX and Windows"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
07 May 2020