Readme File for IBM® Spectrum Symphony 7.2.1.1 Interim Fix 543928
Readme File for: IBM Spectrum Symphony
Product Release: 7.2.1.1
Update Name: Interim Fix 543928
Fix ID: sym-7.2.1.1-build543928
Publication Date: April 2, 2020
With recursive workload, a task’s child sessions continue if the task cannot be complete in its current condition. However, in some cases, these child sessions need to be stopped, as the task subsequently creates new child sessions when the task is executed again. The old child sessions are no longer needed. This interim fix provides a flag to stop these old sessions.
Contents
1. List of fixes
2. Download location
3. Product and components affected
4. Installation and configuration
5. Uninstallation
6. List of files.
7. Product notifications
8. Copyright and trademark information
1. List of fixes
APAR: P103487
2. Download location
Download interim fix 543928 from the following location: https://www.ibm.com/eserver/support/fixes/
3. Product and components affected
Component name, Platform, Fix ID:
SOAM, Linux x86_64, sym-7.2.1.1-build543928
4. Installation and configuration
Follow the instructions in this section to download and install this interim fix to your cluster.
System requirements
Linux x86_64
Installation
a. Log on to the master host as the cluster administrator, disable the applications and stop the SD service:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
> egosh service stop SD
b. On each management host, create a directory (for example, /symfixes) and download the soamcore-7.2.1.1_x86_64_build543928.tar.gz package to the directory.
c. Use the egoinstallfixes command to install the package:
> egoinstallfixes /symfixes/soamcore-7.2.1.1_x86_64_build543928.tar.gz
Note: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory for recovery purposes. Do not delete this backup directory; you will need it if you want to recover the original files.
d. Enable this enhancement by manually editing the sd.xml file:
1) Open the $EGO_CONFDIR/../../eservice/esc/conf/services/sd.xml file.
2) Configure the SSM_CLOSE_CHILD_SESSIONS_OF_RETRIED_TASK environment variable. Valid values are TRUE or FALSE. The default is FALSE.
For example, to close all child sessions for a retried task, set the value to TRUE, as follows:
<sc:ServiceDefinition ...>
…
<sc:ActivityDescription>
<ego:Attribute name="hostType" type="xsd:string">X86_64</ego:Attribute>
<ego:ActivitySpecification>
…
<ego:EnvironmentVariable name="SSM_CLOSE_CHILD_SESSIONS_OF_RETRIED_TASK">TRUE</ego:EnvironmentVariable>
…
</ego:ActivitySpecification>
</sc:ActivityDescription>
…
</sc:ServiceDefinition>
3) Apply your changes:
> egosh service modify SD -f $EGO_CONFDIR/../../eservice/esc/conf/services/sd.xml
e. Start the SD service and enable applications:
> egosh service start SD
> soamcontrol app enable appName
5. Uninstallation
If required, follow the instructions in this section to uninstall this interim fix from your cluster.
a. Log on to the master host as the cluster administrator, disable applications and stop the SD service:
> egosh user logon -u Admin -x Admin
> soamcontrol app disable all
> egosh service stop SD
b. Log on to each management host and roll back this fix.
> egoinstallfixes -r 543928
d. Remove the SSM_CLOSE_CHILD_SESSIONS_OF_RETRIED_TASK environment variable from the sd.xml file.
e. Start the SD service and enable applications:
> egosh service start SD
> soamcontrol app enable appName
6. List of files
soam/7.2.1/linux-x86_64/etc/sd
soam/7.2.1/linux-x86_64/etc/ssm
7. Product notifications
To receive information about product solution and patch updates automatically, subscribe to product notifications on the My Notifications page http://www.ibm.com/support/mynotifications/ on the IBM Support website (http://support.ibm.com). You can edit your subscription settings to choose the types of information you want to get notification about, for example, security bulletins, fixes, troubleshooting, and product enhancements or documentation changes.
8. Copyright and trademark information
© Copyright IBM Corporation 2020
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
IBM®, the IBM logo, and ibm.com® are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.