Readme for IBM WebSphere MQ for HP NonStop Server, Version 5.3.1, Fix Pack 3

Content

DESCRIPTION
============

This file describes product limitations and known problems.
The latest version of this file can be found here:
https://ibm.biz/mqreadmes


CONTENTS
========
- Introduction
- About this release
- Installation, migration, upgrade and configuration information
- Uninstallation information
- Known limitations, problems and workarounds
- Documentation updates
- Contacting IBM software support
- Notices and Trademarks


INTRODUCTION
============

Welcome to IBM WebSphere MQ for HP NonStop Server, Version 5.3.1, Fix Pack 3

This release notes file applies to the latest WebSphere MQ cross-platform
books (for Version 5.3), and to the WebSphere MQ for HP NonStop Server,
Version 5.3 specific books (WebSphere MQ for HP NonStop Server System
Administration Guide and WebSphere MQ for HP NonStop Server Quick
Beginnings).

The content of these release notes applies to the WebSphere MQ for HP
NonStop Server product unless otherwise stated.

This release notes file contains information that was not available in
time for our publications. In addition to this file, README.TXT,
you can find more information on the WebSphere MQ Web site:

http://www.ibm.com/software/integration/wmq/

For current information on known problems and available fixes,
SupportPacs(TM), product documentation and online versions of this and
other readme files see the Support page of the WebSphere MQ Web site at:

http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ


ABOUT THIS RELEASE
==================

Nomenclature
------------
The terms "WMQ V5.3.1" and "WMQ V5.3.1.0" both refer to the same WMQ Refresh Pack
without subsequent service installed. Throughout this readme, references
to "WMQ V5.3.1.x" refer to WMQ 5.3.1 with or without subsequent service installed.

New in this release
-------------------

This is the third FixPack for IBM WebSphere MQ V5.3.1 for HP NonStop Server,
and is designated V5.3.1.3, PTF IP22971, with associated APAR IC56784.

No new function is released with V5.3.1.3. This release contains fixes
only, and is cumulative for all service and internal defect correction
performed since WMQ 5.3.1 was released.

All object and executable files distributed with this fixpack have the
following version procedure strings:

T0085G06_30JUN2008_V53_1_3 (for G-Series systems)
T0085H06_30JUN2008_V53_1_3 (for H-Series systems)

Important note about SSL channels for when upgrading from V5.3.1
----------------------------------------------------------------
The following SSL information applies if you are upgrading from
WMQ V5.3.1 and are using SSL channels. The following procedure is
not required if you have already installed WMQ V5.3.1.1

Several of the fixes in this fixpack that relate to SSL channels, change to the
way that SSL certificates are configured with WebSphere MQ. If you use
SSL channels you will need to review the new documentation supplement
SSLupdate.pdf for information about this change and make configuration changes
to the certificate store after installing V5.3.1.3, but before running
channels. Please also see the Post-installation section below for a
summary of the required changes.

Important note about instmqm for V5.3.1
---------------------------------------

A modified WebSphere MQ product installation script, instmqm, for any level of
V5.3.1, is provided with V5.3.1.3 that includes a workaround for the OS problem
introduced in G06.29/H06.06 where the OSS 'cp' command creates Guardian files
in Format-2 form during an installation rather than Format-1. This change caused
problems binding and compiling non-native and native COBOL applications, as
well as wasting a lot of disk space because of the very large default extents
settings for the Format-2 files created by OSS cp.

Instmqm has been modified to work around this change in OSS cp by forcing
all Guardian files in an installation to be created as Format-1. The use of
the new installation script is recommended for all new V5.3.1 installations.

Existing installations that are not affected by the application relink or
rebind problems can remain as they are.

Product fix history
-------------------

The following APAR fixes are released in V5.3.1.3:

APAR IC54305 - The HP TNS (non-native) C compiler generates Warning 86 when
compiling MQI applications
APAR IC55501 - The altmqfls command does not return the correct completion
status; it always returns success
APAR IC55719 - Non-native MQINQ binding does not deal with some null pointer
parameters correctly
APAR IC55977 - Channel retry does not obey SHORTTMR interval accurately enough
APAR IC55990 - Trigger data changes not being acted upon if they were made
while the queue was open, leading to incorrect triggering
behavior
APAR IC56277 - Command Server can loop with INQUIRE QS command with a single
parameter
APAR IC56278 - A remote RUNMQSC DIS QS (*) command always times out
APAR IC56309 - MCAs do not disconnect from some shared memory when ending,
which causes a slow memory leak, and under some conditions an
abend
APAR IC56458 - Channel Server loops after installing V5.3.1.2 due to corrupt
data on SYSTEM.CHANNEL.SYNCQ
APAR IC56493 - Cannot use "qualified" hometerm device names with V5.3.1.2
APAR IC56503 - Channel Server and MCA can deadlock after repeated STOP CHANNEL
MODE(FORCE) or MODE(TERMINATE) commands
APAR IC56536 - Unthreaded responder channels don't de-register from the EC when
an error occurs during or before channel negotiation. For
example, bad initial data will cause this. Unthreaded MCAs
build up and eventually reach the maximum which prevents further
channel starts
APAR IC56681 - C++ unthreaded Tandem-Float SRLs have undefined references
APAR IC56834 - endmqm -p can sometimes leave MCA processes running

The following fixes discovered during IBM's development and testing work are
also released with V5.3.1.3:

663 - Guardian command line utility return status is not the same as the OSS
utilities return status
1402 - Add additional tracing when testing for inconsistencies in processing
a channel start in the Channel Server
1416 - Ensure that the Channel Server can support the maximum BATCHSZ of 2000
1446 - Pub / Sub command line utilities do not behave well if no broker has run
since the queue manager was created
1470 - EC abends attempting to start a non-executable REPMAN
1474 - Pub / Sub broker process handling corrections for the EC
1476 - The EC checkpoints the number of threads running in agents incorrectly
1477 - Enhancement to ecasvc utility: the creation date/time of LQMAs, MCAs,
and REPMEN are now displayed
1487 - Enhancement to ecasvc utility: changed the display of Agent attributes
to use the "real" qmproc.ini attribute names. Added a new option,
that displays information about all connected applications
1494 - A small memory leak occurs for the delete channel operation
1508 - Multiple qmproc.ini environment variables don't get propagated to
agents or repmen
1509 - The EC failed to stop an MCA that was hung when a preemptive shutdown
was initiated

The following documentation APARs are addressed by the V5.3.1.3 readme:

APAR IC55380 - Transport provider supplied during install is not propagated to
Pathway configuration by crtmqm. Please see the documentation
update below made for Page 17 of the "Quick Beginnings" book.

Also - please check the "Limitations" and "Known Problems and Workarounds"
sections later on in this readme for updates.

The following APAR fixes were released in V5.3.1.2:

APAR IC52123 - LQMA abend handling rollback of a TMF transaction in MQSET
APAR IC52963 - The PATHMON process is not using configured home terminal for
MQV5.3 on HP Nonstop Server
APAR IC53205 - FDC from Pathway runmqlsr when STOP MQS-TCPLIS00
APAR IC53891 - There is a memory leak in the Channel Server when processing
the DIS CHS command
APAR IC53996 - C++ PIC Guardian DLLs missing.
APAR IC54027 - MQRC_CONTEXT_HANDLE_ERROR RC2097 when loading messages using MO71
APAR IC54133 - Multi-threaded LQMA should not try to execute Unthreaded functions
if qmproc.ini LQMA stanza sets MaximumThreads=1
APAR IC54195 - runmqtrm data for Trigger of Guardian application not reinitialized
APAR IC54266 - MinThreadedAgents greater than PreferedThreadedAgents causes
MQRC 2009 error
APAR IC54488 - MCA's abend after MQCONN/MQDISC 64 times.
APAR IC54512 - OSS runmqsc loops if Guardian runmqsc is TACL stopped
APAR IC54517 - upgmqm does not handle CPUs attribute for PROCESS specifiction
in a SERVERCLASS
APAR IC54583 - SSL channel agent can loop if an SSL write results in a socket I/O error
APAR IC54594 - EC abends with non-MQM user running application from non-MQM directory
APAR IC54657 - Channel stuck in BINDING state following failed channel start
due to unsupported CCSID.
APAR IC54666 - Queue Server deadlock in presence of system aborted transactions.
APAR IC54798 - upgmqm fails with Pathway error on 3 or more status servers that require
migration from V5.1 queue manager.
APAR IC54841 - When a temporary dynamic queue is open during "endmqm -i" processing
an FDC is generated
APAR IC55008 - Added processing that will cause Channel Sync data to be Hardened at Batch End
APAR IC55073 - altmqfls --qsoptions NONE is not working as specified
APAR IC55176 - Abend in MQCONN from app that is not authorized to connect (2035)
or with invalid Guardian Subvolume file permissions
APAR IC55500 - QS Deadlock with Subtype 30 application using MQGMO_SET_SIGNAL
APAR IC55726 - Channel stuck in BINDING state following failed channel start
due to older FAP level
APAR IC55865 - Abend on file-system error writing to EMS collector

The following fixes discovered during IBM's development and testing work were
also released with V5.3.1.2:

1122 - Invalid/incomplete FFST generated during MQCONN when Guardian
subvolume cannot be written to.
1392 - Add support for Danish CCSID 65024
1397 - Command Server fails to start and EC reports failure to initialize
a CPU - error 12 purging shared memory files.
1409 - Guardian WMQ command fails when invoked using Guardian system() API
1413 - MCA looping after SSL socket operation fails
1419 - altmqfls --volume attempted using a open object causes FDCs
1439 - On non-retryable channel, runmqsc abends while executing RESOLVE CHANNEL command

The following documentation APARs were addressed by V5.3.1.2:

APAR IC53996 - C++ PIC Guardian DLLs missing.


originally released in V5.3.1.1 Patch 1:
APAR IC53891 - There is a memory leak in the Channel Server when processing
the DIS CHS command

originally released in V5.3.1.1 Patch 2:
APAR IC54583 - SSL channel agent loops

originally released in V5.3.1.1 Patch 3:
APAR IC54666 - Queue Server deadlock in presence of system aborted transactions.

originally released in V5.3.1.1 Patch 4:
APAR IC54512 - OSS runmqsc loops if Guardian runmqsc is TACL stopped

The following APAR fixes were released in V5.3.1.1:

APAR IC52737 - When in SSL server mode and the sender is on zOS a list of CAs
that the server will accept must be sent to the zOS sender
during the SSL handshake
APAR IC52789 - upgmqm support for upgrading V5.1 queue managers that do not use
OAM (created with MQSNOAUT defined). Also add diagnostics as to
reasons and preventative actions for failure to create a PATHMON
process
APAR IC52919 - Problems in synchronization of starting a queue manager when
multiple Queue Servers are defined
APAR IC52942 - Trigger Monitor holds Dead Letter Queue open all the time
APAR IC53240 - Correct sample API exit to build for PIC and SRL/Static
APAR IC53243 - Start of many applications simultaneously causes LQMA FDC
APAR IC53248 - Kernel not informing repository cache manager of updates to
cluster object attributes
APAR IC53250 - Flood of FDCs when trace is enabled before qmgr start
APAR IC53254 - Browse cursor mis-management left locked message on queue.
In addition, browse cursor management was not correct in the
event that a syncpoint MQGET rolls back
APAR IC53288 - Cluster Sender channel is not ending until the HBINT expired
APAR IC53383 - upgmqm was losing the MCAUSER attribute on channels
APAR IC53492 - TNS applications fail in MQPUT with more than 106920 bytes of
data
APAR IC53524 - SVRCONN channels are not ending after STOP CHANNEL if client
application is in a waited MQGET
APAR IC53552 - OAM uses getgrent() unnecessarily, causing slow queue manager
startup
APAR IC53652 - Guardian administration commands don't work with VHS or other
processes as standard input or output streams
APAR IC53728 - ECONNRESET error when Primary TCP/IP process switched should
not cause listener to end
APAR IC53835 - Assert in xtrInitialize trying to access trace shared memory

