IBM Support

Known Issues for Sterling B2B Integrator V5.2.5

Release Notes


Abstract

Information on known issues in this release are listed below with approved workaround information, when available.

Content

Functionality

Known IssueWorkaround
AdaptersSummary:
Security Context Missing error is generated in the swiftnet.log during SwiftNet 7 Adapter start-up

Problem Description:
Steps during which problem is seen
1. Setup SwiftNet7 and Create an Adapter with all the proper values specified.
2. Start the adapter
Adapter is enabled successfully but the following error is shown in the swiftnet.log

[2014-08-26 06:05:10.566] ERROR [SwiftnetConfig]Caught exception while loading the parameters:
[2014-08-26 06:05:10.566] ERROR [1409047510566] At least 1 Security Context is required to start the adapter.
[2014-08-26 06:05:10.566] ERRORDTL [1409047510566]java.lang.Exception: At least 1 Security Context is required to start the adapter.
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.server.SwiftnetConfig.loadUpSwiftnetConfig(SwiftnetConfig.java:859)
at com.sterlingcommerce.woodstock.ui.SwiftQueuesConfig.save(SwiftQueuesConfig.java:754)
at com.sterlingcommerce.woodstock.adminui.servlet.SaveService.run(SaveService.java:88)		No work-around.
Error seen only in logs and adapter works fine.
AdaptersSummary:
SSH remote profile view pop-up shows system error

Problem Description:
Below are the steps during which problem is seen.
1. Run changepassphrase.cmd/sh on client but do not select update profiles.(select "NO")
2. Bring up SI
3. View any Remote profile		Click on Edit of the chosen remote profile and update it.
We advise users to no to choose "NO" when they run changepassphrase.cmd/sh and asks to update profiles.
When the user selects NO when they run the script, the remote profile gets corrupted in the database. Any trading partner BP trying to access this profile information will fail until the user updates the profile. At the time the script runs, a message is displayed to the customer that they need to manually update profile and they must edit the profile and correct it.
AdaptersSummary:
If you're on Windows, and you have adapter containers set up, you may need to manually run setupfiles.cmd after upgrading to 5.2.5.

Symptoms:
While the adapter container seems to start up correctly when the system is started, any attempt to use an adapter in the adapter container will fail with an error message in the business process tracking UI indicating that the adapter was not found.  To see if this particular issue is the cause of this error, go to the adapter container properties directory (<si_install>/properties/node<node_num>AC<container_num>) and examine the system_overrides.properties file.  If this file contains text like &PROP_DIR; (more generally &<text>;) then you are experiencing this issue.		The workaround for this issue is as follows:
1) stop the SI system
2) run setupfiles.cmd
3) restart the system
AdaptersSummary:
java.lang.Exception is thrown in System.log for SN7 Adapter GroupName

Problem Description:
Steps during which problem is seen
1. Build 525 Cluster install
2. Setup SN7 Adapter on both the nodes, providing SN7Grp as the group name for both the adapters
     - We have to install MEFG for both the nodes
     - Create a Copy of SN7 Http Server Adapter on Node2 and assign a grp "SN7ServerGrp"
     - Assign the same group to SN7 Http Server Adapter on Node1
     - Create a Copy of SN7 Http Client Adapter on Node2 and assign a grp "SN7ClientGrp"
     - Assign the same group to SN7 Http Client Adapter on Node1
3. On Node1, Execute the Client Profile and verify that the BP is successful on giving the Node1 adapter name in Client Profile
4. On Node2, Execute the Client Profile and verify that the BP is successful on giving the Node2 adapter name in Client Profile
5. On Node1, Execute the Client Profile and verify that the BP is successful on giving the SN7 Adapter group name i.e. SN7Grp in Client Profile
6. On Node2, Execute the Client Profile and verify that the BP is successful on giving the SN7 Adapter group name i.e. SN7Grp in Client Profile

Check the System.log in case of Step 5 & Step6. Following exception is seen in the logs:

