PK92548: ADMINISTRATIVE CONSOLE DOES NOT ALLOW A NULL VALUE FOR THE CCSID FIELD ON A WEBSPHERE MQ QUEUE DEFINITION

Fixes are available

APAR status

Closed as program error.

Error description

The V7 Admin Console does not allow an empty / null value of
for the CCSID field in the Advanced Properties of a Queue
Definition. A null value of CCSID should be allowed so the
customer does not have to provide an explicit CCSID and let the
default take place during runtime.

The full path is:
Resources > JMS > Queues > queuename > Advanced properties >
CCSID

** Note to migrating customers **
The V6.1 Admin Console does allows a value of null for CCSID,
while the V7 Admin Console enforces a non-null value that is
greater than 0.

This means that any queue definitions with null CCSID values
that were migrated from V6.1 to 7.0, and are attempted to be
updated via the V7.0 admin console, will encounter the
following error message:

"The field, Coded character set identifier, should be in the
range 1 through 65536."

To remove the error message the V7.0 Admin Console requires a
value to be entered for CCSID (even though it was allowed to
remain empty / null in 6.1). If MQ QMCCSID=0 then the default
value to enter for the Queue definition Advanced Properties for
CCSID is 1208.

Local fix

Problem summary

****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application      *
*                  Server V7.0 using WebSphere MQ JMS queues   *
*                  or topics.                                  *
****************************************************************
* PROBLEM DESCRIPTION: The properties panel for WebSphere MQ   *
*                      queue and topic definitions has been    *
*                      separated into two so that simple       *
*                      fields are on the first and more        *
*                      advanced fields are on the second.      *
*                                                              *
*                      On the new advanced properties panel,   *
*                      the CCSID field is populated            *
*                      with a zero if the resource has been    *
*                      migrated from an earlier release and    *
*                      has no value specified for this field.  *
*                                                              *
*                      When the user clicks ok, the panel's    *
*                      validation code throws an error         *
*                      indicating that the zero is invalid.    *
*                                                              *
*                      An attempt to set the field to blank    *
*                      results in the same error message.      *
*                                                              *
*                      The wsadmin commands showWMQQueue and   *
*                      showWMQTopic also show CCSID=0 when     *
*                      in fact the field has not been          *
*                      specified.                              *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
A new advanced properties panel for WebSphere MQ JMS queue
and topic definitions incorrectly populated the CCSID field
with a zero when it should have been blank.

An attempt to set the field to blank, which is a valid value,
resulted in an error message indicating that the value was
invalid.

Newly created WebSphere MQ JMS queues and topics will have this
field set to a default of 1208 but this was not done on
earlier releases and hence migrated resources might not have
this field specified.

The wsadmin showWMQQueue and showWMQTopic commands are new at
v7 and these were showing the value zero for CCSID when they
should have shown a value of null.

Problem conclusion

The fix for this APAR causes the CCSID field on the advanced
properties panel to be set to blank if the resource does not
have a value for this field.

The user may now also erase a value from this field causing it
to be set to blank which is a valid value.

The wsadmin showWMQQueue and showWMQTopic commands have been
fixed so that they show "CSSID=null" when no value is set for
this field.

The relevant sections of the InfoCenter have been updated to
show that blank is a valid value for the CCSID field on these
resources.

APAR PK92548 is currently targeted for inclusion in Service
Level (Fix Pack) 7.0.0.9 of WebSphere Application Server V7.0.

Please refer to URL:
//www.ibm.com/support/docview.wss?rs=404&uid=swg27006970
for Fix Pack availability.

Temporary fix

Comments

APAR Information

APAR number
PK92548
Reported component name
WEBSPHERE FOR Z
Reported component ID
5655I3500
Reported release
700
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-07-28
Closed date
2009-08-28
Last modified date
2010-04-03

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
WEBSPHERE FOR Z
Fixed component ID
5655I3500

Applicable component levels

R700 PSY UK55133
UP10/03/26 P F003

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":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
25 October 2021

Tips

PK92548: ADMINISTRATIVE CONSOLE DOES NOT ALLOW A NULL VALUE FOR THE CCSID FIELD ON A WEBSPHERE MQ QUEUE DEFINITION

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

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

Fixed component ID

Applicable component levels

R700 PSY UK55133

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.

Document Information

Share your feedback

Need support?