The following documentation APARs were addressed by V5.3.1.1:

APAR IC51425 - Improve documentation of crtmqm options
APAR IC52602 - Document ClientIdle option
APAR IC52886 - Document RDF setup ALLSYMLINKS
APAR IC53341 - Document OpenTMF RMOPENPERCPU / BRANCHESPERRM calculation

The following fixes discovered during IBM's development and testing
work were also released with V5.3.1.1:

634 - Correct function of altmqfls option to reset measure counter
822 - Message segmentation with attempted rollback operation failed
862 - PCF command for Start Listener fails
903 - Channel status update problems during shutdown after Repman has ended
922 - Channel status incorrect when attempting to start a channel and the
process management rules prevent the MCA thread or process from starting
929 - Incorrect response records when putting to distribution list
1012 - Two of the sample cobol programs give compilation error
1059 - C-language samples use _TANDEM_SOURCE rather than __TANDEM
1064 - errors checkpointing large syncpoint MQPUT and MQGET operations
when transactions abort
1069 - Not able to delete CLNTCONN channels
1108 - Error logged when MCA exits because maximum reuse count is reached
1152 - strmqm -c option gives unexpected error if executed after strmqm
1176 - Sample cluster workload exit not functioning correctly
1177 - QS backup abend on takeover with local TMF transactions
1180 - Segmentation of messages on transmission queues by the queue manager
was incorrect.
1182 - Replace fault tolerant process pair FDCs with log messages for better
operator information when a takeover occurs
1185 - Opens left in all three NonStop Server processes after divering CPUs
1208 - Trace info is incorrect for zslHPNSS functions. FFSTs show incorrect
component and incorrect stack trace info
1210 - FFSTs generated by criAccessStatusEntry when starting channel with
same name from another queue manager
1213 - Pathway listener generates FDCs on open of standard files
1229 - Permanent dynamic queues being marked as logically deleted on last close
1240 - Channel Server needs to update status for unexpected thread close
1244 - Speed up instmqm
1246 - implement workaround for the regression in the OSS cp command introduced
in G06.29/H06.06 where a Format 2 file is created by default when
copying to Guardian
1247 - Fixes to SSL CRL processing, added CRL reason to message amq9633
1253 - SSL samples required updating to reflect enhanced certificate file
organization - cert.pem and trust.pem
1254 - Fix an MQDISC internal housekeeping problem
1256 - MCA does not exit after re-use count if an error occurs during early
initialization
1260 - Speed up strmqm when performed on very busy systems with large number
of CPUs by minimizing calls to HP FILE_GETOPENINFO_ API
1264 - Correct the handling of the option to make Message Overflow files
audited in QS
1266 - Improve diagnostic information of FFST text for semaphore problem
1271 - After sequence of 2 CPU downs, EC, QS and CS still have openers
1272 - Improve protection in svcmqm when files in the installation are open
1273 - Memory leak in the command server caused by unreleased object lists
1277 - Don't FFST if initialization fails because the mqs.ini file doesn't
exist
1281 - LQMA thread doesn't end when CPU containing application goes down
1288 - Channels not retrying after CPU failure that also causes takeover of CS
1290 - MQDISC when connection broken doesn't tidy up transaction
1291 - Correct the syncpoint usage when amqsblst is used as a server. Enhance
amqsblst for fault tolerant behavior - makes amqsblst attempt to
reconnect and reopen objects on 2009 errors so it can be used during
fault tolerant testing
1294 - Application process management rules don't always work correctly
1297 - Correct file permission of trace directory and files - changed
permission of trace directory to 777
1301 - No queue manager start or stop events generated
1302 - instmqm function get_Guardian_version should look for string
"Software release ID"
1306 - instmqm validation fails when Java is not installed - issue a warning
if the java directory doesn't exist and continue the installation
1310 - OSS Serverclasses not restarting in Pathway if they end prematurely
1313 - EC process management can exceed maximum number of threads for LQMA
1317 - REFRESH CLUSTER command with REPOS(yes) fails
1319 - MQPUT and MQPUT1 modifying PMO.Options when creating a new MsgId
1324 - MQPUT returned MQRC_BACKED_OUT when putting message that required
segmentation to local queue
1325 - Trace state doesn't change in servers unless process is restarted
1340 - QS error handling MQPUT checkpoint. Also can lead to zombie messages on
queue requiring queue manager restart to clear
1341 - MQGET not searching correctly in LOGICAL_ORDER for mid-group messages
1346 - EC initial memory use too high. Initial allocation was approximately
18 megabytes
1351 - Upgrade logging format to V6.x style
1353 - MQGET of 210kbyte NPM from queue with checkpointing disabled caused
message data corruption at offset 106,906
1355 - xcsExecProgram sets current working directory to /tmp - changed to
installation errors directory
1357 - instmqm fails to create an OSS symbolic link after a cancelled install
1362 - MsgFlags showing segmentation status should still be returned in
MQGET even if applications specifies MQGMO_COMPLETE_MSG
1364 - endmqlsr sometimes hangs
1366 - Correct trace, FDC and mqver versioning information for V5.3.1.1


All fixes that were previously released in V5.3.0 and V5.3.1 are also included
in this release. These fixes are listed below:

originally released in V5.3.0.0 eFix1:
Beta PMR 18886 - Command Server abend
Beta PMR 18890 - RC2072 on MQPUT/MQGET

originally released in V5.3.0.0 eFix2:
Beta PMR 19284 - Message Grouping failure
Beta PMR 19292 - Error 2009 after large number of MQPuts

originally released in V5.3.0.0 eFix3:
Beta PMR 19085 - Queue Server checkpointing problem with messages on
queue and MQPUT/ MQGET returns MQRC_HOBJ_ERROR after
takeover (877)
Beta PMR 19286 - Channel status shows BINDING
APAR IC49232 - instmqm fails trying to check OSS socket availability
APAR IC49229 - Queue server repeatedly abends when stopping primary
Queue Server process while processing messages
APAR IC49243 - Channel status item LSTSEQNUM takes too long to
refresh and wrong LSTSEQNO and CURSEQNO after
restarting channel
APAR IC49233 - Repository Manager process on the same CPU as Execution
Controller is named by system when it is restarted
APAR IC49327 - Repository manager process on cpu 0 is never restarted
after abending repository manager on cpu 1 and 0.
APAR IC49255 - Execution Controller repeatedly restarts MCA and then
abends if using ChannelNameMatch in qmproc.ini after
restarting a channel
APAR IC49269 - Execution Controller, Channel Server and Queue Server
abend when cpu down occurs
- Channel Status problem with Local Repository Manager
Cluster Channel end abnormally (773)
- An FDC file is created by the repository manager (879)
- Queue Server fix MQGET for large messages (898)
- runmqlsr using same port number on different TCP/IP
processes fails (901)
- 6 character TCP/IP process name for runmqslr fails
(902)
- Start of a second and subsequent SVRCONN channel
stays in BINDING state (912)
- Execution Controller backup has a memory leak (924)
- Channel Server generating FDC on Channel Server
takeover (935)
- nspExport failures in rrxWriteSync are not correctly
being passed back to the client (939)
- Execution Controller log entry for MCA process restart
after CPU down event shows "LQMA" instead of "MCA"
(940)

originally released in V5.3.0.0 eFix4:
Beta PMR 19253 - FDC from backup Channel Server
Beta PMR 19266 - 8 character passphrase restriction for SSL
Beta PMR 19283 - Long running TMF transaction for idle NPMSPEED(FAST)
sender channels
APAR IC49306 - Sender channel recovery problem after CPU Down
APAR IC49425 - EC Abend after CPU Down
APAR IC49512 - Channel recovery and MCA process management rules
problems after CPU Down
APAR IC49570 - Channel recovery problems after two CPU Down
events
APAR IC49567 - FDC from Channel Server with PCF message
APAR IC49566 - Pathway OWNER attribute not node independent
APAR IC49653 - Backup Queue Server out of sync with Primary and Queue
Server abend on 2nd CPU down
APAR IC49694 - Message stuck in transmission queue when I/O error
occurs while getting a persistent message (CPU Down
causes primary disk process failure)
APAR IC49454 - TNS library unresolved references in certain
methods of binding
APAR IC49492 - TNS library reduce data size to closer to V5.1 level
- serviceability improvements
- add DSPMQFLS Guardian TACL macro
- EC process management rule fixes
- Queue Server support for more than 1000 objects each
process pair - change ported from V5.1 service stream
- handling of TMF error 76
- fix regression in dynamic queues for threaded agents

originally released in V5.3.0.0 eFix4 Patch1:
APAR IC49807 - TNS application abends after several calls of MQCONN,
MQOPEN, MQCLOSE, MQDISC API

originally released in V5.3.0.0 eFix4 Patch2:
APAR IC50459 - MCA and Channel Server memory leak and incorrect
handling of "out-of-memory" situation
APAR IC50072 - MCA reuse not working correctly, leading to an
accumulation of MCA processes and eventually failure to
start channels

originally released in V5.3.0.0 eFix4 Patch3:
APAR IC50790 - memory leak in MQCLOSE and memory corruption problem
APAR IC50787 - memory leak in MQDISC for FASTPATH applications,
affecting channel restart operation

originally released in V5.3.0.0 eFix4 Patch4:
APAR IC50877 - Queue Server backup and primary abended while
processing simultaneous browse MQGET, destructive MQGET
and MQPUT operations on the same queue

originally released in V5.3.0.0 eFix4 Patch5:
(no APAR) - Full function release of upgmqm migration tool

originally released in V5.3.1.0 (GA):
APAR IC49282 - add diagnostic output for socket validation failures
during install (982)
APAR IC50198 - H06.06 T1248^AAX pthreads generates FDC for invalid
sigwait option setting (1010)
APAR IC50339 - MCA abend when MQEMSEVENTS is set with H06.06 T1248^AAX
pthreads (1033)
APAR IC50544 - qm.ini AdoptMCA settings abends Channel Server (1046)
APAR IC50685 - MQMTNS can be installed incorrectly for H06.06 or G06.29
or later (1074)
APAR IC50729 - MQGET not returning 2024 under same conditions as MQPUT.
Use FDC to differentiate between TMF lock limit and Buffer
size error (1065)
APAR IC50761 - updated entropy daemon to be more efficient in generation
of random data to improve SSL channel startup time (1045)
APAR IC50808 - batchsize greater than 101 causes Channel Server to abend.
Batch size limited to 2000 now (1083)
APAR IC50821 - RESET QMGR TYPE(NSPROC) command doesn't function
APAR IC51117 - crtmqm fails when creating queue manager with a name
longer than 16 characters (603)
APAR IC51349 - channel fails with 2232 with change of message size caused
by incorrect handling of large messages in MQGET without
accept truncated message option (1125)
APAR IC51382 - threaded MCA process hang, unexpected termination and
listener hang
APAR IC51418 - SIGHUP handling with runmqsc causes high CPU usage (1118)
APAR IC43901 - change to handle recovery from an I/O error after the main
q-file message record has been read and deleted. Caused a
stuck message (983)
APAR IC47685 - buffering corrections in QS
APAR IC48365 - feedback backup context errors to Primary and backout
operation properly