[2014-09-17 07:32:35.271] ERROR 000410010067 SERVICES.SERVICES.ERR_servicename Could not get parent for SN7Grp
[2014-09-17 07:32:35.271] ERROR 000410010067 SERVICES.SERVICES.ERR_servicename Could not get parent for SN7Grp
[2014-09-17 07:32:35.272] ERROR [1410953555272] The parent of SN7Grp cannot be null.
[2014-09-17 07:32:35.272] ERRORDTL [1410953555272]java.lang.Exception: The parent of SN7Grp cannot be null.
at com.sterlingcommerce.woodstock.services.SII.load(SII.java:1138)
at com.sterlingcommerce.woodstock.services.SII.load(SII.java:1122)
at com.sterlingcommerce.woodstock.services.SII.get(SII.java:1075)
at com.sterlingcommerce.woodstock.services.SII.get(SII.java:1033)
at com.sterlingcommerce.woodstock.services.SII.get(SII.java:1030)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.BaseUtils.checkInstance(BaseUtils.java:226)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.client.SendHandler.getAdapterRelatedParams(SendHandler.java:861)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.client.SendHandler.getGenericParams(SendHandler.java:338)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.client.SendHandler.requestPreparation(SendHandler.java:166)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.client.SendHandler.handleClientRequest(SendHandler.java:117)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.client.SwiftClientService.handleClientRequest(SwiftClientService.java:66)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:60)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:37)
at java.lang.reflect.Method.invoke(Method.java:611)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.SwiftService.processSwiftMsg(SwiftService.java:147)
at com.sterlingcommerce.woodstock.services.swiftnet.swiftnet7.SwiftService.processData(SwiftService.java:102)
at com.sterlingcommerce.woodstock.workflow.activity.engine.ActivityEngineHelper.invokeService(ActivityEngineHelper.java:1818)
at com.sterlingcommerce.woodstock.workflow.activity.engine.ActivityEngineHelper.nextMainLogic(ActivityEngineHelper.java:631)
at com.sterlingcommerce.woodstock.workflow.activity.engine.ActivityEngineHelper.next(ActivityEngineHelper.java:362)
at com.sterlingcommerce.woodstock.workflow.queue.WorkFlowQueueListener.doWork(WorkFlowQueueListener.java:440)
at com.sterlingcommerce.woodstock.workflow.queue.WorkFlowQueueListener.run(WorkFlowQueueListener.java:236)
at com.sterlingcommerce.woodstock.workflow.queue.WorkFlowQueueListener.onMessage(WorkFlowQueueListener.java:197)
at com.sterlingcommerce.woodstock.workflow.queue.WorkFlowQueueListener.onMessage(WorkFlowQueueListener.java:184)
at com.sterlingcommerce.woodstock.workflow.queue.wfTransporter.run(wfTransporter.java:444)
at com.sterlingcommerce.woodstock.workflow.queue.BasicExecutor$Worker.run(BasicExecutor.java:508)
at java.lang.Thread.run(Thread.java:738)		No Workaround.
This error can be ignored as it does not cause any functional impact.
AdaptersSummary:
SWIFTNet7 Client Service on Node2 fails with SNL/SWIFT Error when Node1 is down but executes successfully on resending

Problem Description:
Steps during which problem is seen
1. Build 525 Cluster install
2. Setup SN7 Adapter, Interact mode in Realtime, on both the nodes, providing SN7Grp as the group name for both the adapters
     - We have to install MEFG for both the nodes
     - Create a Copy of SN7 Http Server Adapter on Node2 and assign a grp "SN7ServerGrp"
     - Assign the same group to SN7 Http Server Adapter on Node1
     - Create a Copy of SN7 Http Client Adapter on Node2 and assign a grp "SN7ClientGrp"
     - Assign the same group to SN7 Http Client Adapter on Node1
3. On Node1, Execute the Client Profile and verify that the BP is successful on giving the Node1 adapter name in Client Profile
4. On Node2, Execute the Client Profile and verify that the BP is successful on giving the Node2 adapter name in Client Profile
5. On Node1, Execute the Client Profile and verify that the BP is successful on giving the SN7 Adapter group name i.e. SN7Grp in Client Profile
6. On Node2, Execute the Client Profile and verify that the BP is successful on giving the SN7 Adapter group name i.e. SN7Grp in Client Profile. SN7 Client & Server logs are attached (N1_Up_SNClientLog.txt & N1_Up_SN7ServerLog.txt)

7. Bring the Node1 down i.e. Hardstop the Node1 instance
8. On Node2, Execute the Client Profile on giving the SN7 Adapter group name i.e. SN7Grp in Client Profile

SWIFTNet7Client BP fails with SWIFTNet7 Client Service Error.		No Workaround.
The scheduler 'SWIFTNet7AdapterScheduler' is Enabled on Node2, it will resend the failed transaction and 'SWIFTNet7ClientResend' BP will be executed successfully this time.
AdaptersThis note is useful if your B2Bi instance has OCSP Certificates (i.e. any certificate with OCSP_INFO = YES) and plan to configure OFTP Profiles with Encryption and Signing Algorithms. OCSP Certificates have incompatibility with our OFTP implementation at this point and OFTP User Interface displays inconsistent behavior if there is any OCSP Certificate in the system. We recommend that you do not have any OCSP Certificates in your system if you plan to go for configuration of OFTP Profiles with Encryption and Signing Algorithms.
AdaptersSummary:
SFTP GET with remotefilepattern parameter set to *.* is not working

Problem Description:
We can use wild card character for the parameter 'remotefilepattern' in SFTP GET service. One such wild card pattern *.* is not working. 		Please use "*" to get the list of all files or use specific file extensions (suffix) like *.txt to get all txt files with 'remotefilepattern' parameter.
AdaptersSummary:
Cannot set Encoding value in WebSphere MQ using WebSphere MQ adapter or GPM in Sterling Integrator

Problem Description:
Steps during which problem is seen -

Create/Edit WebSphere MQ adapter or open the WSMQ Put Service using GPM. The parameter used to set Encoding value will not appear.		Encoding can be added as an assign statement in a BP.
AdaptersSummary:
FTP Server Adapter view screen doesn't display other associated CA certs if any of the selectedassociated cert is deleted.

Problem Description:
When editing a certificate group that has:
1. 1 group (having 1 cert)
2. 1 cert

I delete the #1 group and save. It is deleted properly. However, when I go to view again, I can't see #2 anymore - it appears like it has been removed too. But if you try and edit you will see that it is still associated with this FTP Server Adapter.		After deleting a group, re-edit the FTP Server Adapter where it shows the single certificate and save again. After doing this when you view the FTP Server Adapter you will be able to see the associated certs
AdaptersSummary:
In NIST STRICT mode import of adapters with none NIST compliant system certificate could result in wrong system certificate association in UI display.

