Readme File for IBM®
Spectrum Symphony 7.1.2 RFE 119303
Readme File for: IBM Spectrum Symphony
Product Release: 7.1.2
Fix ID: sym-7.1.2-build510952-cs
Publication Date: February 15, 2019
This
update for the .NET API in IBM Spectrum Symphony 7.1.2 adds the TaskTag property to
the TaskInputHandle and
TaskOutputHandle objects and adds the ReceiveAsyncTaskSentStatus callback.
Contents
1.
Scope
2.
Installation
6.
Copyright and trademark information
Before you install
this enhancement to your cluster, note the following requirements:
Operating system |
Windows |
Product version |
IBM Spectrum Symphony 7.1.2 |
Follow these
instructions to download and install this enhancement on Windows Developer
Edition (DE) and client hosts.
This installation
updates Platform.Symphony.Soam.Net4.0_64.dll only in the
Global Assembly Cache. The file location in Windows 10 or Windows 2016 is:
C:\Windows\Microsoft.Net\assembly\GAC_64\Platform.Symphony.Soam.Net4.0_64\v4.0_7.1.2.0__07d115044e882e03\Platform.Symphony.Soam.Net4.0_64.dll
Ensure that any
references to Platform.Symphony.Soam.Net4.0_64.dll in your
Visual Studio project point to the Global Assembly Cache location, not to the
DE or client installation directories.
a.
In the Visual Studio Solution Explorer, expand
the client sub-project.
b.
Under References, select Platform.Symphony.Soam.Net4.0_64.dll.
c.
In the Properties dialog, view the Path to
ensure the GAC is referenced:
C:\Windows\Microsoft.Net\assembly\GAC_64\Platform.Symphony.Soam.Net4.0_64\v4.0_7.1.2.0__07d115044e882e03\Platform.Symphony.Soam.Net4.0_64.dll
d.
If the GAC is not referenced, remove the Platform.Symphony.Soam.Net4.0_64 reference
and add a new reference pointing to this file:
C:\Windows\Microsoft.Net\assembly\GAC_64\Platform.Symphony.Soam.Net4.0_64\v4.0_7.1.2.0__07d115044e882e03\Platform.Symphony.Soam.Net4.0_64.dll
a.
Log on to each Windows DE host in your cluster. Ensure that no client
processes are running.
b.
On each Windows DE host, download the symde-7.1.2.0_build510952.msp package to a temporary location on the host and install the package:
o
For an interactive
installation, double-click the symde-7.1.2.0_build510952.msp package and follow the prompts.
o For
a silent installation, enter the following commands from the command prompt:
C:\>msiexec /update symde-7.1.2.0_build510952.msp /l*v symupdatesoamde.log /norestart
/quiet REINSTALLMODE=omus
The command syntax is
as follows:
C:\>msiexec /update sym_package_name_path /l*v sym_install_log /norestart /quiet REINSTALLMODE=omus
where:
o sym_package_name_path is the fully
qualified path to the .msp package.
o sym_install_log is the log file for the upgrade.
a.
Log on to each Windows client host in your cluster. Ensure that no client
processes are running.
b. On each compute host, download the symclnt-7.1.2.0_build510952.msp package to a temporary location on the
host and install the package:
o
For an interactive installation,
double-click the symclnt-7.1.2.0_build510952.msp
package and follow the prompts.
o
For a silent
installation, enter the following commands from the command prompt:
C:\>msiexec /update
symclnt-7.1.2.0_build510952.msp /l*v
symupdatesoamclient.log /norestart /quiet
REINSTALLMODE=omus
No
configuration changes are associated with this update.
o
The following is an example of C# getting the TaskTag from the TaskInputHandle.
TaskInputHandle input = session.SendTaskInput(taskAttr);
String inTag = input.TaskTag;
o
The following is an example of C# getting the TaskTag from the TaskOutputHandle.
TaskOutputHandle output; // output value can be retrieved from FetchTaskOutput
String outTag = output.TaskTag;
o
The following is an example of how to register the
task sent to SSM notification in the client.
SessionCallback callback = new SessionCallback();
callback.OnTaskSent += new SessionCallback.TaskSentHandler(AsyncClientOnTaskSent);
SessionCreationAttributes attributes = new SessionCreationAttributes();
attributes.SessionFlags = SessionFlags.ReceiveAsyncTaskSentStatus;
attributes.SessionCallback = callback;
private void AsyncClientOnTaskSent(TaskInputHandle input)
{
if (input.SubmissionState == SubmissionState.SubmitCompleted)
{
String inTag = input.TaskTag;
}
}
If required, follow these instructions to uninstall this
enhancement on Windows DE and client hosts in your cluster:
o To roll back
from the Windows Control Panel, go to Control Panel > Programs and
Features > View installed updates, click Update for Symphony 7.1.2
(build “510952”) and click Uninstall.
o To roll back
from the IBM Spectrum Symphony command prompt, enter the following command:
C:\>msiexec
/uninstall {53AC5697-CA9E-4A78-B46E-E2CAD52FBB47} /package symde-7.1.2.0.msi /norestart /quiet /l*v
symde_rollback.log
The
command syntax is as follows:
C:\>msiexec
/uninstall enhancement_code /package product_msi /norestart /quiet
/l*v rollback_log
where:
o
enhancement_code is the identifier of the .msp package for this enhancement.
o
product_msi is the path to the .msi file
for the original product installation package.
o
rollback_log is the name of the log file to capture
details of the rollback.
o To roll back
from the Windows Control Panel, go to Control Panel > Programs and
Features > View installed updates, click Update for Symphony 7.1.2
(build “510952”) and click Uninstall.
o To roll back
from the IBM Spectrum Symphony command prompt, enter the following command:
C:\>msiexec
/uninstall {AEC276FD-62F5-4350-8945-740FE513ED53} /package symclnt-7.1.2.0.msi
/norestart /quiet /l*v symclient_rollback.log
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.
© Copyright IBM Corporation 2019
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.