635 - Beta PMR 19224. Guardian MQ TACL macros can't run processes nowait
671 - dltmqm fails with error code 20806038 if run immediately after a
crtmqm command
687 - FDC from dmpmqaut
808 - MQPUT of segmented messages and Queue Server segmentation is not
working properly to a transmission queue
830 - reject an attempt to close a permanent dynamic queue using the
MQCO_DELETE_PURGE option when the queue contains uncommitted
messages
851 - MQINQ/MQSET not failing with MQRC_OBJECT_CHANGED if a change is
made to the object that invalidates the handle
853 - runmqlsr's -g and -u options are not listed in the usage display
858 - GroupID in MQMD not being returned to application on MQPUT to a
transmission queue
867 - when a channel rule specifies a process name, and an MCA is
inactive and running with that process name, the EC wasn't
selecting it as available for allocation. Same problem with
Application Rules was also fixed
876 - attempts to create a channel using MQ Explorer abends Command
Server
884 - build and ship the C++ samples
913 - signal handling not enabled by default in threaded environments.
Set the HP environment variable to enable it on the later versions
of pthreads libraries that provide support (SPR T1248H06^AAX or
later on H-Series and SPR T1248G07^AAY on G-Series)
916 - improved error handling for TMF errors
921 - MQPUT/MQOPEN memory leak
925 - message grouping does not work properly
926 - instmqm fails on production systems where c89 may not be installed
929 - MQDISC assertion caused by memory management defect
930 - endmqm -i does not end queue manager with sample application
running
931 - EC tells threaded agents to die prematurely when pooling disabled
935 - rrxGetNextStatusEntry generating FDC on Channel Server takeover
testing
936 - process executable file names truncated in trace files
940 - EC log entry for MCA process restart after cpu down has LQMA for
the process type - it should be MCA
944 - multiple instances of endmqlsr can hang and fail to end listeners
946 - if the master REPMAN is abended, it fails to restart
947 - error processing invalid (negative) context handle in PMO for
MQPUT
950 - channel/application rules containing ProcessName are not handled
properly if the processname is in use when the EC receives a
failure starting the agent
954 - problem using channel rules for process name and process name root
955 - the STATUS field can show extra characters when refreshed on
Monitoring panels for channel status
956 - process name rule not always being obeyed by EC
958 - protect unthreaded MCA from being given another channel to run if
it has one active already
959 - the Channel Server could lock up waiting for reply from MCA
967 - support for ssl passphrases longer than 8 characters
969 - EC should checkpoint the qmproc.ini data rather than letting the
backup process re-read the qmproc.ini file when a new backup is
created
970 - EC log messages 8813 and 8814 contain extraneous word
971 - under some circumstances the EC doesn't keep accurate record of
process names in use for a process name template
973 - if the Hometerm is not available and instmqm aborts, it leaves the
hometerm program in <GuardianSample>, which has to be removed
manually before a new instmqm can be performed
978 - if a process management rule in qmproc.ini contains a
ProcessNameRoot attribute, the process name template is not always
used in creating an agent or selecting an idle agent from the pool
who's process name matches the template name
979 - fix EC problem handling 3 cpu failure tests
985 - when an unthreaded Listener is used the EC will sometimes abend
when a new MCA is started to bring the unthreaded idle pool up to
it's minimum value
989 - defect in pathway COOL start code only shows up in optimized code
990 - strmqm can fail with "pathmon process name error" when PATHMON is
using a dynamic process name
991 - fix Queue Server memory leak when Touch file does not exist
994 - display application type "NSK" instead of "13" in RUNMQSC
DISPLAY PROCESS command
1000 - timing problem in strmqm between qmgrsvr and OAM server resulted
in FDCs during queue manager start
1001 - insufficient error handling in name mangling algorithm for
choosing real file names for objects
1007 - pool limit reached message not logged correctly by MCA. Added
message AMQ9720 to report this
1011 - sample program (amqsblst.c) throws unresolved Text Symbol "usleep"
error during runtime
1015 - correction to handling of long queue manager names
1016 - error in MQCONNX processing MQ_CONNECT_TYPE environment variable
1018 - added message AMQ8570 to report an error reading the qmproc.ini
file
1020 - improve Queue Server handling of "disc down" file system error 60
1021 - improve API exit usability - exclude API exits from channel server
1027 - sample program amqsaxe0.c fails to compile
1035 - an incorrect or unrecognized entry in the Channels stanza of
qm.ini causes the Channel Server to abend repeatedly and queue
manager to fail to start
1043 - problems with memory management in local queue manager agent
(LQMA)
1044 - corrections for installations that do not choose to install SSL
1052 - MQGMO_LOCK and MQGMO_UNLOCK options not working correctly in MQGET
1068 - all processes should open stdfiles at startup so standard file
descriptors are not used for other opens
1081 - channels do not get triggered when COA reports put to a
transmission queue
1084 - channel server uses incorrect checkpoint logic that may cause
memory overwrites in some circumstances
1095 - unnecessary FDC in kqiDeleteQPath causing MCA to terminate
1099 - add the OSS pin to AMQ8823 EC detected an unexpected process
termination message
1105 - the Queue Server abends when reloading NPM messages for queue with
NPMCLASS(HIGH)
1107 - improvements to the threaded agent pool processing logic
1109 - improve recovery of a no-syncpoint multi-ipc MQGET when the queue
server backup fails
1112 - EC doesn't update thread statistics when an MCA terminates
unexpectedly
1113 - extraneous object free following qtype error in remote queue
resolution caused FDC
1114 - EC's threaded allocation algorithm can produce unexpected results
1115 - Channel Server abend in rare Stop Channel case
1118 - enable generic signal handling correctly in certain components
1119 - added support for new environment variable override of thread
stacksize
1124 - environment (Env) in AllProcesses stanza of qmproc.ini is not
being propagated to all processes
1126 - svcmqm should not issue messages if there are no deliverable files
in the lib or gbin directories
1127 - svcmqm should not reset PROGID if it updates the 3 server
executables in the Guardian executables subvolume
1130 - dspmqcsv and endmqcsv can hang on G-Series systems and display
incorrect results on H-Series (Integrity) systems
1131 - MCA will end prematurely on fcntl O_NONBLOCK socket error
1133 - add process termination info to log message from EC reporting
unexpected process failure
1137 - corrections to the AdoptMCA mechanism
1139 - MQPUT returns 2019 instead of 2009 when queue manager is quiescing
or ending
1141 - Unnecessary FDCs can be generated when using endmqm -i and -p
1142 - removed incorrect free of memory which was causing FDCs
1153 - in the event of invalid connection handle, an additional check is
required to prevent use of the invalid handle
1154 - in the event of invalid object handle, the handle requires further
validation before being used
1155 - altering TriggerMsgPriority attribute of queue does not cause
trigger message to be generated if trigger conditions are met
after the change
1157 - strmqm fails when an application program is running after an
endmqm -p
1158 - agents were not terminating correctly when their use count is
exceeded
1159 - a misalignment in checkpointing large MQPUT and MQGET messages in
the Queue Server caused backouts under some circumstances
- revised Guardian administration interface to improve support for
TACL RUN options. The originally released TACL "wrapper" scripts
have been replaced with executable programs that run the OSS
control programs in such a way that they can better support
various RUN options and more closely simulate a Guardian program
- support threaded SSL channels, and improve SSL channel startup
time
- all Guardian programs except command line have SAVEABEND attribute
set to ON to improve the ability to collect important failure data
- corrections to processing of shared connection handles at MQI for
threaded applications
- increased the compiler optimization level for the Integrity
NonStop Server version from 0 to 1 for improved performance
- various updates to improve service diagnostics (trace, FDCs,
logging, process attributes)
- revised the SSL samples to make certificate handling for
intercommunication with other platforms easier

originally released in V5.3.1.0 eFix1:
APAR IC51829 - MQCONN in Non-native COBOL or TAL application fails with
MQRC 2059

originally released in V5.3.1.0 eFix2:
APAR IC51627 - EC would loop trying to start processes in CPU #15.
APAR IC51680 - The Temporary Dynamic Queues created by the M073 support
pack were not deleted after exiting
APAR IC51743 - CMQCOBOL MQENC-NATIVE definition
APAR IC51802 - Open of Queue Server fails with error 48 using
large mqsc scripts
APAR IC51865 - MQINQ does not get updated information while object
is still open.
APAR IC51962 - Abnormal ending of Channel occasionally causes
benign FFST
APAR IC52039 - EC exits with catastrophic failure when reply error
74 is received.
APAR IC52041 - NMCOBOL requires a symbols MQMLIB to compile correctly.
APAR IC52231 - Static bound applications linked with V5.3.0.0 libraries
corrupt shared memory files in V5.3.1.0 when calling
MQCONN
545 - Temporary Dynamic Queues queues not deleted on startup
1098 - instmqm hometerm test program compile error
1120 - U/T receiver channels taking too long to stop.
1187 - Internal EC function should only return 6 character
EC process name.
1192 - Pub/Sub Samples need minor modifications to run on
NonStop systems.
1194 - include explicit mqver -V in instmqm
1201 - instmqm socket validation error message
1209 - multi-threaded apps FFST's are being overwritten
1216 - revise instmqm to report errors deleting L files
1223 - memory overwrite in Channel Server in very rare
circumstances.
1221 - Put with Cobol and Get with C sample errors
1225 - Cobol samples do not end cleanly
1220 - Fixed COBOL Bindings and New Scripts for Guardian samples

originally released in V5.3.1.0 eFix3:
APAR IC52347 - MQDISC called when application has a current TMF
transaction returns MQRC_UNEXPECTED_ERROR
APAR IC52274 - Memory leak for trusted bound applications and MCAs on
MQDISC
APAR IC52406 - Application that creates a Guardian binary semaphore
BINSEM may abort on MQCONN.
APAR IC52428 - Unhelpful error message when rngd is not running
APAR IC52428 - runmqsc dis chs sslpeer field contains invalid value
APAR IC52428 - GSKit Messages following channel errors
APAR IC52428 - Unhelpful error message when certificate is bad
1165 - Non-native applications abend when trace is enabled
1195 - SSL Channel attribute SSLCAUTH(OPTIONAL) not supported
1235 - VPROC info in MQMTNS missing after link with application
- eFix2 incorrectly included lib/libmqm.so and
lib/libmqm_r.so
- eFix2 incorrectly shipped a version of instmqm with
windows line-endings

- Note workaround described below for customers wishing to
compile native COBOL applications on RVUs G06.29 and
later, or H06.06 and later (1246)
- Note description of known Windows SSL interoperability
problem with Websphere MQ 5.3 for HP NonStop Server
discussed below. (APAR IC51754)

originally released in V5.3.1.0 eFix4:
APAR IC52443 - The "dmpmqaut" command does not work correctly in
WMQ5.3.1.0
APAR IC52475 - Change to thread scheduling causes leaks in LQMA
APAR IC52505 - Error Logged when MCA exits because reuse is maxed
- MCA does not exit after re-use count on occasion
APAR IC52522 - EC server loops on 16 CPU machine
APAR IC52679 - LEC fails to initialize pluggable services after CPU
reload
1028 - Trace is incorrect for zslHPNSS functions
1148 - endmqm causes rriChannelTerminate FFST
1179 - Temporary dynamic queue not deleted during endmqm/strmqm
1248 - altmqfls command hangs
1250 - EC logs incorrect messages indicating process name
already in use and CPU unavailable for unnamed
applications
1252 - Sometimes MQRC 2009 is returned from 2nd application
connecting to queue manager when use count of shared LQMA
is reached
1255 - Leak of AMQCAT file opens in unthreaded LQMA
1259 - Need diagnostic(s) when application start agent request is
rejected because the LEC fails
1263 - Temporary dynamic queues left logically deleted but not
physically deleted.

originally released in V5.3.1.0 eFix4 Patch 1:
APAR IC52756 - Command Server memory leak when processing the
"reset queue statistics" command

originally released in V5.3.1.0 eFix4 Patch 2:
APAR IC53130 - WMQ rejects a certificate whose X509 'purpose' does not
match the usage.

originally released in V5.3.1.0 eFix4 Patch 3:
APAR IC52816 - runmqlsr exits when TCPIP primary switched
APAR IC52914 - EC repeatedly tries to start Repository Manager process
APAR IC52916 - EC process management rules with cpu down

