APAR status
Closed as program error.
Error description
IIB on z/OS provides console command versions of some of its mqsi commands. If an IIB console command is issued and fails, then any subsequent run of the same command fails, even if it is submitted with correct parameters and is expected to succeed. For example, the following recreate scenario uses the mqsiwebuseradmin console command (WUA) to illustrate the defect: . Issue the mqsiwebuseradmin (WUA) console command to list the web users defined (none are currently defined so IIB correctly reports no user accounts have been defined): F MQ20BRK,WUA L=YES +BIP2836I (Msg 1/1) MQ20BRK 2 NO WEB USER ACCOUNTS HAVE BEEN DEFINED. +BIP8071I MQ20BRK 2 Successful command completion. . Issue the delete of an undefined web user account, which fails as expected: F MQ20BRK,WUA D=YES,U='UNKNOWN_USER' +BIP2833E (Msg 1/1) MQ20BRK 2 THE REFERENCED WEB USER ACCOUNT 'UNKNOWN_USER' DOES NOT EXIST. +BIP8081E MQ20BRK 2 An error occurred while processing the command. . Reissue the WUA list command, which should succeed as before, but this time it fails. This is not expected: F MQ20BRK,WUA L=YES +BIP8081E MQ20BRK 2 An error occurred while processing the command.
Local fix
LOCAL FIX:Ø Customers can use the batch (JCL) commands instead of the console version of the command to circumvent the problem.
Problem summary
**************************************************************** USERS AFFECTED: All users of IBM Integration Bus on z/OS using console commands. Platforms affected: z/OS **************************************************************** PROBLEM DESCRIPTION: If an IIB console commands fails the first time it is issued, even if the error is expected, then any subsequent issue of the same command may unexpectedly fail. For example, issuing mqsiwebuseradmin (WUA) to delete an undefined web user account fails as expected: 16:48:01.88 CLAPPER£ 00000280 F MQ20BRK,WUA D=YES,U='UNKNOWN_USER' 16:48:02.01 STC39089 00000080 +BIP2833E (Msg 1/1) MQ20BRK 2 THE REFERENCED WEB USER ACCOUNT 'UNKNOWN_USER' DOES NOT EXIST. 16:48:02.01 STC39089 00000080 +BIP8081E MQ20BRK 2 An error occurred while processing the command. The next time the WUA command is run to list the web users that are defined , it fails unexpectedly: 16:48:14.96 CLAPPER£ 00000280 F MQ20BRK,WUA L=YES 16:48:15.07 STC39089 00000080 +BIP8081E MQ20BRK 2 An error occurred while processing the command. This APAR affects the following console commands: mqsichangeresourcestats mqsideploy mqsireloadsecurity mqsireportresourcestats mqsiwebuseradmin
Problem conclusion
The product has been modified so that subsequent runs of these console commands do not fail unexpectedly. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v10.0 10.0.0.8 The latest available maintenance can be obtained from: http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041 If the maintenance level is not yet available,information on its planned availability can be found on: http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308 ---------------------------------------------------------------
Temporary fix
Comments
APAR Information
APAR number
PI72131
Reported component name
IIB Z/OS
Reported component ID
5655AB100
Reported release
A00
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-11-10
Closed date
2017-03-15
Last modified date
2017-04-25
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
IIB Z/OS
Fixed component ID
5655AB100
Applicable component levels
RA00 PSY
UP
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNQH8","label":"IBM Integration Bus for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
25 April 2017