Fix (APAR):  PQ79991

Status:  Fix

Release:  5.0.2.2,5.0.2.1,5.0.2

Operating System:  All

Supersedes Fixes:  None

CMVC Defect:  PQ79991

Byte size of APAR:  4840

Date: 2003-12-04

Abstract:  Problme creating ListenerPort using wsadmin

Description/symptom of problem:  When creating a ListenerPort within server's Message
Listener Service.  The wsadmin command "$AdminConfig required
ListenerPort" returns name, connectionFactoryJNDIName and
destinationJNDIName.  Creating a ListenerPort with only these
3 attributes will appear to have been successfull, however the
server failed to start/restart.  This is because attribute StateManageable is missing.
This ifix provides a template for ListenerPort that contains the StateManageable attribute, so that if the attribute is not set, it will create one for user with initialState set to START.



Directions to apply fix:  

NOTE:  YOU MUST FIRST DOWNLOAD THE UPDATE INSTALLER TOOL IN ORDER TO INSTALL A FIX.
       The Fix Installer can be downloaded from the following link:
       http://www-3.ibm.com/software/webservers/appserv/support/index.html

1) Create temporary "fix" directory to store the jar file:
             UNIX: /tmp/WebSphere/fix
          Windows: c:\temp\WebSphere\fix

2) Copy jar file to the directory

3) Shutdown WebSphere

4) Follow the Fix installation instructions that are packaged with the Fix Installer on how to install the Fix.

5) Restart WebSphere

6) The temp directory may be removed.

Directions to remove fix:  
NOTE:  FIXES MUST BE REMOVED IN THE ORDER THEY WERE APPLIED.  DO NOT REMOVE A FIX UNLESS
     ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED.  YOU MAY REAPPLY ANY REMOVED FIX.

Example:  If your system has fix1, fix2, and fix3 applied in that order and fix2 is to be
          removed, fix3 must be removed first, fix2 removed, and fix3 re-applied.


1) Shutdown WebSphere

2) Follow the instructions that are packaged with the Fix Installer on how to uninstall the Fix.

3) Restart WebSphere

Directions to re-apply fix:  
1) Shutdown WebSphere

2) Follow the Fix instructions that are packaged with the Fix Installer on how to uninstall and reinstall the Fix.

3) Restart WebSphere



Additional Information:  1) This iFix replaces template file server-component-templates.xml in WAS_ROOT/config/templates/default directory.  

2) This iFix applies to 5.0.2.x.  PQ74005 is its equivalent on 5.0.1