originally released in V5.3.1.0 eFix4 Patch 4:
APAR IC53371 - Potential security exposure in MQ client channels


Backward compatibility
----------------------

IBM WebSphere MQ V5.3.1 for HP NonStop Server is interoperable over channels
with IBM MQSeries(TM) V5.1 for Compaq NSK, as well as any other current or
earlier version of IBM MQSeries or IBM WebSphere MQ on any other platform.

Product compatibility
---------------------

IBM WebSphere MQ V5.3.1 for HP NonStop Server is not compatible
with IBM WebSphere MQ Integrator Broker for HP NonStop Server.
For other compatibility considerations, review the list of suitable
products in the WebSphere MQ for HP NonStop Server Quick Beginnings book.

IBM WebSphere MQ V5.3.1 for HP NonStop Server is compatible with any
currently supported level of IBM WebSphere MQ Client. IBM WebSphere MQ V5.3.1
for HP NonStop Server does not support connections from WebSphere MQ
Extended Transactional Client.


INSTALLATION, MIGRATION, UPGRADE AND CONFIGURATION INFORMATION
==============================================================

Hardware and Software Requirements
----------------------------------

We have made the following updates to the list of recommended SPR levels
in this V5.3.1.3 release, for the following reasons:
- T8994 (OSS Local Sockets) for HP Solution 10-080529-3529 which reports
that one party using a local socket connection can hang if the other
party abends
- T8306 (OSS sockets) to clarify the RVU/SPR fix availability - in earlier
versions of this readme, we quoted an SPR level that was not available
and since then the SPRs relevant to different RVUs have changed
- T8620 (OSS file system) to clarify the RVU/SPR fix availability - there
is currently no fix available for the G06.27 and G06.28 RVUs
- T9053 (DP2) to clarify the RVU/SPR fix availability - G-Series SPR ATG
was recalled and replaced by ATT and later SPRs
- T9050 (NonStop Kernel) to clarify the RVU/SPR fix availability - H-Series

The list of mandatory HP operating system and SPR levels has not changed since
the V5.3.1.1 release. Please read the following information carefully, and
if you have any questions, please contact IBM.

For the HP NonStop Server G-Series systems, the following system software versions
are the minimum mandatory level for V5.3.1.3 (unchanged):

- G06.25 or later
- SPR T8306G10^ABG or later
- SPR T8994G09^AAL or later
- SPR T8397G00^ABC or later
- SPR T1248G07^AAY or later

The following levels are RECOMMENDED by IBM for the HP NonStop Server
G-Series systems to avoid some significant problems encountered
during recent tests and customer deployments:

- SPR T8994G09^AAN (OSS Local Sockets)
- SPR T8397 "latest available" (OSS Socket Transport Agent)
- SPR T8306G10^ABL (OSS sockets) for G06.25/26/27
T8306G11^ABM for G06.28
T8306G12 base for G06.29 and later
- SPR T8620G10^ACJ (OSS file system) for G06.25/26
T8620G13^ACL for G06.29 and later
- SPR T9053G11^ATT (DP2)
- SPR T9050G09^AQF (NonStop Kernel)
- SPR T8607G08^AGS (TMF main)

For the HP Integrity NonStop Server H-Series systems, the following system software
versions are the minimum mandatory level for V5.3.1.3 (unchanged):

- H06.05.01 or later
- SPR T8306H01^ABJ or later
- SPR T8994H01^AAM or later
- SPR T8397H01^ABD or later
- SPR T1248H06^AAX or later

The following levels are RECOMMENDED by IBM for the HP Integrity NonStop
Server H-Series systems to avoid some significant problems encountered
during recent tests and customer deployments:

- Base release H06.06
- SPR T1248H06^ABF (pthreads)
- SPR T8994H01^AAP (OSS Local Sockets)
- SPR T8397 "latest available" (OSS Socket Transport Agent)
- SPR T8306H02 base (OSS sockets) for H06.06/07/08
T8306H04 base for H06.09/10/11/12
T8306H04^ABS for H06.13 and later
- SPR T8620H03^ACM (OSS file system) for H06.06/07
T8620H04^ACN for H06.08 and later
- SPR T9053H02^ATJ (DP2)
- SPR T9050H02^AQW (NonStop Kernel) for H06.06
T9050H02^ARF for H06.07 and H06.01.01
T9050H02^ASJ for H06.08
T9050H02^ASK for H06.09
T9050H02^ARS for H06.10
T9050H02^ARV for H06.11
T9050H02^ASC for H06.12
T9050H02^ASD for H06.13
T9050H02^ASE for H06.14
- SPR T8607H01^AGV (TMF main)
- SPR T1265AAX (TCP/IP)

If you use SNA channels with V5.3.1, we recommend the latest levels of the
HP SNAX or ACI Communication Services for Advanced Networking (ICE) be used
for the SNA transport. The following versions were verified by IBM with this
release of WMQ:

ACI Communication Services for Advanced Networking (ICE)
- v4r1 on both HP Integrity NonStop Server and S-Series systems

HP SNAX
- T9096H01 on HP Integrity NonStop Server (H-Series) systems
- T9096ADK on HP NonStop Server (G-Series) systems

If you use the WebSphere MQ V5.3 classes for Java and JMS for HP NonStop Server
you will need to install HP NonStop Server for Java Version 1.4.2 or later.


Upgrading to V5.3.1.3
---------------------

You may upgrade any prior service level of WebSphere MQ V5.3.1.x
for HP NonStop Server to V5.3.1.3 level using this release.
The installation tool, svcmqm, is used to upgrade existing installations
to this level. Additionally, the placed files for any prior level of V5.3.1
can be overlaid with the new files from V5.3.1.3 and then instmqm can be used
to create new installations at the updated V5.3.1.3 level.

You must end all queue managers and applications in an installation if you
want to upgrade that installation to V5.3.1.3.

You do not need to re-create any queue managers to upgrade to V5.3.1.3.
Existing queue managers (at any V5.3.1.x service level) will work with
V5.3.1.3 once an installation has been properly upgraded.

If you use SSL channels, and are upgrading from WMQ V5.3.1, you must perform
a small reconfiguration of the Certificate store before running any SSL channels
after you have upgraded. The steps that are required are described below in
the Post-Installation section. If you do not perform this reconfiguration,
SSL channels in the upgraded V5.3.1.3 installation will fail with the log
messages similar to the following:

For sender channels:

09/29/07 08:52:43 Process(0,483 $Z8206) User(MQM.ABAKASH) Program(amqrmppa)
AMQ9621: Error on call to SSL function ignored on channel
'ALICE_BOB_SDRC_0000'.

EXPLANATION:
An error indicating a software problem was returned from a function which is
used to provide SSL support. The error code returned was '0xB084002'. The error
was reported by openssl module: SSL_CTX_load_verify_locations, with reason:
system lib. The channel is 'ALICE_BOB_SDRC_0000'; in some cases its name cannot
be determined and so is shown as '????'. This error occurred during channel
shutdown and may not be sufficiently serious as to interrupt future channel
operation; Check the condition of the channel.
ACTION:
If it is determined that Channel operation has been impacted, collect the items
listed in the 'Problem determination' section of the System Administration
manual and contact your IBM support center.
----- amqccisx.c : 1411 -------------------------------------------------------
09/29/07 08:52:44 Process(0,483 $Z8206) User(MQM.ABAKASH) Program(amqrmppa)
AMQ9001: Channel 'ALICE_BOB_SDRC_0000' ended normally.

EXPLANATION:
Channel 'ALICE_BOB_SDRC_0000' ended normally.
ACTION:
None.

For client or receiver channels:

-------------------------------------------------------------------------------
09/29/07 08:05:28 Process(1,802 3 $X0545) User(MQM.HEMA) Program(amqrmppa_r)
AMQ9620: Internal error on call to SSL function on channel '????'.

EXPLANATION:
An error indicating a software problem was returned from an function which is
used to provide SSL support. The error code returned was '0x0'. The error was
reported by openssl module: SSL_load_client_CA_file, with reason: CAlist not
found. The channel is '????'; in some cases its name cannot be determined and
so is shown as '????'. The channel did not start.
ACTION:
Collect the items listed in the 'Problem determination' section of the System
Administration manual and contact your IBM support center.
----- amqccisx.c : 1347 -------------------------------------------------------
09/29/07 08:05:28 Process(1,802 3 $X0545) User(MQM.HEMA) Program(amqrmppa_r)
AMQ9228: The TCP/IP responder program could not be started.

EXPLANATION:
An attempt was made to start an instance of the responder program, but the
program was rejected.
ACTION:
The failure could be because either the subsystem has not been started (in this
case you should start the subsystem), or there are too many programs waiting
(in this case you should try to start the responder program later). The reason
code was 0.

You do not need to re-compile any applications to upgrade to V5.3.1.3.

If upgrading from V5.3.1:

If your non-native or native applications use a static linkage method for binding with
the MQI, you must use the HP BIND or NLD utility to re-bind/link these applications
for use with V5.3.1.3.

If the application is not re-bound/linked to the V5.3.1.3 MQI, MQCONN
API calls will fail with a MQRC 2059 and the WMQ EC process will output
a FDC when the MQI incompatibility is detected, as follows:

Probe Id :- EC075003
Component :- ecaIsECup
Comment1 :- Application MQ API not compatible, relink application
Comment2 :- <process cpu,pid process name>
Comment3 :- <application executable name>

If upgrading from V5.3.1.1 or V5.3.1.2:

If your non-native or native applications use a static linkage method for binding
with the MQI, IBM recommend that you use the HP BIND or NLD utility to re-bind/link
these applications for use with V5.3.1.3. If you choose to not re-link or re-bind
your applications, then you will not benefit from fixes for the following problems
(listed above as fixed in this fixpack):

APAR IC55719 - Non-native MQINQ binding does not deal with some null
pointer parameters correctly

APAR IC54305 - The HP TNS (non-native) C compiler generates Warning 86 when
compiling MQI applications

If your applications link to the MQI using the Shared Resource Library (SRL)
method, you may need to ensure that the User Library references in the
application programs are updated to refer to new libraries from V5.3.1.3 using
the HP nld utility. This step is only required if you have created a new
V5.3.1.3 installation and want to use the same copies of application programs
with it as were running previously with V5.3.1. If you upgrade an existing
V5.3.1 installation, the updated libraries will be in the same location and
so this step is not required.


Installation from Electronic Software Download
----------------------------------------------

These instructions apply to installing WebSphere MQ for HP NonStop Server,
Version 5.3.1.3 from the package downloaded from IBM.

Use svcmqm to update an existing installation from the V5.3.1.3 placed files.

1. Unzip the fixpack distribution package - wmq53.1.3.tar.zip.
The fixpack distribution package contains the following files:

readme_wmq_5.3.1.3 This README
wmq53.1.3_G06.tar.Z G-Series G06 Package
wmq53.1.3_H06.tar.Z H-Series H06 Package

2. Identify the correct fixpack package to install:

For G-Series systems (G06) use: wmq53.1.3_G06.tar.Z
For H-Series systems (H06) use: wmq53.1.3_H06.tar.Z

3. Upload the compressed fixpack archive to the OSS file system in binary mode.
You may wish to store the compressed archive, and the expanded contents
in a location where you archive software distributions from IBM.
If you do this, you should store the compressed archive in a directory
that identifies the version of the software it contains,
for example, "V5313".

mkdir -p /usr/ibm/wmq/V5313
upload (in binary mode) the correct compressed tarfile to this directory

4. Extract the fixpack compressed tarfile using commands similar to:

cd /usr/ibm/wmq/V5313
uncompress wmq53.1.3_H06.tar.Z
tar xvof wmq53.1.3_H06.tar

