IBM Platform Process Manager 9.1.2 Fix 234601 Readme

Abstract

This Fix resolves the issues of Process Manager splitting a job array that contains more than 1000 jobs into multiple job arrays for submission, and that of Process Manager continuously triggering flows when proxy events are used.

Description

Readme for IBM Platform Process Manager 9.1.2 Fix 234601.

This fix addresses the following issues:

- By default, when a job array contains more than 1000 jobs, Process Manager splits the job array submission into several job arrays with 1000 jobs each. However, if a user accidentally specifies a very large index for a job array in a flow, this can overload LSF and Process Manager. The new parameter JS_JOB_ARRAY_SPLIT in $JS_ENVDIR/js.conf changes this behavior. When JS_JOB_ARRAY_SPLIT=false, JFD no longer splits job array submission, and the maximum number of jobs in a job array is defined with the LSF MAX_JOB_ARRAY_SIZE parameter in lsb.params. When a job array index is larger than the value defined by MAX_JOB_ARRAY_SIZE in lsb.params, the job array submission is rejected. The default value of JS_JOB_ARRAY_SPLIT is true.

- When a flow is triggered with a proxy event, once the proxy event occurs, Process Manager continuously triggers flows from the flow definition within the proxy event duration. The correct behavior is for the proxy event to trigger only one flow from the flow definition within the proxy event duration.

Readme file for: IBM® Platform Process Manager
Product/Component Release: 9.1.2.0
Update Name: Fix 234601
Fix ID: ppm-9.1.2-build234601
Publication date: 20 May 2014
Last modified date: 20 May 2014

Contents:

1.     List of fixes

2.     Download location

3.     Products or components affected

4.     System requirements

5.     Installation and configuration

6.     List of files

7.  Copyright and trademark information

1.   List of fixes

P100419
P100456

2.   Download Location

Download Fix 234601 from the following location: http://www.ibm.com/eserver/support/fixes/

3.   Products or components affected

Affected components: jfd

4.   System requirements

4.1          Software requirements

RHEL 5/6 x86_64

SLES 10/11 x86_64

5.   Installation and configuration

5.1          Before installation

1.     Log into the IBM Platform Process Manager server as Process Manager primary administrator or root.

2.     Set the environment for the IBM Platform Process Manager installation:

-      C shell: # source $JS_ENVDIR/cshrc.js

-      Bourne shell: # . $JS_ENVDIR/ profile.js

3.     Shut down jfd by running "jadmin stop".

5.2          Installation steps

1.     Back up $JS_SERVERDIR/jfd.

2.     Copy jfd in this update to $JS_SERVERDIR/jfd.

5.3          After installation

1.     Log into the IBM Platform Process Manager server as root.

2.     Set the environment for the IBM Platform Process Manager installation:

-      C shell: # source $JS_ENVDIR/cshrc.js

-      Bourne shell: # . $JS_ENVDIR/ profile.js

3.     If needed, edit $JS_ENVDIR/js.conf, and set JS_JOB_ARRAY_SPLIT=false in js.conf to prevent JFD from splitting the job array submission into several job arrays with 1000 jobs each. Use MAX_JOB_ARRAY_SIZE in lsb.params to set the maximum number of jobs allowed in a job array.

4.     Start jfd by running "jadmin start".

5.4          Uninstallation

1.     Log into the IBM Platform Process Manager server as Process Manager primary administrator or root, and shut down jfd by running "jadmin stop".

2.     Replace $JS_SERVERDIR/jfd with the backed up jfd in step 5.2.

3.     Log into the IBM Process Manager server as root, and start jfd by running "jadmin start".

6.   List of files

jfd

7.       Copyright and trademark information

© Copyright IBM Corporation 2014

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.