IBM Support

PH07230: MQLSNLWR IS A NEW ENVIRONMENT VARIABLE USED TO CONTROL AND RE-INITIALIZE THE HFS LOG FILE OF THE MQLISTENER.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • MQLSNLWR is a new environment variable used to control and
    re-initialize the HFS log file of the MQListener.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All DB2 11 & DB2 12 for z/OS users of the    *
    *                 MQListener application.                      *
    ****************************************************************
    * PROBLEM DESCRIPTION: Currently, the HFS MQListener log file  *
    *                      grows until it reaches the HFS          *
    *                      limit. For many users, that file size   *
    *                      is too big. Users need a way to specify *
    *                      the maximum size for the log file,      *
    *                      and to create a copy of and             *
    *                      reinitialize the log file when it       *
    *                      reaches the maximum size.               *
    ****************************************************************
    * RECOMMENDATION: Apply corrective PTF when available.         *
    ****************************************************************
    This APAR provides support for limiting the size of the
    HFS log file that records diagnostic information
    about MQListener.
    
    When you have specified new environment variable MQLSNLWR,
    and the MQListener log file reaches the maximum size,
    MQListener saves a copy of the log file and
    reinitializes the log file.
    
    Specify the MQLSNLWR environment variable as follows:
    
    export MQLSNLWR=file-size,file-name
    
    file-size is the maximum size of the MQListener log file,
    in megabytes.
    
    file-name is the name of the HFS file into which
    MQListener saves a copy of the MQListener log file.
    
    IMPORTANT: The ID under which MQListener runs must have
    authority to allocate and write to the file that is
    specified by file-name. Otherwise, when the log file
    reaches its maximum size, MQListener reinitializes the
    log file, but does not create a copy.
    
    Example:
    Suppose you want the maximum size of the HFS MQListener log file
    to be 2000 MB. When the log file reaches about 2000 MB, you want
    MQListener to save a copy of the log file in the file named
    '/tmp/mqlsn.log.old'. Include the following export statement
    in your .profile file.
    
    export MQLSNLWR=2000,/tmp/mqlsn.log.old
    

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    PH07230

  • Reported component name

    DB2 OS/390 & Z/

  • Reported component ID

    5740XYR00

  • Reported release

    B10

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-01-14

  • Closed date

    2019-03-08

  • Last modified date

    2019-04-02

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

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

    UI61745 UI61748

Modules/Macros

  •    DSN@MQCF DSN@MQRN DSNAMQLN
    

Fix information

  • Fixed component name

    DB2 OS/390 & Z/

  • Fixed component ID

    5740XYR00

Applicable component levels

  • RB10 PSY UI61748

       UP19/03/26 P F903

  • RC10 PSY UI61745

       UP19/03/23 P F903

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":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEPEK","label":"Db2 for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.0","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 April 2019