Problem Description:
In NIST STRICT mode if adapter with none NIST compliant certificate is imported  import fails with error message "The certificate is not NIST compliant" in the Import report.
This is expected however when editing the adapter, UI shows the first available system certificate as selected. This is misleading since the adapter is still associated with
the original system certificate which failed import and does not exist in the system.		User should import a NIST compliant certificate and edit the adapter with the correct system certificate or assign an existing system certificate to the adapter.
AdaptersSummary:
HTTP SSL settings are reset during configuration on clicking filter CA cert with CA cert name entered in filter.

Problem Description:
1. Create HTTP Server Adapter with SSL set to MUST
2. Navigate till the SSL Settings screen is displayed
3. Select 'cla2ssl' as System certificate and 'WEAK' as Cipher Strength
4. Type some text in CA cert filter and click on filter button

System Certificate & Cipher Strength drop down are reset to the first value in the list		You need to select the System Certificate and Cipher Strength again before you proceed further
AdaptersSummary:
FTP Server Adapter: If the "Extractable For" radio button is selected and if 1min is set leaving 'day' and 'hrs' as it is without any value,  FTP Server adapter saves extractability to 1day, 1hr & 1min.

Problem Description:
By default, 'extractability for' is not selected. If we select and and not provide any value then the extractability of the message gets set to 1day + 1hr + 1min.		If a user wants to just set the extractability to 1min, then user has to explicitly set the day as 0 and hour as 0.
AdaptersSummary:
Pool Name caching issue in case of JMS with Sonic MQ failover

Problem Description:
1. Configure JMS 1.1 Acquire Connection and Session Service in JNDI mode, providing Pool name to connect to SonicMQ 1
2. Send / Receive the msgs to / from the queues
3. Edit the Adapter and connect to SonicMQ 2
4. Send / Receive the msgs to / from the queues
5. Provide both the URLs, comma separated (failover setup)
6. Send / Receive the msgs to / from the queues
7. Bring down the URL1
8. Send the msg to the queue

Following is the jms.log:
[2014-11-07 07:07:25.262] ERROR Exception in creating connection with params Connection Key Attributes
URL tcp://pugsley.dub.usoh.ibm.com:2506,tcp://gomez.dub.usoh.ibm.com:2506
Context Factory com.sonicsw.jndi.mfcontext.MFContextFactory
Connection Factory QueueCF
Hash Code 431607959
Conn count 1
Session count 500
Time to live 300000
PoolName jndiPool
usingNonJndi false
usingCustomClassLoading Yes
userName Administrator
jmsProvider null
ssloption SSL_NONE
clientId null
JNDI Custom Props -> {com.sonicsw.jndi.mfcontext.domain=Domain1}

[2014-11-07 07:07:25.262] ERROR [1415362045262] java.net.ConnectException: Connection refused: tcp://pugsley.dub.usoh.ibm.com:2506
[2014-11-07 07:07:25.263] ERRORDTL [1415362045262]javax.jms.JMSException: java.net.ConnectException: Connection refused: tcp://pugsley.dub.usoh.ibm.com:2506
at progress.message.jimpl.JMSExceptionUtil.createJMSException(JMSExceptionUtil.java:42)
at progress.message.jimpl.Connection.<init>(Connection.java:666)
at progress.message.jclient.ConnectionFactory.createConnection(ConnectionFactory.java:2055)

Actual Behavior: Acquire Connection Session Service throws ConnectException: Connection refused in jms.logs when the URL1 is down and URL2 is Up
BP Advanced Status: Exception in creating connection with tcp://<hostname>:<port>,tcp://<hostname_2>:<port2>		Edit the adapter and change the Pool name or Edit the poolname in the BP by adding this assign stmt:
<assign to="POOL_NAME">Pool</assign>
Admin UISummary: (EBICSServer) PartnerId is coming in the HAC response instead of Partnername.

Problem Description: PartnerId is coming in the HAC response instead of Partnername.		The HAC response expects Customer name for <nm> tag, users can consider partnerId as Customer name since partnerId is the closest possible attribute available in the EBICS Contract.
Admin UISummary:
HVT response with order details are not displayed in EBICS Client UI

