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

3.      Configuration and usage

4.      Uninstallation

5.      Product notifications

6.      Copyright and trademark information

1.   Scope

Before you install this enhancement to your cluster, note the following requirements:

Operating system

Windows

Product version

IBM Spectrum Symphony 7.1.2

2.   Installation

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

Installing on DE hosts

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.

Installing on client hosts

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

1.   Configuration and usage

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;

  }

}

2.   Uninstallation

If required, follow these instructions to uninstall this enhancement on Windows DE and client hosts in your cluster:

Uninstalling on DE hosts

  1. Log on to each Windows DE host in your cluster. Ensure that no client processes are running.
  1. Roll back this enhancement:

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.

Uninstalling on client hosts

  1. Log on to each Windows client host in your cluster. Ensure that no client processes are running.
  2. Roll back this enhancement:

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

3.   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.

4.   Copyright and trademark information

© 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.