PI84656: UNABLE TO CLEAR FLOW USER EXITS WHEN RUNNING MQSICHANGEBROKER AND MQSICHANGEFLOWUSEREXITS VIA JCL ON Z/OS

APAR status

• Closed as Permanent restriction.

Error description

• When running commands on z/OS via JCL the JCL command shell
  does not treat "" as a blank argument but passes the double
  quotes through to the command which then tries to set this
  value as either the user exit list, or as the enabled/disabled
  user exits.
  E.g. for the following command run via the BIPCHBK JCL:
    mqsichangebroker  MQxxBRK -x ""
  
  on next startup of an Integration Server, this error message
  will be seen:
  
   +BIP2277W (Msg 1/1) MQxxBRK EGxx 0 AN ERROR OCCURRED WHILE
  OPENING  USER EXIT DIRECTORY '""'
  
  where it can be seen that it tries to open a directory called
  "".
  
  For mqsichangeflowuserexits run via the BIPCHUE JCL with the
  following syntax
    mqsichangeflowuserexits MQxxBRK -e EGxx -i ""
  
  the command fails and the following error is seen in the main
  broker task JOBLOG:
  
   +BIP6083E (Msg 3/3) MQ2xxBRK 114 INVALID CHARACTER IN ELEMENT
  NAME AT OFFSET '182'. THE PRECEDING TEXT IS
  'ctiveUserExitList=""' AND THE FOLLOWING TEXT IS
  '""></ExecutionGroup>'.
  

Local fix

• NA
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM Integration Bus version 10 or 10.1 on z/OS
  using message flow exits
  
  
  Platforms affected:
  z/OS
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When running commands on z/OS via JCL the JCL command shell
  does not treat "" as a blank argument but passes the double
  quotes through to the command which then tries to set this
  value as either the user exit list, or as the enabled/disabled
  user exits.
  E.g. for the following command run via the BIPCHBK JCL:
    mqsichangebroker  MQxxBRK -x ""
  
  on next startup of an Integration Server, this error message
  will be seen:
  
  +BIP2277W (Msg 1/1) MQxxBRK EGxx 0 AN ERROR OCCURRED WHILE
  OPENING  USER EXIT DIRECTORY '""'
  
  where it can be seen that it tries to open a directory called
  "".
  
  For mqsichangeflowuserexits run via the BIPCHUE JCL with the
  following syntax
    mqsichangeflowuserexits MQxxBRK -e EGxx -i ""
  
  the command fails and the following error is seen in the main
  broker task JOBLOG:
  
  +BIP6083E (Msg 3/3) MQ2xxBRK 114 INVALID CHARACTER IN ELEMENT
  NAME AT OFFSET '182'. THE PRECEDING TEXT IS
  'ctiveUserExitList=""' AND THE FOLLOWING TEXT IS
  '""></ExecutionGroup>'.
  

Problem conclusion

• This is a permanent restriction.
  

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