5. Locate your WMQ V5.3.1.x installation(s). The service installation procedure
requires the full OSS path names of the opt/mqm and var/mqm directories for
each WMQ installation to which the fixpack will be installed.

6. Logon to OSS using the WMQ installation owner's userid

7. End all Queue Managers defined in the WMQ Installation.
endmqm <qmgr name>

Ensure all Queue Managers defined in the WMQ installation
are ended.
dspmq

Ensure that the WMQ installation is at any suitable V5.3.1 level.
mqver -V

8. End any non-Pathway listeners for Queue Managers defined in the
WQM installation:
endmqlsr -m <qmgr name>

9. Verify that no files in the Guardian subvolumes of the installation to
be updated are open. The installation cannot proceed safely unless all
files in these subvolumes are closed. Use the TACL command 'FUP LISTOPENS'
for the files in all three subvolumes - an absence of output indicates
that no files are open. If files are shown to be open, use the output
from the command to identify processes that are holding files open.

10. Backup your WMQ Installation; the fixpack cannot be uninstalled.
instmqm -b can be used to back up an installation. Please refer
to the readme file included with release WMQ V5.3.1.

11. Install the fixpack by running the supplied service tool (svcmqm).
Svcmqm requires the location of the OSS var tree as well
as the OSS opt tree. These locations can be supplied automatically by
running svcmqm in an OSS shell where the environment variables for the
WMQ installation being updated have been established (typically by
sourcing "wmqprofile"). If this is the case, svcmqm does not require the
-i and -v parameters. If the environment variables for the WMQ
installation are not established in the environment of svcmqm, the
locations of the OSS opt and var trees must be supplied explicitly using
the svcmqm command line parameters -i and -v.

For example:

cd /usr/ibm/wmq/V5313
opt/mqm/bin/svcmqm -s /usr/ibm/wmq/V5313/opt/mqm
-i /wmq1/opt/mqm
-v /wmq1/var/mqm

svcmqm will prompt to confirm the location of the OSS opt tree for the
installation to be updated.
Type "yes" to proceed.

Svcmqm will then update the installation. The current WMQCSTM file for
the installation will be renamed to BWMQCSTM as a backup copy, before it
is regenerated. Note that any changes to the WMQCSTM file you have made
will not be copied to the new WMQCSTM file, however they will be preserved
in the backup copy made before the WMQCSTM file was regenerated.

12. Repeat Steps 5-11 for any other WMQ installations that you want to update
with this fixpack.

13. You can install this fixpack in the WMQ placed installation files so that
any future WMQ product installations will include the fixpack updates.

To do this, locate your WMQ placed installation filetree containing the
opt directory, make this your current working directory (use 'cd') and
then unpack the contents of the tar archive for this fixpack over the placed
file tree. For example, if the placed files are located in the default
location /usr/ibm/wmq/V5313, for a H-Series system:

cd /usr/ibm/wmq/V5313
tar xvof /usr/ibm/wmq/V5313/wmq53.1.3_H06.tar

Substitute G06 in the above command suggestions if you are installing
on an G-Series system.

Post-Installation
-----------------
If upgrading from WMQ V5.3.1, read the following post-installation instructions:

Non-Native TNS Applications:

Re-BIND/NLD any non-native (TNS) or native static applications.
See "Upgrading to V5.3.1.3" above for more information.

Re-binding non-native (TNS) or native static applications is REQUIRED if
upgrading from WMQ V5.3.1 but is RECOMMENDED if upgrading from WMQ V5.3.1.1
or V5.3.1.2.

For G-Series, ensure that applications that use one of the WMQ SRL User
Libraries (i.e. WMQSRL, WMQRSRL, WMQFSRL or WMQFRSRL) have the
correct User Library specified for the upgraded installation.

If you use SSL channels and have not already installed V5.3.1.1:

Edit the SSL certificate store, cert.pem and move all the CA certificates
to a new file, trust.pem, stored in the same directory as cert.pem. The
only items that should remain in cert.pem are the queue manager's personal
certificate, and the queue manager's private key. These two items should
be located at the start of the cert.pem file. All other certificates
(intermediate and root CAs) must be moved to trust.pem. The trust.pem file
must be in the same directory as cert.pem, as configured in the queue
manager's SSLKEYR attribute.

Update the copy of the entropy daemon program that you run for SSL channels
on the system with the new version (...opt/mqm/ssl/amqjkdm0).

Enable new support for Danish CCSID 65024:

Customers who wish to enable the new support for Danish CCSID 65024
should do the following to install the revised ccsid.tbl file:

Issue the following commands on OSS:

1. Logon to OSS using the WMQ installation owner's userid
2. End all Queue Managers defined in the WMQ Installation.
endmqm <qmgr name>
3. Source in the installation's wmqprofile
. $MQNSKVARPATH/wmqprofile
4. cp -p $MQNSKOPTPATH/samp/ccsid.tbl $MQNSKVARPATH/conv/table/
5. Start queue managers

Guardian C++ DLLs:

Ensure that the WMQ Guardian C++ DLLs are 'executable' by using
"FUP ALTER" to set their FILECODE to either 700 (for G-Series)
or 800 (for H-Series). Use commands similar to the following:

