XX00218: WEBSPHERE MQ V8 KNOWLEDGE CENTER EXAMPLE FOR DEFINING CONNECTION AUTHENTICATION CONFIGURATION CLARIFICATION

APAR status

• Closed as documentation error.

Error description

• The WMQ v8 Knowledge Center example for defining Connection
  authentication Configuration is misleading:
  .
  WebSphere MQ 8.0.0 >
    WebSphere MQ >
      Security >
     Connection authentication >
       Configuration
  .
  It shows:
    DEFINE AUTHINFO(USE.PW)
            AUTHTYPE(xxxxxx)
            FAILDLAY(10)
            CHCKLOCL(OPTIONAL)
            CHCKCLNT(REQUIRED)
  .
  This was interpreted to indicate individual DEFINE commands.
  .
  The example should use a continuation character ( + ) at the
  end of each line to indicate it is all one command since the
  entire command will not fit across the page.
  .
  Example:
    DEFINE AUTHINFO(USE.PW) +
            AUTHTYPE(xxxxxx) +
            FAILDLAY(10) +
            CHCKLOCL(OPTIONAL) +
            CHCKCLNT(REQUIRED)
  

Local fix

• Continuation characters can be added manually in an editor
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users who would like to copy/paste example runmqsc definitions
  from the IBM Knowledge Center
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The example code block at this page cannot be copy/pasted into
  runmqsc in its current format:
  
  http://www-01.ibm.com/support/knowledgecenter/SSFKSJ_8.0.0/com.i
  bm.mq.sec.doc/q113250_.htm
  
  The runmqsc utility treats a new line as the start of a new
  command, so an error is generated when trying to copy and paste
  the example command.
  
  There are also various aspects of the page and the topic of
  AUTHINFO in general that could use some attention.
  

Problem conclusion

• Users should expect to be able to copy and paste example
  commands directly from the IBM Knowledge Center. The IBM
  Knowledge Center should be changed so that the multi-line
  runmqsc commands use special continuation characters at the end
  of each line, e.g.
  
  DEFINE AUTHINFO(USE.PW) +
    AUTHTYPE(xxxxxx) +
    FAILDLAY(10) +
    CHCKLOCL(OPTIONAL) +
    CHCKCLNT(REQUIRED)
  
  To remove doubt as to what AUTHTYPE can be set to, we should
  also modify the AUTHTYPE(xxxxxx) text to be AUTHTYPE(IDPWOS) and
  make it clear that in each case, the runmqsc code blocks are
  just examples.
  
  It is not clear from the text that the authentication
  information object types IDPWOS and IDPWLDAP actually refer to
  the AUTHTYPE attribute. We should therefore change the text like
  so:
  
  On a queue manager object, the CONNAUTH attribute can be set to
  the name of an authentication information object. This object
  can be one of two types:
  
  On a queue manager object, the CONNAUTH attribute can be set to
  the name of an authentication information (AUTHINFO) object.
  This object can be one of two types (AUTHTYPE attribute):
  
  There is a considerable amount of information missing from the
  AUTHINFO command definitions. For example, FAILDLAY (which is
  referred to on this page) is not listed in either ALTER or
  DEFINE AUTHINFO. The command definitions and any related areas
  such as the PCF documentation need to be reviewed for AUTHINFO
  and corrected where necessary to match the WebSphere MQ v8.0
  functionality.
  

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

Applicable component levels