IT44410: Queue manager fails to restart when inconsistent line endings are in an MQSC automatic configuration script

APAR status

• Closed as program error.

Error description

• The following error is reported when attempting to re-start a
  queue manager on Linux or Unix when using the Automatic
  Configuration feature from a mqsc startup script which contains
  Windows-style carriage return line feed line endings. MQSC files
  with DOS carriage returns (^M) fail to configure the QMGR as
  desired.
  
  For example:
  mqm@test $ strmqm [QMNAME]
  Successfully applied automatic configuration INI definitions.
  Failed to access automatic configuration MQSC definitions so
  using previous values
  ...
  
  ****************************************************************
  ******************
  
  The following errors are recorded in the queue manager error
  logs:
  
  07/26/2023 11:00:53 AM - Process(19967.1) User(mqm)
  Program(strmqm)
            Host(<server>) Installation(Installation1)
            VRMF(9.3.0.0) QMgr(<QMNAME>)
            Time(2023-07-26T10:00:53.660Z)
            CommentInsert1(MQSC)
  
  AMQ5776E: Auto configuration MQSC definitions contain invalid
  syntax or illegal attributes.
  EXPLANATION:
  Before using the automatic configuration files for MQSC
  definitions, they were checked
  for validity and found to contain invalid syntax or illegal
  attributes.
  ACTION:
  Verify file locations configured in the autoconfig stanza of
  the qm.ini contain files with valid
  syntax and only use valid stanzas and values.
  For example, running 'runmqsc -v' against MQSC format files
  will highlight any syntax  errors.
  Ensure that the LogType and LogFilePages attributes are not
  configured in automatic
  configuration INI files.
  ----- amqzutc0.c : 1416
  -------------------------------------------------------
  
  07/26/2023 11:00:53 AM - Process(19967.1) User(mqm)
  Program(strmqm)
  
            Host(<server>) Installation(Installation1)
  
            VRMF(9.3.0.0) QMgr(<QMNAME>)
  
            Time(2023-07-26T10:00:53.694Z)
  
            CommentInsert1(MQSC)
  
            CommentInsert2(07/26/2023 10:29:29 AM)
  
  
  
  
  AMQ5773W: Failed to access automatic configuration MQSC
  definitions so using
  
  previous values
  
  
  
  EXPLANATION:
  
  During queue manager start, it was not possible to
  automatically obtain the
  
  MQSC definitions requested in the qm.ini Autoconfig section.
  The queue manager
  
  has started but is using the MQSC definitions which were cached
  on 07/26/2023
  
  10:29:29 AM.
  
  ACTION:
  
  Verify file locations configured in the autoconfig stanza of
  the qm.ini are
  
  accessible.
  ****************************************************************
  *****************
  

Local fix

• Convert the line endings to Unix-style line feed characters, for
  example by running the dos2unix utility on all mqsc files.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  IBM MQ users who implement MQSC files to autoconfigure a queue
  manager.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  Queue manager autoconfiguration with a MQSC file failed if the
  file contains DOS carriage returns on non-Windows platforms.
  

Problem conclusion

• The IBM MQ code has been modified to handle both line feeds and
  carriage returns in MQSC files.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.3 LTS   9.3.0.15
  v9.x CD    9.3.5
  
  The latest available maintenance can be obtained from
  'IBM MQ Recommended Fixes'
  https://www.ibm.com/support/pages/recommended-fixes-ibm-mq
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'IBM MQ
  Planned Maintenance Release Dates'
  https://www.ibm.com/support/pages/ibm-mq-planned-maintenance-rel
  
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

• 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

  MQ BASE V9.3

• Fixed component ID

  5724H7291

Applicable component levels