IBM Support

PI66960: AFTER UPGRADING TO MQ V8 FROM V71 THE DISPLAY CHLAUTH COMMAND WITH ADDRESS(ip) OPTION CAUSES ABEND EC6-0F01C008

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • z/OS MQ command DIS CHLAUTH(MJ.OCWMB01.OQ04.S) ADDRESS(1.1.1.1)
    QMNAME(OQ04) MATCH(RUNCHECK) results in a dump being created:
    TITLE=ssid,ABN=EC6-0F01C008,U=userid,C=W9700.800.MMC -
    CSQMRLUT,M=CSQGFRCV,PSW=477C1001889DB8F8,ASID=0115
    

Local fix

  • The customer could circumvent the problem by disabling
    queue-manager reverse DNS lookups (ALTER QMGR
    REVDNS(DISABLED)) or configure the MSTR user ID with a valid
    UID in the OMVS segment.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 8 *
    *                 Release 0 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Command DISPLAY CHLAUTH generates abend *
    *                      EC6-0F01C008 in CSQMRLUT.               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The abend EC6-0F01C008 indicates that the MSTR address space is
    running under a user ID that does not have a valid UID assigned
    in the OMVS segment in RACF. This prevents the queue manager to
    invoke USS service calls. The command DISPLAY CHLAUTH fails when
    calling services to validate IP addresses or looking up for the
    host name for an IP address.
    

Problem conclusion

  • The queue manager now checks that it can invoke USS service
    calls and if the MSTR user ID is incorrectly configured without
    a valid UID in the OMVS segment, a CSQM001E message is issued
    during queue manager restart and it disables all USS service
    calls during the process of a DISPLAY CHLAUTH command.
    
    ==== Documentation in Knowledge Center has been updated =======
    Add the following new message to knowledge center for MQ V800:
    
     - WebSphere MQ
     - WebSphere MQ 8.0.0
     - IBM MQ
     - Reference
     - Diagnostic messages
     - Messages and reason codes for z/OS
     - Messages
     - Message manager messages (CSQM...)
    
    CSQM001E: csect-name MSTR user ID cannot invoke USS
    callable services
    
    Explanation
    
    The MQ queue manager MSTR address space is running under a user
    ID that has not been configured with authority to execute
    callable Unix System Services. In RACF, the user ID requires an
    OMVS segment with an UID assigned.
    
    Severity
    
    8
    
    System action
    
    This message is issued and the execution of Unix System Services
    calls for reverse DNS hostname lookup are disabled in the MSTR
    address space.
    
    System programmer response
    
    Refer to "Planning your z/OS UNIX or UNIX System Services
    environment" where queue manager MSTR and CHIN address spaces
    require user IDs with OMVS segments defined with a valid UID.
    Please correct the configuration of the queue manager MSTR
    address space user ID and restart the queue manager.
    
    ---------------------------------------------------------------
    Replace the following section in knowledge center for MQ V800:
    
     - WebSphere MQ
     - WebSphere MQ 8.0.0
     - IBM MQ
     - Planning
     - Planning your IBM MQ environment on z/OS
     - Planning your z/OS Unix or Unix System Services
     environment
    
    
    Planning your z/OS UNIX or UNIX System Services environment
    
    Certain processes within the IBM  MQ queue manager (MSTR)
    and the channel initiator (CHIN) use z/OS  UNIX or UNIX
    System Services for their normal processing. Plan your
    configuration if you do not want to use the default UNIX
    System Services configuration.
    
    No special action or customization is necessary in order for
    IBM MQ to use UNIX services as long as a system-wide default
    OMVS segment has been set up.
    
    Users who do not want IBM MQ to invoke UNIX System Services
    using the guest/default UID and OMVS segment, need only model
    a new OMVS segment based on the default segment as IBM MQ
    requires no special permissions, and does not run within UNIX
    as a superuser.
    
    -------------------------------------------------------------
    Insert a new bullet after 3. in the "About this task" and
    "Procedure" sections in Knowledge Centers for MQ V800:
    
     - WebSphere MQ
     - WebSphere MQ 8.0.0
     - IBM MQ
     - Migrating and upgrading
     - Migrating IBM MQ for z/OS - order of tasks
     - Preparing to migrate a queue manager
    
    About this task
    
    4. Review definitions of the user IDs for the queue manager
    (MSTR) and channel initiator (CHIN) address spaces.
    
    Procedure
    
    4. Check that MSTR and CHIN address spaces run under user IDs
    that have OMVS segments defined with a valid UID to enable
    calling Unix System Services (USS).
    
    --------------------------------------------------------------
    000Y
    001Y
    002Y
    003Y
    004Y
    005Y
    CSQFMDIC
    CSQFMDIE
    CSQFMDIF
    CSQFMDIK
    CSQFMDIU
    CSQFMTXC
    CSQFMTXE
    CSQFMTXF
    CSQFMTXK
    CSQFMTXU
    CSQFXTXC
    CSQFXTXE
    CSQFXTXF
    CSQFXTXK
    CSQFXTXU
    CSQMDCA
    CSQMSTRT
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI66960

  • Reported component name

    WMQ Z/OS 8

  • Reported component ID

    5655W9700

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-08-03

  • Closed date

    2016-11-09

  • Last modified date

    2017-01-03

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

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

    PI71442 UI42400 UI42401 UI42402 UI42403 UI42404 UI42405

Modules/Macros

  • CSQFMDIC CSQFMDIE CSQFMDIF CSQFMDIK CSQFMDIU CSQFMTXC CSQFMTXE
    CSQFMTXF CSQFMTXK CSQFMTXU CSQFXTXC CSQFXTXE CSQFXTXF CSQFXTXK
    CSQFXTXU CSQMDCA  CSQMSTRT
    

Fix information

  • Fixed component name

    WMQ Z/OS 8

  • Fixed component ID

    5655W9700

Applicable component levels

  • R000 PSY UI42400

       UP16/12/08 P F612

  • R001 PSY UI42401

       UP16/12/08 P F612

  • R002 PSY UI42402

       UP16/12/08 P F612

  • R003 PSY UI42403

       UP16/12/08 P F612

  • R004 PSY UI42404

       UP16/12/08 P F612

  • R005 PSY UI42405

       UP16/12/08 P F612

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":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
03 January 2017