A fix is available
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