Description:
In the EBICS Client UI, when a user monitors its pending VEU tasks and investigates transfer details via HVT data, the EBICS Client UI shows only the first two account information records.		To see the full HVT response order data, the user can investigate the message that was put into its download mailbox:
1. Log on to the mailbox UI (http://<host>:<port>/mailbox).
2. Click 'Mailbox Search' to open the 'Mailbox Search' view.
3. Click in 'MailboxPath lookup' to adjust 'Mailbox' to the mailbox path to the user's download mailbox,
   e.g. '/MYUSER/MYPARTNER/Inbox'.
4. Adjust section 'Creation Date' to the period of time when the HVT order time was executed.
5. Click 'Go!'. The 'Mailbox Search Results' view opens.
6. Click the desired message. Its name looks simmilar to 'HVT@@MYPARTNER@MYHOST@ORDERID@TIMESTAMP'.
7. Your Browser downloads the HVT Response Order Data. It might open a dialog to let you choose how to handle the downloaded file.
Notes:
- you configure the user's download mailbox in the EBICS Client UI with a user having administration rights:
  Profile management > User > Search 'UserID' > Update > ... > 'Associated partner(s) - Edit a partner > Download mailbox path.
- the user needs direct access permissions to the user's download mailbox.
Admin UISummary :
When order comes with T with OZHNN, in case of NON VEU, if the configuration is done in such a way that it breaks the contract, the order will be processed successfully on server side.

Problem Description:
When order comes with T with OZHNN, in case of NON VEU, if the configuration is done in such a way that it breaks the contract, the order will be processed successfully on server side. 
This may or may not be the expected behavior and entirely depends on financial banks choice.		In order to avoid such inconsistencies clients can re check their configuration and abide by the contract with the financial institution.
Admin UISummary:  
(EbicsServer) For Non-VEU FUL (Min Sign 1 or more) if Signature/s are incorrect, Order_HAC_FINAL_NEG is not getting Logged.

Problem Description:
For Non-VEU FUL, when one or more Signatories are configured and Signer submit incorrect Signature, at server ORDER_HAC_FINAL_NEG is not getting logged. hence not coming in the HAC response.		In this case the business and technical return code of the original response should be checked for final status of the order.
Admin UISummary:
PSR  is not generated in case of NON-VEU for H004 protocol version.

Problem Description:
PSR is the acknowledgment that gets generated when a file is upload using FUL order. This acknowledgment can be downloaded using FDL. Though this is not mandatory for H004, some of the french banks can still opt for this.
PSR generation doesnt happen in case of NON-VEU for H004 protocol version.		For H004 protocol version, to check the order processing history users can rely completely on HAC order type instead of PSR report.
Admin UISummary:
Partner Id is not being shown in the UI for the other partner user's HVU / HVZ.

Problem Description:
For VEU download order HVU/HVZ when the partner who submitted the order is from a different ebics client system, then the ebics client UI will not show the partnerid value for HVU/HVZ response.		In case of VEU download orders HVU/ HVZ, the initiating partnerId can be found in the response xml that gets downloaded in the users mailbox. 
Admin UIIf you use "Remember search-by values" functionality (typically set using Accounts > My Account > Preferences), then please note this functionality doesn't work as expected when you use % or any other special characters like @, $, * etc as part of the search string.This is a known issue with the product.
Admin UISummary:
When using the account setting "Remember  Search-by Values", the remembered values have converted non-numeric characters to HTML hex entities when using the Policy Lock Manager.

Customers will see this issue if they have check the "Remember Search-by Values" in their account settings, then go to Deployment->Adapter Utilities ->Policy Lock Manager, and run it multiple times. On searches after the first time, the remembered date values becoming invalid.		Workarounds include replacing the HTML hex characters with their actual values by retyping them.
Admin UISummary:
HVD fails when FUL transactions with the same Order Id exist both in H003 and H004

Details:
HVD fails when FUL transactions with the same Order Id exist both in H003 and H004		This generally happens if the migration is done with orders pending in a particular protocol version, In order to avoid such failure users can make sure that before migrating to new protocol version, all the orders in pending VEU tasks are processed.
Admin UISummary:
Non-existing partner Id makes HVU or HVZ response return an error for signer users

Problem Description:
In case of partners which are deleted from the system and still has some pending orders corresponding to it and if a HVU/HVZ request is received from the ebics client system for a different partner  then HVU/HVZ may fail with internal error.		Make sure that direct or indirect resources are intact and not deleted from the setup. Re check the offer and contract before processing orders.
Admin UISummary:
The successful HKD order in EBICS client does not contain any attachment

Description:
Sometimes, even after a successful HKD response is received from the EBICS Bank Server, the client doesn't show the order data as attachment.		If the attachment is not visible in the Ebics client Order Search Details Screen, check the User's mailbox for the same.
Admin UISummary:
Issue: When creating resource tags for OFTP Profiles Only, OFTP Profiles with dependencies, and Schema Mappings, the associate resource type panel is not displayed. This only occurs on Windows.

Customers will see this issue only when they are doing an OFTP Export using resource tags on Windows.		OFTP export from command line (See documentation on "Export Trading Partner Data Using the Command Line"), or OFTP export from UI without resource tags.
Admin UIIssue:
When creating a service name using multi-byte characters, an error is thrown if more than 40 characters are used.

Customers will see this issue if they are using multi-byte characters and attempt to create a service using these mult-byte characters, making that service name more than 40 characters long. This only occurs on DB2 and Oracle databases. Users will see the following or similar errors in the ui.logs:
[2014-08-05 00:35:52.422] ERROR SAVE FAILED:
[2014-08-05 00:35:52.422] ERROR [1407179152422] DB2 SQL error: SQLCODE: -302, SQLSTATE: 22001, SQLERRMC: null
[2014-08-05 00:35:52.422] ERRORDTL [1407179152422]com.ibm.db2.jcc.b.SqlException: DB2 SQL error: SQLCODE: -302, SQLSTATE: 22001, SQLERRMC: null
    at com.ibm.db2.jcc.b.hh.b(hh.java:1369)
    at com.ibm.db2.jcc.b.hh.c(hh.java:1356)
    at com.ibm.db2.jcc.c.db.k(db.java:352)
    at com.ibm.db2.jcc.c.db.a(db.java:60)
    at com.ibm.db2.jcc.c.t.a(t.java:52)
    at com.ibm.db2.jcc.c.tb.b(tb.java:202)
    at com.ibm.db2.jcc.b.ih.ab(ih.java:1898)
    at com.ibm.db2.jcc.b.ih.d(ih.java:2467)
    at com.ibm.db2.jcc.b.ih.d(ih.java:2563)
    at com.ibm.db2.jcc.b.ih.W(ih.java:525)
    at com.ibm.db2.jcc.b.ih.executeUpdate(ih.java:508)
    at com.sterlingcommerce.woodstock.services.SII.save(SII.java:3024)
    at com.sterlingcommerce.woodstock.services.SII.save(SII.java:2907)
    at com.sterlingcommerce.woodstock.ui.ServiceEditor.save(ServiceEditor.java:355)
    at com.sterlingcommerce.woodstock.adminui.servlet.SaveService.run(SaveService.java:112)

[2014-08-07 06:11:29.517] ERROR 000000000000 GLOBAL_SCOPE [SaveService]: Run - got exception
SQL Error Code: 12899
SQL State: 72000
java.sql.SQLException: ORA-12899: value too large for column "STDSTEAM3"."SERVICE_INSTANCE"."SERVICE_NAME" (actual: 243, maximum: 100)

    at oracle.jdbc.driver.SQLStateMapping.newSQLException(SQLStateMapping.java:70)
    at oracle.jdbc.driver.DatabaseError.newSQLException(DatabaseError.java:133)
    at oracle.jdbc.driver.DatabaseError.throwSqlException(DatabaseError.java:206)
    at oracle.jdbc.driver.T4CTTIoer.processError(T4CTTIoer.java:455)
    at oracle.jdbc.driver.T4CTTIoer.processError(T4CTTIoer.java:413)
    at oracle.jdbc.driver.T4C8Oall.receive(T4C8Oall.java:1034)
    at oracle.jdbc.driver.T4CPreparedStatement.doOall8(T4CPreparedStatement.java:194)
    at oracle.jdbc.driver.T4CPreparedStatement.executeForRows(T4CPreparedStatement.java:953)
    at oracle.jdbc.driver.OracleStatement.doExecuteWithTimeout(OracleStatement.java:1222)
    at oracle.jdbc.driver.OraclePreparedStatement.executeInternal(OraclePreparedStatement.java:3387)
    at oracle.jdbc.driver.OraclePreparedStatement.executeUpdate(OraclePreparedStatement.java:3468)
    at oracle.jdbc.driver.OraclePreparedStatementWrapper.executeUpdate(OraclePreparedStatementWrapper.java:1350)
    at com.sterlingcommerce.woodstock.services.SII.save(SII.java:3024)
    at com.sterlingcommerce.woodstock.services.SII.save(SII.java:2907)
    at com.sterlingcommerce.woodstock.ui.ServiceEditor.save(ServiceEditor.java:355)
    at com.sterlingcommerce.woodstock.adminui.servlet.SaveService.run(SaveService.java:112)		Create a smaller service name, 40 multi-byte characters or less, or not using multi-byte characters.
Admin UISummary:
Unwanted event is shown for cancelled order.

Problem description:
H003: FUL having order status "CNCL" shows wrong message "Order data put into the upload mail box <user>/<partner>/inbox for the event EB_0104.		This event should be ignored as the order is not given for further processing.
Admin UISummary:
Filegateway layout issue [Firefox only]

Problem Description:
Some of the dropdowns in the upper pane are not displayed properly. Basically, texts in the dropdown gets overlapped with the background texts and hence they are not displayed clearly.		If you are concerned with this, please use Internet Explorer.
Admin UIIssue:
When searching for services by name, it does not account for language sensitivity.

Customers will see this issue if they are expecting language sensitivity in searching for services by name. For example, if the customer creates a service named "Müller_EnvelopingService", this should be searchable by the keyword "Mueller". However, this returns the following error: "No services satisfy your search criteria. Please try again".		Workarounds include searching by the name used to create the service. In the above example, searching by "Müller" would lead to finding the service.
AS2Summary:
Configuration of SHA-2 Algorithm name value with a hyphen for building outbound AS2 messages is not available from Trading Partner -> Setup -> Advanced.

Problem Description:
Configuration of SHA-2 Algorithm name value with a hyphen for building outbound AS2 messages is not available from Trading Partner -> Setup -> Advanced.
Therefore these profiles cannot be used for building messages with following AS2 header -
Content-Type:multipart/signed; protocol="application/pkcs7-signature"; micalg=SHA-256;		Please configure AS2 Profiles using Trading Partner -> AS2 Screen.
EBICS ClientThe following should be added to release notes related to the deferral of this defect.  Tom Kimble is the contact for additional information.

" As a user of the IBM EBICS client, if you submit continous high volumes of banking transactions via the technical interface it is possible to build up a backlog of business processes waiting in queue for a thread. These waiting processes occupy memory in the noapp JVM, making it possible to exhaust the heap. The “queueWatch” console will allow you to monitor business process queue depth as well as heap utilization.		Heap memory settings can be modified via the “Operations/System/Performance” console from the B2Bi console as needed. If you see a backlog building, consider suspending or throttling technical orders until the backlog diminishes."
EBICS ClientSummary:
HAC response doesn't include full history of changes since last download of the HAC data.

Problem Description:
For HAC order, intermittently, the EBICS Server misses out some of the events that occurred between the previous HAC and the current submission. These events doesnt come in the response xml.		HAC order can be resubmitted in case of missing information.
GPMSummary:
Value for CCC is stored as Yes instead of YES for FTP Client Begin Session Service in GBM.

Problem Description:
From GPM for FTP Client Begin Session Service 'Yes' is stored instead of 'YES' for the ClearControlChannel param: <assign to="ClearControlChannel">Yes</assign>
The BP fails with the Service Configuration Error - Invalid value for parameter. 		Edit the BP from BPML editor and change  'Yes' to 'YES' (<assign to="ClearControlChannel">YES</assign>)
Import/ExportSummary:
OFTP Profiles are not displayed in the Export Report after Export

Problem Description:
1. Create some OFTP profiles like PP, PPC, LP & LPC
2. Export these OFTP resources now
3. Download the Export file
4. Click on the Export report link

Export report is Blank, showing none of the profiles which are exported. When you try Importing using the exported file, the profiles are present in the import report.		None
Index/PurgeSummary:
Schedule_AssociateBPsToDocs may not release the Lock after ending up in error.

Problem Description:
During high load it can happen that Schedule_AssociateBPsToDocs sometime may not release lock when it gets into error condition.		Go to lock manager and release the lock manually.
InstallationSummary:
Xerces and Xalan jars are not getting remediated on HP & Solaris during 525 Media install

Problem Description:
Xerces and Xalan jars are remediated on all support OS versions except for HP & Solaris Media install. The old jars are still being referenced and the jar entries can be found in dynamicclasspath.cfg as well		For HP and Solaris, customers are required to run "updateXercesJars.sh" manually after doing the installation of 525 media. 
InstallationYou will find this note useful, if you have installed SI with db2 AUTHENTICATION type as SERVER. Post SI installation, you have brought up the SI Server and then stopped it. Then change the AUTHENTICATION type to DATA_ENCRYPT. Now start SI again. You will see following exceptions in system log

[2014-10-09 12:22:56.215] ERRORDTL [1412837576215]com.ibm.db2.jcc.am.go: [jcc][t4][201][11237][3.57.82] Connection authorization failure occurred.  Reason: Security mechanism not supported. ERRORCODE=-4214, SQLSTATE=28000		This doesn't have any functionality impact and you can ignore it.
InstallationSummary:
525 Iseries install with JDK 1.6 does not stop the install as it does on other platforms. Also OS version check too is not honored

Problem description:
For ISeries alone, it is observed that the matrix.property check for OS version and supported JDK check is not working. Iseries installation Job will continue to progress in the background without prompting for unsupported OS or JDK. 		No workaround available.
Customer will have to see the system requirements to identify the support OS versions and supported JDKs in 5020500.
InstallationSummary:
AIX Install ends with error (infrequent)
Description:
If you install/patch/update SI and get an installation error indicating a problem with the execution of the ServiceInstallerWrapper.sh script you might be running into this problem.  The exact error encountered will vary depending on a number of details, but will usually be a syntax error like:

<si_install_dir>/bin/ServiceInstallerWrapper.sh[163]:  Syntax error at line 163 :  `{' unmatched
ERROR:  Failed Installation '1'

If you get an error like this, it is very likely the case that your installation was actually successful, just interrupted before we could do some final steps.

The first step is to verify that the error is really a sign of this issue.  We can check this be going to <si_install>/bin, and looking in the directory for .cmd and .cmd.in files.  If there are such files, than we are dealing with this particular installation issue.
At this point we can do the final installation steps to workaround this error.

Step 1:  Cleanup Windows Files
cd <si_install>

Run the following lines:
find . -name \*.cmd -exec rm -f {} \; 2> /dev/null
find . -name \*.cmd.in -exec rm -f {} \; 2> /dev/null
find ./bin -name \*.exe -exec rm -f {} \; 2> /dev/null
find . -name \*.vbs -exec rm -f {} \; 2> /dev/null
find . -name \*.vbs.in -exec rm -f {} \; 2> /dev/null

This will remove the unecessary Windows files.

Step 2: Run deployer
./deployer.sh -t deployall

Step 3:  Check on the DATABASE_PROPERTY_MANAGEMENT in sandbox.cfg
Open the sandbox.cfg file, which is in <SI_INSTALL>/properties
Look for the DATABASE_PROPERTY_MANAGEMENT property (search for DATABASE_PROPERTY_MANAGEMENT)
Note if the property is true or false

If the property is false, we're all set

If the property is true, there is a final step

Step 4:
Go to <SI_INSTALL>/bin
run:  ./deployer.sh -t loadProperties

At this point, your SI installation is complete.
InstallServiceSummary :
After executing 'startCluster.sh' and 'setupContainer.sh', when 'runAll.sh' is executed, occasionally following NullPointerException appears in opsServer.log & ops.log files -

[2014-12-04 02:38:26.637] ERRORDTL [1417678706637]java.lang.NullPointerException
        at com.sterlingcommerce.woodstock.ops.server.OpsNodeHeartbeatThread.doWork(OpsNodeHeartbeatThread.java:256)
        at com.sterlingcommerce.woodstock.ops.server.OpsNodeHeartbeatThread.run(OpsNodeHeartbeatThread.java:157)
        at java.lang.Thread.run(Thread.java:781)

Problem description :
This is a timing issue. This NullPointerException happens only once when runAll.sh is run for first time and the Servers are still coming up. This exception is not seen subsequently when B2Bi continues to run or during any subsequent restarts done after doing a hardstop.sh. This has no side effect and can be ignored. In case, you want to validate if the servers have come up properly, you can look for the string 'web server joined in' in noapp.log file.

Please note this may potentially shore up again if you do a full cluster start with "run.sh -restart"

However, if you notice this NullPointerException is coming repeatedly, you can do a hardstop.sh and restart the system and see if the system has stabilized. If NullPointerException continues to appear repeatedly, please contact the IBM Support		Do a hardstop.sh, startCluster.sh, and run.sh and  bring up the container separately startcontainer.sh 1/2
MailboxSummary
If you edit a user's permissions, you may find that the permission change does not seem to work immediately.  For example, if you add permission to access "/ Mailbox" to a user, the user may not be able to access mailboxes through FTP right away.  The reason for this is that the old permissions may be cached.  A simple way to test if this is the problem is to stop and start SI - if the permissions take effect after the restart, then the cache is a likely culprit.		Since restarting the system is not a viable workaround, a better option may be to clear out the SI caches.  This can be done with the following ops command:
./bin/opscmd.sh -cCLEARCACHE (execute this from the SI install directory)

Map EditorObserved behavior -
For XML file format maps, in the XML File Properties - if the "Settings" tab is selected/activated and nothing is changed for that tab an invalid value is written to the .mxl when saved. When the .mxl source file is reopened an error results -

"enumeration constraint failed.
The element: '{http: //www.stercomm.com/SI/Map}TrimPCData' has an invalid value according to its data type."		1) Actively select or reselect the current desired value when opening the "Settings" tab.

2) Edit the source .mxl file and update the value found in the <TrimPCData> tag - change it to 0, 1 or 2. Reopen the .mxl file.

This issue has not been observed when the file is saved as a .map file.
MESA StudioSummary:
"Install 3rd Part files" Control Actions fails to run Deployer when used with Mesa Studio.

Problem Description:
If you try to install third party files using Mesa Studio then it fails		You can still install third party files using command prompt via install3rdParty.cmd/sh
PerformanceAs a user of the IBM EBICS Server, if you receive continuous high volumes of banking transactions , it builds up excess load on server which can cause failure of orders as they timeout.If you see such failures on server side , which can be identified by finding presence of .ERR files on server inbox, client needs to be informed by server admin and request to resend such orders.
PerformanceSummary :
Doc tracking properties not being passed when calling SPE.
Problem Description : You cannot disable document tracking at the BP level when calling SPE.  This BP setting is not being processed by SPE.  You can still disable document tracking when calling SPE but only globally. 		This can be done by setting the SPE.correlation-tracking property in the SPE.properties in the SBI properties folder.
Property FilesFilegateway profiles configured to send notification emails in certain problematic languages will fail to send some notifications. The problematic languages (or locales) are Traditional Chinese (zh_TW), Simplified Chinese (zh_CN), Japanese (jp_JP), and Korean (ko_KO).

The following locale/event code combinations are known to fail to generate notification email:
Locale  Event Code
zh_TW   FG_0425, FG_0455, FG_0550
jp_JP   FG_0425, FG_0455, FG_0550, FG_0408, FG_0415, FG_0419, FG_0411
zh_CN   FG_0425, FG_0455, FG_0550, FG_0408
ko_KO   FG_0425, FG_0455, FG_0550, FG_0408, FG_0415

If the notification fails to send due to this issue, the FileGatewayEventEmailNotification business process (BP) corresponding to the notification being sent will be displayed in the Business Process Monitor as "Halted". Furthermore, the status of this "Halted" BP will say "Mail Mime Service fails to execute ...", followed by "com.sterlingcommerce.woodstock.workflow.WorkFlowException: Failed to write the message into the Document OutputStream."

The FileGatewayEventEmailNotification BPs can be found by
1. Navigating to
    Business Processes->Monitor->Advanced Search->Business Processes
2. Selecting this BP under section "Search Using Business Process Name", subsection "System Business Processes"
3. Search for this BP by clicking the appropriate "Go!" button		If email notifications are required and are failing in one of the aforementioned locales, the locale must be changed.

Filegateway profile locales can be changed by selecting the "Profile" button in the top bar of the filegateway UI, then by selecting a language from the "Language for notifications:" dropdown menu.
Route VisibilitySummary:
On clicking the template name in file route activity, instead of displaying the template we get error message:
"The instance of the template you are trying to view is no longer available".

Problem Description:
Steps to reproduce -
1) login to filegateway.
2) create community, partners and group.
3) create routing channel template.
4) create channel using template and partners.
5) using myFG upload file to transfer between producer to consumer.
6) In filegateway, check for the route activities. In the route tab click on the template name

Expected: template details should be displayed.
Observed: pop up error message is observed.

There is no data corruption or loss of data or no impact on any transaction processing. The impact is really around a broken link in the visibility tab on the right side of filegateway screen. And second, even for that we have a work around to go, search view the routing template info.		To see the template detail, user can go to routing channel template screen and view the routing channel template details.
SchedulingSummary:
Scheduled month of the day cleared for schedules in Japanese UI

Problem Description:
Steps to reproduce :
>Select preferred language as Japanese for the user
>login with that user
>Schedule a BP to run based on the month
>set time intervals 10:00 on 1 , 2 and 3 rd day of the month
>Add date exclusions JAN 1,2,3 and select any bp
>Save the schedule.
>The confirm screen does not show the schedule data appropriately.
>Click edit and the schedule option is selected as run daily.
>Also when you edit and select day of the month again only time is shown and day of the month is not.

Expected : The schedule settings chosen by the user must be retained.
Actual : The schedule settings chosen by the user are not retained.

This is only a display issue and there is no impact on the functionality as such.		To work around this issue, change the locale of the SI account used to view this tree view to something other than the aforementioned problematic locales. This can be done by navigating to 'Accounts'->'My Account', and then selecting a different language from the 'Preferred Language:' dropdown menu.




Security/EncryptionSummary:
Misleading error message seen when importing PKCS12 keys (in pfx extension)

Problem Description:
When checking in a system certificate in PKCS12 format with pfx extension, B2B Integrator shows the following error message:
Invalid password is entered, please try again.
This is cause by exception thrown when parsing the private key inside the import file. The error message is misleading.		To find out the true error, please look into system.log and search for following string:
Unexpected tag found: Unrecognized tag [13]  != Sequence
Service and AdapterSummary :
The services tree view does not properly display text in certain locales when the backing database is Microsoft SQL Server. The problematic locales are Traditional Chinese, Simplified Chinese, Japanese, and Korean. Instead of locale-specific text, nearly all text in the tree view is displayed as question marks.

Problem description :
The services tree view can be brought up by following these steps:
1. Navigate to 'Deployment'->'Services'->'Configuration'
2. Click the "Go" button in the New Service section
3. Click the Tree View button (a small, grey button to the upper right of the "Service Type" text input box)		To work around this issue, change the locale of the SI account used to view this tree view to something other than the aforementioned problematic locales. This can be done by navigating to 'Accounts'->'My Account', and then selecting a different language from the 'Preferred Language:' dropdown menu.

StandardsSummary
When scheduling a business process (BP) to run for a time interval in certain non-English languages via the BP scheduling wizard, a faulty error message may prevent the user from proceeding past the "Schedule Settings" step.

The BP scheduling wizard can be found by navigating to 'Deployment'->'Schedules' under the Administration Menu, and then by clicking "Go!" next to "Schedule a Business Process".

Detailed Description
More precisely, this issue issue occurs under the following conditions:
    -The user account is in German, Japanese, Korean, or Traditional Chinese
    -In the "Schedule Type" BP scheduling wizard step (the first step), the user is scheduling a BP to "Run daily", "Run based on day(s) of the week", or "Run based on day(s) of the month"
    -In the "Schedule Settings" BP scheduling step (the second step), the user has ticked checkbox "Check here to select time interval"
    -In the "Schedule Settings" BP scheduling step, the user has added at least one entry to the "Scheduled Time" box by selecting "Hour(s)", "Min(s)", or both, and then by adding this option to the "Scheduled Time" box by clicking the "add" button
    -In the "Schedule Settings" BP scheduling step, the user has clicked "Next"

The user knows they have encountered the error when the above conditions have been satisfied, and when they see the error "Time interval must be supplied for the time range:", which prevents the user from proceeding from the second to the third step.		To work around the issue, create the BP schedule in a language that is not German, Japanese, Korean, or Traditional Chinese. The current user's language can be changed by navigating to 'Accounts'->'My Account' in the Administration Menu, and then selecting a language under "Preferred Language:".
Trading Partner ProfilesSummary:
CA Certificate Groups does not work when editing an existing CA certificate from a new certificate file.

Problem Description:
When editing an existing CA certificate (which is part of a CA Group) using the "Update from existing Certificate file" option, existing Certificate Groups are seen as unselected in the "Naming" UI page whereas in actual existing CA Groups association is kept intact.
Another issue is that, while editing a CA Certificate, new CA Groups gets created but doesn't get associated with the certificate being edited.		Any certificate group addition or update has to be done using the "Only Certificate Name" edit option.
Trading Partner ProfilesSummary:
manageOrganizationHierarchy XAPI fails for operation 'manage'

Problem Description:
Customer attempting to create trading partner ftp profile using XAPI.
But gets error code YCP0434 returned. This error states that the Primary Enterprise Key is not found. This is true, as we are trying to create a
new one. The description against operation = 'Manage' states that it will create a new record if it doesn't exist.
Tried sending it without a primary enterprise key and get error 10364 (Manadtory parameters for the operation are missing).                                            
It seems therefore that manage does not create as the required fields are mandatory. Thus the XAPI doc (<SI_INSTALL>/xapidocs) for manageOrganizationHierarchy should be updated
From:
Manage: "Creates a new record if it does not exists or modifies if record exists".
To:
Manage:  Manages the existing record.		The xapi documentation for 'manageOrganizationHierarchy' should be read as 'Manages the existing record.'
User InterfaceIssue:
When using DB2 as the DB, in the "Operator" pane the database usage portlet does not appear. The portlet appears for all other DB types.

Symptoms:
The DB usage graph by default does not appear in the "Operator" pane.		The DB2 usage graph can be configured to appear on the "Operator" pane by using the "Manage Layout" link at the top of the "Operator" pane
The DB2 usage graph can also be displayed in the admin console by navigating to:
    Operations > System > Troubleshooter > Database Usage
User InterfaceSummary:
SI in https mode launches SPE UI in http mode.

Problem description:
If the user logs into the B2Bi UI via HTTPS and selects the link to go to SPE UI, the login fails. The user needs to edit the URL manually to remove the "s" and then it works.		When setting up SI admin console to run on HTTPS, one should also change the property SPE.URL in SPE.properties.in file then run setupfiles script:
from
SPE.URL=http://&HOST_ADDR;:&SPE_UI_PORT;/spe/myspe
to
SPE.URL=https://&HOST_ADDR;:&SPE_UI_PORT;/spe/myspe
User InterfaceIf a large map is provided to a BP as a dynamic map, the user may be logged out of the B2Bi user interface. It is recommended that large maps should never be loaded as a dynamic map. Large maps should always be stored in the map repository, or on the filesystem.

[{"Product":{"code":"SS3JSW","label":"IBM Sterling B2B Integrator"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Documentation","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.2.5","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
11 February 2020

UID

swg27044466

Page Feedback