1. Logon to TACL using the WMQ installation owner's userid
2. OBEY your WMQ Installation's WMQCSTM file
3. VOLUME [#param MQNSKOPTPATH^LIB^G]
4. FUP ALTER IMQI2,CODE 800
5. FUP ALTER IMQI2T,CODE 800
6. FUP ALTER IMQI3,CODE 800
7. FUP ALTER IMQI3T,CODE 800
8. Logoff

For G-Series systems, use CODE 700.

Guardian Subvolume File Permissions

The WMQ Guardian Installation Subvolume and all WMQ Guardian Queue
Manager Subvolumes must accessible to both MQM group members
and to users that run WMQ application programs.

Ensure that:

All members of the MQM security group have read, write, execute
and purge permission to these subvolumes.

All users that run WMQ application programs, have read, write
and execute permission to these subvolumes

Restart Queue Managers:

Restart the queue managers for the installation you have
updated with this fixpack.


UNINSTALLATION INFORMATION
==========================

This fixpack cannot be automatically uninstalled if a problem occurs
during the update of an installation using svcmqm.

You should use the instmqm -b option to create a backup of an
installation before applying the service. If a problem occurs
or you need to reverse the upgrade at a later date, use the
instmqm -x option to restore a backup of the installation at the
prior service level.


KNOWN LIMITATIONS, PROBLEMS AND WORKAROUNDS
===========================================

This section details known limitation, problems, and workarounds for
WebSphere MQ for HP NonStop Server, Version 5.3.1.3.

Limitations
-----------

1. The current implementation of Publish / Subscribe is restricted to run
within a single CPU. The control program and all "worker" programs run in
the CPU that was used to run the 'strmqbrk' command.
The Publish/Subscribe broker does not automatically recover in the event
of CPU failures.

2. The current memory management implementation in the Queue Server limits
the total amount of non-persistent message data that can be stored on all
the queues hosted by a single Queue Server to less than 1Gb. The limit of
non-persistent message data on a single queue can not exceed approximately
1Gb therefore, even if a single Queue Server is dedicated to that queue.

3. The number of threads in threaded agent processes (LQMAs or MCAs) or in MQI
applications, is limited to a maximum of 1000 by the limit on open depth of
the HP TMF T-file.

4. API exits are not supported for non-native (TNS) applications. Any other
exit code for non-native applications must be statically bound with the
application.

5. Cluster workload exits are only supported in "trusted" mode. This means
that a separate copy of each exit will run in each CPU and exit code in
one CPU cannot communicate with exit code in another CPU using the normal
methods provided for these exits.

6. Upgmqm will not migrate the following data from a V5.1 queue manager:

- messages stored in Message Overflow files (typically persistent messages
over 200,000 bytes in size) will not be migrated. If the option to
migrate message data was selected, the upgrade will fail. if the option
to migrate message data was not selected, the upgrade will not be
affected by the presence of message overflow files.
- clustering configuration data - all cluster related attributes of objects
will be reset to default values in the new V5.3 queue manager.
- SNA channel configuration - channels will be migrated, but several of the
attributes values will need to be changed manually after the upgrade.
- channel exit data - attributes in channels that relate to channel exit
configuration will be reset to default values in the new V5.3 queue
manager.

In all cases where upgmqm cannot migrate data completely, a warning message
is generated on the terminal output as well as in the log file. These can
be reviewed carefully after the upgrade completes for further actions that
may be necessary.

7. Java and JMS limitations

The Java and JMS Classes do not support client connections. WebSphere MQ
for HP NonStop Server does not support XA transaction management, so the
JMS XA classes are not available. For more detail, please refer to the
Java and JMS documentation supplement, Java.pdf.

8. Control commands in Guardian (TACL) environment don't obey the RUN option
"NAME" as expected

A Guardian control command starts an OSS process to run the actual
control command - and waits for it to complete. When the NAME option is
used, the Guardian control command process uses the requested name, but
the OSS process cannot and is instead named by NonStop OS.

If the Guardian control command is prematurely stopped by the operator
(using the TACL STOP command for example) the OSS process running the
actual control command may continue to run. The OSS process may need to be
stopped separately and in addition to the Guardian process.

9. Trace doesn't end automatically after a queue manager restart
(APAR IC53352) and trace changes do not take effect immediately

If trace is active and a queue manager is restarted, the trace settings
should be reset to not trace any more. Instead, the queue manager
continues tracing using the same options as before it was restarted.
The workaround is to disable trace using endmqtrc before ending, or while
the queue manager is ended.

Also, changes to trace settings do not always take effect immediately
after the command is issued. For example, it could be several MQI calls
later that the change takes effect. The maximum delay between making a
trace settings change and the change taking effect would be until the end
of the queue manager connection, or the ending of a channel.

10. Some EMS events generated to default collector despite an alternate
collector being configured (APAR IC53005)

An EMS event message "FFST record created" is generated using the OSS
syslog() facility whenever an FDC is raised by a queue manager. This
EMS event cannot be disabled, and goes to the default collector $0. For
OSS processes, an alternate collector process can be specified by
including an environment variable in the context of these processes
as in the following example:

export EMS_COLLECTOR=\$ALT

Guardian processes always use the default collector because HP do not
provide the ability to modify the collector in the Guardian environment.
HP is investigating if a change is possible.

11. The use of SMF (virtual) disks with WMQ is not supported because of
restrictions imposed by the OSS file system. For more details, please
refer to the HP NonStop Storage Management Foundation User's Guide
Page 2-12.

12. The maximum channel batch size that can be configured (BATCHSZ attribute)
is 2000. If you need to run channels with batch sizes greater than 680
you must increase the maximum message length attribute of the
SYSTEM.CHANNEL.SYNCQ to 60000.

e.g. from RUNMQSC - ALTER QL (SYSTEM.CHANNEL.SYNCQ) MAXMSGL (60000)

13. The SYSTEM.CHANNEL.SYNCQ is a critical system queue for operation of
the queue manager and should not be altered to disable MQGET or MQPUT
operations, or to reduce the maximum message size or maximum depth
attributes from their defaults.

14. Currently, the cluster transmission queue (SYSTEM.CLUSTER.TRANSMIT.QUEUE)
cannot be moved to an alternative Queue Server because it is constantly
open by several internal components. The following procedure (which
requires a "quiet" queue manager, and a queue manager restart) can be
used to achieve this reconfiguration. Do not use this procedure on a
queue manager that is running in production. Read and understand the
procedure carefully first since it includes actions that cause
internal errors to be generated in the queue manager.

1. Find the Guardian name of the OSS repository executable file amqrrmfa
gname <MQInstall>/opt/mqm/bin/amqrrmfa
/amqrrmfa -->\ZAPHOD.$DATA03.ZYQ0000G.Z0000LCH
2. Rename the OSS repository executable (opt/mqm/bin directory)
mv amqrrmfa amqrrmfax
3. On Guardian stop the repository processes using the gname output
STATUS *, PROG <Guardian file name> , STOP
e.g., STATUS *, PROG \ZAPHOD.$DATA03.ZYQ0000G.Z0000LCH , STOP
At this point the EC will start continuously generating FDCs and
log messages as it attempts to, and fails, to restart the repository
servers that were stopped. Perform the remaining steps in this
procedure without delay to avoid problems with excessive logging
such as disk full conditions.
4. Verify processes are stopped, note the STOP option is not used
STATUS *, PROG <Guardian file name>
e.g., STATUS *, PROG \ZAPHOD.$DATA03.ZYQ0000G.Z0000LCH
5. Issue the altmqfls --server command to move the cluster transmission
queue to an alternate queue server
6. Issue dspmqfls to verify the alternate server assignment
7. Rename the OSS repository executable back to the expected name
mv amqrrmfax amqrrmfa
8. End the queue manager using preemptive shutdown. The EC will generate
FDCs ending because of the earlier attempts to start a repository
manager while the executable was renamed. There will be FDCs and
EC Primary process failover

Component :- xcsExecProgram
Probe Description :- AMQ6025: Program not found
Comment1 :- No such file or directory
Comment2 :- /opt/mqm/bin/amqrrmfa
...
AMQ8846: MQ NonStop Server takeover initiated
AMQ8813: EC has started takeover processing
AMQ8814: EC has completed takeover processing
...
The EC may have to be manually TACL stop if quiesce or immediate
end is used thus the need for the preemptive shutdown
endmqm -p <qmgr name>
9. Restart the queue manager
strmqm <qmgr name>

15. In Guardian/TACL environments, support for some WMQ command-line programs
has been deprecated for WMQ Fixpack 5.3.1.3 and later.

The affected command-line programs are:

amqoamd
amqrdbgm
amqrfdm
crtmqcvx
endmqlsr
runmqchi
runmqchl
runmqdlq
runmqlsr
runmqtrm

These programs will continue to function for now, however their use in
Guardian/TACL environments is discouraged. Support for these programs
in Guardian/TACL environments may be withdrawn completely in a future
WMQ 5.3 release/fixpack.

IBM recommends that customers use the OSS version of these programs instead.

Customers who want to route output from WMQ OSS tools to VHS or other Guardian
collectors should use the OSSTTY utility. OSSTTY is a standard utility
provided by OSS and is described in the HP publication "Open System Services
Management and Operations Guide".

Note: See Item 3. in "Known problems and workarounds" for a description of
restrictions when using the MQ Broker administration commands in the
Guardian/TACL environment.

16. Do not use WebSphere MQ with a $CMON process that alters attributes of WMQ
processes (for example the processor, priority, process name or program file
name) when they are started. This is not a supported environment since there
are components in WMQ that rely on these attributes being set as specified
by WMQ for their correct operation.


Known problems and workarounds
------------------------------

1. FDCs from Component xcsDisplayMessage reporting xecF_E_UNEXPECTED_SYSTEM_RC

On RVUs G06.29 and later, or H06.06 and later:

These FDCs occur frequently on queue manager shutdown, and at times during
queue manager start, from processes that write to the queue manager log
files at these times, typically the cluster repository cache manager
(amqrrmfa) and the EC (MQECSVR). No functional problem is caused by these
FDCs, except that the queue manager log file misses some log messages
during queue manager shutdown. The FDCs report an unexpected return code
from the HP lseek() function. An example of an FDC demonstrating this
problem follows:

Probe Id :- XC022011
Component :- xcsDisplayMessage
Program Name :- $DATA06.RP1PBIN.MQECSVR
Major Errorcode :- xecF_E_UNEXPECTED_SYSTEM_RC

MQM Function Stack
nspPrimary
eclShutdownOK
xcsDisplayMessageForSubpool
xcsDisplayMessage
xcsFFST

6fffe660 000011FA ....
6fffe670 2F686F6D 652F726F 622F4D51 /home/test/MQ
6fffe680 352E332F 5250312F 50726F64 2F776D71 5.3/RP1/Prod/wmq
6fffe690 2F766172 2F6D716D 2F716D67 72732F51 /var/mqm/qmgrs/Q
6fffe6a0 4D312F65 72726F72 732F414D 51455252 M1/errors/AMQERR
6fffe6b0 30312E4C 4F47 01.LOG

This problem is fixed by the following HP SPR's

T8620ACL (OSSFS) for G06 HP OS
T8620ACM (OSSFS) for H06 HP OS

2. APAR IC54594 - EC abends with non-MQM user running application from non-MQM directory.

Statically-bound TNS or native applications, that are not relinked after installing
Fixpack 5.3.1.3 have additional considerations. For these applications,
qmproc.ini Application Rules 2 and 4 will not work if the application is located
in a non-MQM directory.

3. The Guardian control commands for the Publish / Subscribe broker
(strmqbrk, endmqbrk, dspmqbrk ... etc) will not work correctly unless they
are run in the same CPU as the broker is running in, or was last running in.

Please use the equivalent OSS commands instead of the Guardian versions, or
ensure that the Guardian Publish / Subscribe broker commands run in the same
CPU as the broker was or is running in.

4. The RESOLVE CHANNEL command creates FDCs and displays unclear error
messages under some circumstances

FDCs are generated for RESOLVE CHANNEL (name) ACTION(BACKOUT) command,
even though the command performs the required actions for the channel.

Probe Id :- CS003011
Component :- crPrimaryRequest
Program Name :- $DATA03.MQBIN.MQCHSVR
Major Errorcode :- rrcE_STATUS_TABLE_CORRUPT
Comment1 :- Status Table corruption

Probe Id :- NS027001
Component :- nsrSendIPC
Program Name :- /home/mq/opt/mqm/bin/runmqsc
Major Errorcode :- xecF_E_UNEXPECTED_RC
Comment1 :- Error sending IPC to Server

Probe Id :- CS071003
Component :- craSetStatusEntry
Program Name :- /home/mq/opt/mqm/bin/runmqsc
Major Errorcode :- xecF_E_FAIL
Comment1 :- Failed in send of Set Channel Status to Channel Server

If the transmission queue for the channel being resolved is GET(DISABLED)
(usually because the channel has been STOPPED) and a RESOLVE CHANNEL
(name) ACTION(COMMIT) command is performed, the error message is not clear:

AMQ8101: WebSphere MQ error (7E0) has occurred.

Instead, the error message should say something similar to:

AMQ8101: WebSphere MQ queue disabled for MQGET.

After enabling the transmission queue for MQGET (using the ALTER QL
command), the RESOLVE CHANNEL can be reissued successfully.



DOCUMENTATION UPDATES
=====================

Please note that several supplements to the documentation have been provided
with fixpacks since V5.3 was originally released. These supplements have
been released in Adobe Acrobat format and can found in the
opt/mqm/READMES/en_US directory of any installation as well as the original
software distribution tree (placed files). The following supplements have
been released to date (the name of the file describes the content):
- Exits.pdf
- Java.pdf
- Pubsub.pdf
- SNAChannels.pdf
- SSLUpdate.pdf
- Upgmqmreadme.pdf

Also please note that the current published versions of the cross-platform
("family") books contain references to the IBM MQSeries V5.1 for Compaq NSK
product which is the previous major version of WebSphere MQ for HP NonStop
Server. Consequently, these references may not be accurate with respect to
the functional support provided by V5.3.1.

WebSphere MQ for HP NonStop Server Quick Beginnings (GC34-6626-00)
------------------------------------------------------------------

Chapter 1 - Planning to install WebSphere MQ for HP NonStop Server

- Page 1: the baseline release level for V5.3.1 on the HP Integrity NonStop
Server is now H06.05.01

- Page 1: the typical approximate storage requirements are as follows:
+ OSS files placed before installation:
H-Series: 160Mb
G-Series: 120Mb
+ For each installation:
H-Series: Guardian 220Mb, OSS 350Mb, Total 570Mb
G-Series: Guardian 122Mb, OSS 276Mb, Total 400Mb
+ For each queue manager:
G/H-Series: Guardian 9.5Mb, OSS 0.2Mb, Total 10Mb

- Pages 2 & 3: please review the section "Hardware and Software
Requirements" in these release notes for the details of all other updated
requirements

Chapter 3 - Installing WebSphere MQ for HP NonStop Server

- Page 12: Product Selection dialog. The names of the products have been
updated to "WebSphere MQ V5.3.1" and "WebSphere MQ V5.3.1 Integrity".

- Page 14: instmqm now includes the function of creating an automatic
backup archive of a successful installation, as follows:

Instmqm has been enhanced to provide the ability to back-out an ungrade
installation, and the ability to archive and restore installations
individually. Before instmqm starts to make changes to a system, it will
automatically create an archive of the current installation (OSS opt tree
and Guardian installation subvolumes only) in the root directory
containing the opt tree in OSS. If a failure occurs during installation,
and instmqm has made changes, the user will be asked if they wish to
restore the installation to its original state using the archive created
before changes were made. At the end of a successful installation,
instmqm will now automatically create a backup archive of the new
installation.

Instmqm also supports two new command line options to support creating
and using backup archives independently from an installation:

-b create a backup archive of the installation
-x restore an installation from a backup archive

These options may not be combined with any other options. Both options
require the user to respond to questions at the terminal.

A backup archive file is an OSS pax file, created as follows:

+ the Guardian PAK utility is used to create a backup of the three
Guardian subvolumes for the installation in a file named "WMQSAVED"
+ the PAK backup file is copied to the OSS opt directory of the
installation that is being archived
+ the entire OSS opt tree of the installation (which now includes
WMQSAVED) is then archived by the OSS pax utility

Backup archive files are always created in the directory that holds the
OSS opt tree for the installation. Archive files created automatically
by instmqm are named "mqarchive-yymmdd-hhmmss" where "yymmdd" and
"hhmmss" are numeric strings of the date and time that the backup archive
was created - for example: "mqarchive-061005-143606".

- Page 15: instmqm has new command line options as described in these
release notes for creating and restoring backup archives

- Page 17: the SnaProviderName and TcpProviderName fields of the
QmgrDefaults stanza in the instmqm response file are used to populate
the proc.ini file to provide installation wide defaults for channels.
Please note that these fields do not get used for the default listener
configuration either on the command line (runmqlsr) or in the queue
manager's Pathway environment. Users must manually configure the
transport names for all listeners.

- Page 28: in addition to the manual methods for cleaning up after a failed
installation, instmqm will offer the option to restore the previous
installation from a backup archive in the event of a failure while
upgrading a V5.3 installation to V5.3.1 level. These release notes
describe the additional function.

- If an installation was initially created without SSL (selection of the
installation type "CORE" for instmqm), the following procedure can be
used to update the installation to include SSL components. In the
instructions below, <MQInstall> refers to the location of the
installation that needs to be updated and <PlacedInstall> means the
location of the complete set of placed files for the level of WMQ that
corresponds to the installation being updated. All queue managers
must be ended before attempting this procedure.

1. mkdir <MQInstall>/opt/mqm/ssl
2. chmod 775 <MQInstall>/opt/mqm/ssl
3. cp <PlacedInstall>/opt/mqm/ssl/* <MQInstall>/opt/mqm/ssl
4. chmod 775 <MQInstall>/opt/mqm/ssl/amq*"...
5. cp <MQInstall>/opt/mqm/ssl/openssl <MQInstall>/opt/mqm/bin
6. chmod 664 <MQInstall>/opt/mqm/ssl/openssl
7. chmod 774 <MQInstall>/opt/mqm/bin/openssl
8. cp <MQInstall>/opt/mqm/ssl/amqjkdm0 <MQInstall>/opt/mqm/bin
9. chmod 775 <MQInstall>/opt/mqm/bin/amqjkdm0
10. mv <MQInstall>/opt/mqm/lib/amqcctca
<MQInstall>/opt/mqm/lib/amqcctca_nossl
11. mv <MQInstall>/opt/mqm/lib/amqcctca_r
<MQInstall>/opt/mqm/lib/amqcctca_r_nossl
12. cp <MQInstall>/opt/mqm/ssl/amqccssl <MQInstall>/opt/mqm/lib/amqcctca
13. cp <MQInstall>/opt/mqm/ssl/amqccssl_r
<MQInstall>/opt/mqm/lib/amqcctca_r
14. chmod 775 <MQInstall>/opt/mqm/lib/amqcctca*
15. The <MQInstall>/var/mqm/qmgrs/<qmgr name> directory should have an
ssl directory which is where you will store the certificate related
files (cert.pem, trust.pem etc.)
16. The <MQInstall>/opt/mqm/samp/ssl should exist already with the ssl
samples
17. If the entropy daemon is not configured on the system this will need
to be performed. Refer to the WMQ V53 HP NonStop System
Administration Chapter 11 page 165-167
18. Install the certificates per the updated instructions, SSLupdate.pdf
found in <MQInstall>/opt/mqm/READMES/en_US

Chapter 5 - Creating a Version 5.3 queue manager from an existing Version 5.1
queue manager

- Pages 37 & 38: this section is completely replaced by the documentation
supplement Upgmqmreadme.pdf supplied with this release.

Chapter 7 - Applying maintenance to WebSphere MQ for HP NonStop Server

- Pages 44 & 45: the tool for applying maintenance is named "svcmqm" and
not "installCSDxx".

- Page 44: in step 3 of "Transferring and preparing the PTF for
installation", the top level directory of the PTF is opt, and is not
named differently for each PTF. Therefore it is important to manually
create a directory specific to each PTF, download the PTF to that new
directory and then expand the archive within the new directory.

- Page 44: in step 2 of "Running the installation script for a PTF", the
svcmqm tool has a different command line from that documented for
"installCSDxx". svcmqm takes three parameters:
svcmqm [-i installationtree] [-v vartree] -s servicepackage

where "installationtree" is the full path to the location of the opt/mqm
directory of the installation to be updated
"vartree" is the full path to the location of the var/mqm
directory of the installation to be updated
"servicepackage" is the full path to the location of the opt/mqm
directory of the maintenance to be installed
For example:
svcmqm -i /home/me/wmq/opt/mqm -v /home/me/wmq/var/mqm
-s /home/me/wmqfiles/opt/mqm

which will update the installation in /home/me/wmq/opt/mqm and
/home/me/wmq/var/mqm from the maintenance package in directory tree
/home/me/wmqfiles/opt/mqm.

If either or both the "-i installationtree" and "-v vartree" parameters
are omitted, svcmqm will use the current setting of the appropriate
environment variable - either WMQNSKOPTPATH or WMQNSKVARPATH.


WebSphere MQ for HP NonStop Server System Administration Guide (SC34-6625-00)
-----------------------------------------------------------------------------

Chapter 2 - An introduction to WebSphere MQ administration

- Page 16: before running any control commands on OSS or NonStop OS it is
necessary to establish the environment variables for the session. When
an installation is created a file called wmqprofile is also created in
the var/mqm directory that will establish the environment for an OSS
shell. Likewise, a file is also created in the NonStop OS subvolume
containing the WMQ NonStop OS samples called WMQCSTM that can be used
to set up the appropriate environment variables for a NonStop OS TACL
session.

To establish the WMQ environment for an OSS shell session:

. wmqprofile

To establish the WMQ environment for a NonStop OS TACL session:

obey WMQCSTM

The same steps are required before running any applications in the
OSS or NonStop OS environment.

Chapter 4 - Administering local WebSphere MQ objects

- Page 48: when creating a Process definition, the default value for
the APPLTYPE attribute is "NSK" (indicating a Guardian program)

Chapter 7 - WebSphere MQ for HP NonStop Server architecture

- Page 80: the MQSC command to reload the process management rules is
REFRESH QMGR TYPE(NSPROC) and not RESET QMGR TYPE(NSPROC)

Chapter 8 - Managing scalability, performance, availability and data
integrity

- Page 104: the last paragraph of the OpenTMF section should be reworded
as follows:

No special administrative actions are required for this use of TMF.
WebSphere MQ uses and manages it automatically. You must ensure that
the RMOPENPERCPU and BRANCHESPERRM configuration parameters of TMF are
set to appropriate values for your configuration. Please see Chapter 12
- Transactional Support - Configuring TMF for WebSphere MQ for
information on how to calculate the correct values. The HP TMF Planning
and Configuration Guide describes the subject of resource managers and
heterogeneous transaction processing.

Chapter 9 - Configuring WebSphere MQ

- Page 119: the CPUS section should state that the default can be
overridden using the crtmqm -nu parameter. See Chapter 18 - The control
commands for a description of how to use this parameter with crtmqm.

- Page 120: the section describing the ARGLIST attribute of a TCP/IP
Listener should also mention the use of the optional -u parameter to
configure channels started by the listener as unthreaded processes.
The default is to run incoming channels as threads in an MCA process.

- Page 130: the MQSC command to reload the process management rules is
REFRESH QMGR TYPE(NSPROC) and not RESET QMGR TYPE(NSPROC)

- Page 133: Figure 23 remove :
# OAM Manager stanza #
OamManager:

- Page 136: the Exit properties section should state that the only
supported way of configuring and running a Cluster Workload (CLWL) Exit
for HP NonStop Server is in FAST mode. The CLWLMode setting in qm.ini
is required to be set to FAST, which is the default for WebSphere MQ
on this platform.

- Page 139: the MQIBindType attribute of the Channels stanza is set by
crtmqm to FASTPATH. This should not be changed, except under the
direction of IBM Service.

- Page 140: the AdoptNewMCA=FASTPATH option is always required for
this platform in order for the adoption of MCAs to be effective. The
"Attention!" box after the description of the FASTPATH option should
be ignored.

- Page 140: add the following description of the ClientIdle attribute:

ClientIdle=seconds

ClientIdle specifies the number of seconds of inactivity to permit
between client application MQI calls before WebSphere MQ terminates
the client connection. The default is to not terminate client
connections however long they remain inactive. When a client connection
is terminated because of idle activity, the client application receives
a connection broken result (2009) on its next MQI call.

Chapter 11 - Working with the WebSphere MQ Secure Sockets Layer (SSL) support

A documentation supplement has been written to replace the sections on
Page 170 (Preparing the queue manager's SSL files) to Page 176 (Building
and verifying the sample configuration) because of changes to the files
that WebSphere MQ uses to hold certificates. The documentation supplement
is called SSLupdate.pdf, and can be found in the opt/mqm/READMES/en_US
directory of an installation.

Chapter 12 - Transactional Support

- Page 185: The descriptions of the TMF attribute RMOPENPERCPU in the
Resource manager configuration section is modified as follows:

RMOPENPERCPU

Each WebSphere MQ thread or process that handles transactions has
an open of a Volatile Resource Manager in the CPU it runs in. In
addition, each application thread or process using the MQI also has
an open. The minimum requirement for this configuration parameter
is therefore the sum of:
+ all Queue Server processes in that CPU
+ all LQMA and MCA threads running in that CPU
+ all MQI application threads running in that CPU
+ 10 (to account for miscellaneous queue manager processes that
could be running in that CPU)
You should calculate the peak values of these numbers across all CPUs
and add a safety margin to arrive at the correct value for your system.
The HP default value of 128 for this parameter is often suitable for
small configurations, but unsuitable for medium or large ones.

- Page 186: add the following paragraph to the Troubleshooting section
for Configuring TMF:

If the RMOPENPERCPU value is not configured to allow sufficient opens
of resource managers in a CPU, WebSphere MQ connections will fail with
an unexpected return code, and FDCs will be generated reporting an
error with the TMF_VOL_RM_OPEN_. The workaround is to distribute
applications and queue manager processes in the CPU that exceeds
the limit to other CPUs. The correct remedy is to schedule an outage
and modify the TMF configuration.

Chapter 14 - Process Management

- Page 197: the MQSC command to reload the process management rules is
REFRESH QMGR TYPE(NSPROC) and not RESET QMGR TYPE(NSPROC)

- Page 200 and 204: the default value for the maximum number of unthreaded
agents is now 200. The default value for the maximum number of threaded
agents is now 20. the default value for the maximum use count for
threaded agents is now 100.

- Page 204: the "valid attribute values" for the attribute "ExecutableName"
should be stated as "File name part only of the program to run for the
LQMA or MCA process".

- Pages 203 - 205, Table 20: Process Management: Keyword definition Summary

There are a number of errors in the Process Management Keyword
definition table:

1. Environment variables:
ENVxx should be Envxx

2. Executable Name to Match:
ExecNameMatch should be ExeNameMatch

3. Fail if CPU unavailable:
FailOnCPUunavail should be FailOnCPUUnavail

4. Preferred number of Threaded Agents:
PreferedThreadedAgents should be PreferredThreadedAgents

Default values:

5. MaxThreadedAgents: change from 10 to 20

6. MaxUnthreadedAgents: change from 20 to 200

7. MaxThreadedAgentUse: change from 10 to 100

Pages 199 - 201, Table 16. Process management: agent attributes

The same default value changes are required:

1. Maximum number of unthreaded agents: 200
2. Maximum number of threaded agents: 20
3. Maximum reuse count for threaded agents: 100


Chapter 15 - Recovery and restart

- Page 216: Configuring WebSphere MQ, NonStop RDF, and AutoSYNC to support
disaster recovery
To configure RDF to work with a existing WMQ V53 queue manager:
- End the WMQ V53 queue manager.
- Using the HP BACKUP or PAK utility specifying the AUDITED option
Backup the primary site Guardian WMQ queue manager subvolume.
- Using the HP RESTORE or UNPAK utility specifying the AUDITED option
Restore the files on the backup site.
- Ensure that on the backup system that the alternate key file
attribute (ALTKEY) for files amqcat and amqpdb of each queue
manager are set to the correct (backup system) node name

- Page 217: the example of the altmqfls command to set the RDF
compatibility mode for large persistent messages is correct but too
simplistic. Please use care when using altmqfls to set the queue options
(--qsoptions parameter) and refer to the reference section for the
control commands for a complete description of using this option.

- Page 217: the bullet point that describes the configuration of AutoSYNC
filesets is incorrect when it states that NO ALLSYMLINKS should be
specified. Replace sub-bullet item number 2 with the following text:

2. The entire queue manager OSS directory structure
var_installation_path/var/mqm/qmgrs/qmname.

You must specify the absolute path name of the queue managerÂ’s
directory. Specify the ALLSYMLINKS option for this fileset to
ensure that AutoSYNC correctly synchronizes the symbolic link
(G directory) in the queue manager's directory to the NonStop OS queue
manager's subvolume on the backup system.

Chapter 16 - Troubleshooting

- Page 230: after the section "Is your application or system running
slowly?", insert the following new section:

Are your applications or WebSphere MQ processes unable to connect?

If connection failures are occurring:
- is the User ID under which the application runs authorized to
use this queue manager?
- are SAFEGUARD permissions preventing read access to the WebSphere
MQ installation files by the User ID running the application?
- are the environment variables established for the application
process, so that the correct installation of WebSphere MQ is being
used?
- if necessary, has the application been relinked or rebound with
any static MQI libraries that it uses?
- is a resource problem preventing the queue manager from allowing
the connection? Review the troubleshooting section under TMF
Configuration on Page 185 and 186 for information about the
RMOPENSPERCPU TMF attribute.

Chapter 18 - The control commands

- Page 243: the control commands for the Publish / Subscribe broker are
not referenced here. Refer to the WebSphere MQ V6.0 Publish/Subscribe
User Guide and the documentation supplement for Publish/Subscribe on
HP NonStop Server - Pubsub.pdf.

- Page 255: if the OSS environment variable or Guardian PARAM MQPATHSEC
is defined and set to one of the standard NonStop OS security attributes
(A, N, C, G, O, or U) when crtmqm is run, the default PATHWAY SECURITY
attribute value of "N" will be overridden by the value of the environment
variable / PARAM. This can be used to restrict access to the queue
manager's Pathway environment. The current Pathway attributes can be
displayed in PATHCOM using the INFO PATHWAY command.

- Page 255: the -nu parameter for setting the default CPUS attribute
in Pathway serverclasses does not accept all the values that Pathway
allows for this attribute. The only accepted values (and the result in
Pathway configuration) are of the form:

-nu value Pathway CPUS attribute
--------- ----------------------
-nu a CPUS (a:0)
-nu a:b CPUS (a:b)

More complex Pathway serverclass CPUS attributes settings must be
configured after the queue manager has been created, using the HP
PATHCOM utility.

Chapter 23 - API exits

- Pages 373-375: please review the updates to this section in the
documentation supplement for API exits for HP NonStop Server called
Exits.pdf. This supplement has been extensively revised for V5.3.1.1
to clarify the requirements and process for creating and integrating
exits with WebSphere MQ.

Appendix B - Directory structure

- Pages 430 and 431: there is a new G symbolic link to the Guardian
subvolume containing the product executables in
.../var/mqm/qmgrs/@SYSTEM

- Page 431: the content of the ssl directory is revised with V5.3.1.1
as follows:

This directory contains up to four files used by the SSL support:
- The queue manager certificate and private key store (cert.pem)
- The trusted certificates store (trust.pem)
- The pass phrase stash file for the queue managers certificate
and private key store (Stash.sth)
- The certificate revocation list file (optional - crl.pem)

Appendix F - Environment variables

- Page 446: there are several environment variables that are used by the
Guardian sample build scripts to locate the header files and the
libraries. Suitable settings for these are established in the
WMQCSTM file (in the Guardian samples subvolume). The environment
variables, and their meanings, are:

MQNSKOPTPATH^INC^G include file/header subvolume
MQNSKOPTPATH^BIN^G binaries subvolume
MQNSKOPTPATH^LIB^G binaries subvolume
MQNSKOPTPATH^SAMP^G samples subvolume

In addition, an HP environment variable is also required (and set in
WMQCSTM) that locates the OSS DLLs for dynamic loading from Guardian.
The environment variable is ^RLD^FIRST^LIB^PATH.

Appendix H - Building and running applications

Building C++ applications,

Table 47 - there is no multi-threaded library support in
Guardian so there should not be an entry for a
multi-threaded guardian library

Table 48 - the name of this table should be "Native non-PIC"

References to G/lib symbolic links have changed with WMQ 5.3.1 to lib/G

Note that the MQNSKVARPATH and MQNSKOPTPATH environment variables must
be established in the environment, before an application starts up.
They cannot be programmatically set once a program is running by using
putenv().

Appendix J - User exits

- refer to the documentation supplement Exits.pdf for updated information
about configuring and building user exits. This supplement has been
extensively revised for V5.3.1.1 to clarify the requirements and process
for creating and integrating exits with WebSphere MQ.

SSLupdate.pdf page 7
-----------------------------------------------------------------------------

The SSLupdate.pdf document was first released with Fixpack 5.3.1.1

The SSL test scripts expect that a default TCP/IP process ($ZTC0) is configured
on the system to be used during the test. The configuration will need modification
if a non-default TCP/IP process does not exist on the system or another TCP/IP
process is used to communicate with the partner system. The ALICE.sh and/or
BOB.sh scripts that setup of the listener (runmqlsr) will need modification
to add the -g option to use a non-default TCP/IP process.



CONTACTING IBM SOFTWARE SUPPORT
===============================

IBM Software Support provides assistance with product defects. You might
be able to solve you own problem without having to contact IBM Software
Support. The WebSphere MQ Support Web page:
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
contains links to a variety of self-help information and technical flashes.
TheMustGather Web page:
http://www.ibm.com/support/docview.wss?uid=swg21229861
contains diagnostic hints and tips that will aid in diagnosing and
solving problems, as well of details of the documentation required by
the WebSphere MQ support teams to diagnose problems.

Before you "Submit your problem" to IBM Software Support, ensure
that your company has an active IBM software maintenance contract, and
that you are authorized to submit problems to IBM. The type of software
maintenance contract that you need depends on the type of product you
have:

For IBM distributed software products (including, but not limited to,
Tivoli(R), Lotus(R), and Rational(R) products, as well as DB2(R) and
WebSphere products that run on Windows or UNIX(R) operating systems),
enroll in Passport Advantage(R) in one of the following ways:
Online: Go to the Passport Advantage Web site at
http://www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home,
and click "How to Enroll".
By phone: For the phone number to call in your country, go to the "Contacts"
page of the IBM Software Support Handbook at
http://techsupport.services.ibm.com/guides/contacts.html, and click the name
of your geographic region.
For customers with Subscription and Support (S & S) contracts, go to the
Software Service Request Web site at
https://techsupport.services.ibm.com/ssr/ssr.slprob.
For customers with IBMLink(TM), CATIA, Linux(R), S/390(R), iSeries(TM),
pSeries(R), zSeries(R), and other support agreements, go to the IBM Support
Line Web site at
http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006.
For IBM eServer(TM)) software products (including, but not limited to,
DB2(R) and WebSphere products that run in zSeries, pSeries, and iSeries
environments), you can purchase a software maintenance agreement by working
directly with an IBM sales representative or an IBM Business Partner.
For more information about support for eServer software products, go to the
IBM Technical Support Advantage Web site at
http://www.ibm.com/servers/eserver/techsupport.html.

If you are not sure what type of software maintenance contract you need,
call 1-800-IBMSERV (1-800-426-7378) in the United States. From other
countries, go to the "Contacts" page of the IBM Software Support
Handbook at http://techsupport.services.ibm.com/guides/contacts.html
and click the name of your geographic region for phone numbers of people
who provide support for your location.

To contact IBM Software support, follow these steps:

1. "Determine the business impact of your problem"
2. "Describe your problem and gather background information"
3. "Submit your problem"

Determine the business impact of your problem

When you report a problem to IBM, you are asked to supply a severity
level. Therefore, you need to understand and assess the business impact
of the problem that you are reporting. Use the following criteria:


+---------------------------------+----------------------------------+
| Severity 1 | The problem has a critical |
| | business impact: You are unable |
| | to use the program, resulting in |
| | a critical impact on operations. |
| | This condition requires an |
| | immediate solution. |
+---------------------------------+----------------------------------+
| Severity 2 | This problem has a significant |
| | business impact: The program is |
| | usable, but it is severely |
| | limited. |
+---------------------------------+----------------------------------+
| Severity 3 | The problem has some business |
| | impact: The program is usable, |
| | but less significant features |
| | (not critical to operations) are |
| | unavailable. |
+---------------------------------+----------------------------------+
| Severity 4 | The problem has minimal business |
| | impact: The problem causes |
| | little impact on operations, or |
| | a reasonable circumvention to |
| | the problem was implemented. |
+---------------------------------+----------------------------------+

Describe your problem and gather background information

When describing a problem to IBM, be as specific as possible. Include
all relevant background information so that IBM Software Support
specialists can help you solve the problem efficiently. See the
MustGather Web page
http://www.ibm.com/support/docview.wss?uid=swg21229861 for
details of the documentation required. To save time, know the answers to
these questions:

What software versions were you running when the problem occurred?
Do you have logs, traces, and messages that are related to the problem
symptoms? IBM Software Support is likely to ask for this information.
Can you re-create the problem? If so, what steps do you perform to
re-create the problem? Did you make any changes to the system? For example,
did you make changes to the hardware, operating system, networking software,
or other system components? Are you currently using a workaround for the
problem? If so, please be prepared to describe the workaround when you
report the problem.

Submit your problem

You can submit your problem to IBM Software Support in one of two ways:

Online: Go to the Submit and track problems tab on the IBM Software Support
site at http://www.ibm.com/software/support/probsub.html. Type your
information into the appropriate problem submission tool.
By phone: For the phone number to call in your country, go to the "Contacts"
page of the IBM Software Support Handbook at
http://techsupport.services.ibm.com/guides/contacts.html and click the name
of your geographic region.

If the problem you submit is for a software defect or for missing or
inaccurate documentation, IBM Software Support creates an Authorized
Program Analysis Report (APAR). The APAR describes the problem in
detail. Whenever possible, IBM Software Support provides a workaround
that you can implement until the APAR is resolved and a fix is
delivered. IBM publishes resolved APARs on the Software Support Web site
daily, so that other users who experience the same problem can benefit
from the same resolution.


NOTICES AND TRADEMARKS
======================

IBM may not offer the products, services, or features discussed in this
document in all countries. Consult your local IBM representative for
information on the products and services currently available in your
area. Any reference to an IBM product, program, or service is not
intended to state or imply that only that IBM product, program, or
service may be used. Any functionally equivalent product, program, or
service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate
and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject
matter described in this document. The furnishing of this document does
not give you any license to these patents. You can send license
inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact
the IBM Intellectual Property Department in your country/region or send
inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any
other country/region where such provisions are inconsistent with local
law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in
certain transactions; therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM may
make improvements and/or changes in the product(s) and/or the program(s)
described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of
those Web sites. The materials at those Web sites are not part of the
materials for this IBM product, and use of those Web sites is at your
own risk.

IBM may use or distribute any of the information you supply in any way
it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the
purpose of enabling: (i) the exchange of information between
independently created programs and other programs (including this one)
and (ii) the mutual use of the information that has been exchanged,
should contact:
IBM Canada Limited
Office of the Lab Director
8200 Warden Avenue
Markham, Ontario
L6G 1C7
CANADA

Such information may be available, subject to appropriate terms and
conditions, including in some cases payment of a fee.

The licensed program described in this document and all licensed
material available for it are provided by IBM under terms of the IBM
Customer Agreement, IBM International Program License Agreement, or any
equivalent agreement between us.

Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating
environments may vary significantly. Some measurements may have been
made on development-level systems, and there is no guarantee that these
measurements will be the same on generally available systems.
Furthermore, some measurements may have been estimated through
extrapolation. Actual results may vary. Users of this document should
verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers
of those products, their published announcements, or other publicly
available sources. IBM has not tested those products and cannot confirm
the accuracy of performance, compatibility, or any other claims related
to non-IBM products. Questions on the capabilities of non-IBM products
should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to
change or withdrawal without notice, and represent goals and objectives
only.

This information may contain examples of data and reports used in daily
business operations. To illustrate them as completely as possible, the
examples include the names of individuals, companies, brands, and
products. All of these names are fictitious, and any similarity to the
names and addresses used by an actual business enterprise is entirely
coincidental.

This information may contain sample application programs, in source
language, which illustrate programming techniques on various operating
platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM for the purposes of developing, using,
marketing, or distributing application programs conforming to the
application programming interface for the operating platform for which
the sample programs are written. These examples have not been thoroughly
tested under all conditions. IBM, therefore, cannot guarantee or imply
reliability, serviceability, or function of these programs.


Trademarks

The following terms are trademarks of International Business
Machines Corporation in the United States, other countries,
or both: DB2, eServer, IBM IBMLink, iSeries, Lotus, MQSeries, pSeries,
Passport Advantage, Rational, s/390, SupportPac, Tivoli, WebSphere, zSeries.

UNIX is a registered trademark of The Open Group in the United States
and other countries.

Microsoft Windows is a trademark or registered trademark of Microsoft
Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Sun Microsystems, Inc. in the United States, other countries,
or both.

Linux is a trademark of Linus Torvalds in the United States, other
countries, or both.

Other company, product or service names may be the trademarks
or service marks of others