IBM E02HRLL-G Administration Guide
IBM E02HRLL-G - WebSphere Partner Gateway Express Manual
 |
View all IBM E02HRLL-G manuals
Add to My Manuals
Save this manual to your list of manuals |
IBM E02HRLL-G manual content summary:
- IBM E02HRLL-G | Administration Guide - Page 1
WebSphere® IBM WebSphere Partner Gateway Enterprise and Advanced Editions Version 6.2 Administration Guide - IBM E02HRLL-G | Administration Guide - Page 2
it supports, read the information in "Notices" on page 253. April 2010 This edition applies to version 6.2, release 0, modification 0 of IBM until otherwise indicated in new editions. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any - IBM E02HRLL-G | Administration Guide - Page 3
Community Console . . . 16 Community Console icons 16 Logging off from the Community Console . . . . 18 Chapter XML formats 24 © Copyright IBM Corp. 2007, 2008 Large file support 25 Enabling or disabling actions . . . 32 Configuring the alert mail server 33 Viewing system activity 33 Managing - IBM E02HRLL-G | Administration Guide - Page 4
when creating your own import data 69 Manual validation of the import file . . 7. LDAP support for logon IBM Tivoli Directory Server . 77 Specifying LDAP users to use the WebSphere Partner Gateway Console 79 Chapter 8. Support IBM WebSphere Partner Gateway Enterprise and Advanced Editions: - IBM E02HRLL-G | Administration Guide - Page 5
examples. . . . . 154 Chapter 17. Troubleshooting . . . . . 157 Avoiding long 0964C Transaction log full error on the BCGMAS database 162 IBM service log unreadable 163 logs error messages 174 DB password required error in bcgHubInstall.log 175 Using revocation check and using CRL DP support - IBM E02HRLL-G | Administration Guide - Page 6
SystemOut.log . . . . . 178 Reporting file size for documents greater than 2 GB 178 Workflow Handler Runtime Error 184 Error while invoking WebSphere Transformation Extender Map IBM Support Assistant (ISA) Plugin . . . . . Partner Migration Utility service marks 255 Index 257 vi IBM - IBM E02HRLL-G | Administration Guide - Page 7
the business-to-business (B2B) trading community. This guide assumes that you have already performed the necessary hub partner. v Internal Partner: is the primary company and driving force within the hub community. Internal partner is responsible for the purchase © Copyright IBM Corp. 2007, 2008 1 - IBM E02HRLL-G | Administration Guide - Page 8
where the product is installed. All IBM WebSphere Partner Gateway product path names are relative to the directory where the IBM WebSphere Partner Gateway product is installed on to go to the object of the reference. 2 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 9
them from one another. For example, tmp.log. / or \ Backslashes (\) are used as separators in directory http://www.ibm.com/software/integration/wspartnergateway/library/ Note: Refer to Technical Support Technotes and Flashes in WebSphere Partner Gateway Support Web - IBM E02HRLL-G | Administration Guide - Page 10
cell v Support for Secure File Transfer Protocol (SFTP) v CPP/CPA Editor for ebXML Message Service (ebMS) v Enhancements - Improved archiver performance - Improved document throughput performance for AS2 and large files For more details about the new 6.2 features, see http://www-01.ibm.com/ software - IBM E02HRLL-G | Administration Guide - Page 11
chosen during product installation. Note: See the WebSphere Partner Gateway Installation Guide for details on simple and distributed topologies. The administrator managing WebSphere Partner bin/bcgStartServer.sh v Windows(R) \bin\bcgStartServer.bat © Copyright IBM Corp. 2007, 2008 5 - IBM E02HRLL-G | Administration Guide - Page 12
nodes in the system. v The default messaging support of WebSphere Application Server is used, so bcgmas by WebSphere Partner Gateway for its internal messaging support. v Each node that hosts WebSphere Partner Gateway 6 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 13
not available then the WebSphere Partner Gateway components can be manually started or stopped from the command line, but other Manager>:55090/ibm/console to open the WebSphere Integrated Solutions Console Welcome login screen, and log in. Note: A user id is not required for logging in. - IBM E02HRLL-G | Administration Guide - Page 14
distributed mode system can be manually started and stopped on the individual computers. General administration tasks, for example changing log/trace settings, cannot be performed Dir/ftpserver/bin. This script does not 8 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 15
require any command line arguments. The Integrated FTP Server is stopped implicitly when the FTP Management server stops. Note: This is applicable for all deployment modes. Starting and stopping the components in a simple distributed mode system There are two clusters in a simple distributed mode - IBM E02HRLL-G | Administration Guide - Page 16
is unavailable for use, you can Start the messaging bcgmas and the bcgserver servers manually with the following steps: 1. Confirm that the node agents are running for each node computer where the server is installed. 10 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 17
The syntax is for stopping the messaging server or bcgserver for the component servers is: stopServer Where server_name is bcgmas for stopping the messaging server, and bcgserver for the component servers. Starting and stopping the components in a full distributed mode system Before - IBM E02HRLL-G | Administration Guide - Page 18
receiver (or console) servers. Note: The receiver and console servers can be stopped in either order. 3. WebSphere Partner Gateway document manager servers. 4. Messaging servers. 12 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 19
Stopping all the servers using the Deployment Manager About this task 1. Select the bcgconsoleCluster (or bcgreceiverCluster) and click Stop. 2. Select the bcgreceiverCluster (or bcgconsoleCluster) and click Stop. 3. Select the bcgdocmgrCluster and click Stop. Note: Wait until the cluster has - IBM E02HRLL-G | Administration Guide - Page 20
14 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 21
Mozilla version 1.7.8 or later. v Firefox version 1.5 or later. Be sure to install the latest available service pack and updates for your browser. Note: The Community Console requires cookie support to be turned on to maintain session information. No personal information is stored in the cookie and - IBM E02HRLL-G | Administration Guide - Page 22
6. The first time you log in, the system prompts you to session. The application continues to run on the server. To log in again, follow the procedure under " Logging in to the Community Console" on page 15. v Help Opens Edit off 16 IBM WebSphere Partner Gateway Enterprise and Advanced Editions - IBM E02HRLL-G | Administration Guide - Page 23
View details View group memberships View Help system Note: The Help icon is translated when using the console with one of the IBM supported language locales. View permissions View the Document Definition attribute setup View users View validation errors Chapter 3. Basic Community Console tasks 17 - IBM E02HRLL-G | Administration Guide - Page 24
Logging off from the Community Console When you finish using the Community Console, click Logout at the top-right side of any Console window. The system logs you out and returns you to the Console Login window. 18 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 25
on page 27 v "Managing EDI" on page 28 v "Configuring the alert mail server" on page 33 v "Viewing system activity" on page 33 v "Managing 34 v "Supporting ebMS" on page 36 v "Configuration details for validating Webservices" on page 38 v "Using non-repudiation logging" on page IBM Corp. 2007, 2008 19 - IBM E02HRLL-G | Administration Guide - Page 26
supported by the system are as follows v Name Variation Checking, when selected, prevents the use of passwords that comprise an easily guessed event codes An event is logged for important activities or information within IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 27
that enable the operation to continue. Error Anomalies in document processing that cause the process to end. Critical Services that end because of a system failure. Critical events require intervention by support personnel. Select to display the Event Name in the list on the Define tab of the Alert - IBM E02HRLL-G | Administration Guide - Page 28
events that can be notified About this task An event is logged for important activities or information within WebSphere Partner Gateway. There are List window, click the View Details icon to view the receiver details. 22 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 29
3. Click Edit icon to edit the receiver parameters. 4. In the Status field, select either Enabled or Disabled option to change the receiver status. Deleting receivers About this task You can delete receivers that you are not going to use. Note that the deletion occurs immediately. There is no - IBM E02HRLL-G | Administration Guide - Page 30
any of the channels. 6. Click OK to delete the interaction along with its corresponding channels. To find message window. This will delete the corresponding channels, interactions, B2B capabilities of all the partners IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 31
creating XML document families and formats, see the WebSphere Partner Gateway Hub Configuration Guide. Large file support WebSphere Partner Gateway can use XPath version 1.0 expressions in formats. The processing power of XPath support limits the size of files that can be used with full XPath XML - IBM E02HRLL-G | Administration Guide - Page 32
support comma-separated content-type values. For these handlers, the text/plain content-type has to be added manually . Note: Do not change the handler values unless advised to do so by an IBM representative. Perform 26 IBM WebSphere Partner Gateway Enterprise and Advanced - IBM E02HRLL-G | Administration Guide - Page 33
Managing maps This section describes how to manage the different types of maps available for use with WebSphere Partner Gateway. Updating validation maps About this task Use this procedure to update a validation map currently in the system: 1. Click Hub Admin > Hub Configuration > Maps > Validation - IBM E02HRLL-G | Administration Guide - Page 34
system. See the WebSphere Partner Gateway Hub Configuration Guide for details on creating a new transformation map. See the WebSphere Partner Gateway Hub Configuration Guide for descriptions of each Envelope Profile Attribute Partner Gateway Hub Configuration Guide for attribute descriptions. - IBM E02HRLL-G | Administration Guide - Page 35
) are automatically displayed. 5. Update the envelope profile attribute values, and click Save. See WebSphere Partner Gateway Hub Configuration Guide for attribute descriptions. Deleting envelope profile records About this task 1. Click Hub Admin > Hub Configuration > EDI > Envelope Profile - IBM E02HRLL-G | Administration Guide - Page 36
in the Connection Profiles List. See the WebSphere Partner Gateway Hub Configuration Guide for more information about Connection Profiles. Editing connection profiles About this task , and optionally, EDI capability. 30 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 37
only an asterisk (*) as the search string returns a list of all EDI-capable partners. See the WebSphere Partner Gateway Hub Configuration Guide for more information about control numbers and control number masks. 1. Click Hub Admin > Hub Configuration > EDI > Control Number Initialization. 2. Type - IBM E02HRLL-G | Administration Guide - Page 38
data About this task To access the system configuration data perform the following steps: 1. Log in as hubadmin. 2. Click System Administration from the menu tabs. Note: Use to the database or Cancel to discard them. 32 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 39
data is changed only by experienced systems or support engineers. If you do change this data, it becomes necessary. Configuring the alert mail server Alerts are text-based e-mail messages notifying partners of a system data about system activity. This summary-service data is the information you see - IBM E02HRLL-G | Administration Guide - Page 40
change the values for the JMS properties. See the WebSphere Partner Gateway Hub Configuration Guide for the property descriptions. 3. Click Save. Managing API calls About this task with the migration utility. With the 34 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 41
administrative API, you can list some of the configuration artifacts in a system. A full export of the system using the migration utility provides listings of partner capabilities, partner connections, and receivers (targets) in the exported XML file. Managing Document Manager information You can - IBM E02HRLL-G | Administration Guide - Page 42
Supporting ebMS WebSphere Partner Gateway supports ebXML Message Service provided, the product can be configured manually. There are two ways to certificates, you must manually upload any certificates in supporting ebMS: v Ping v Status Request 36 IBM WebSphere Partner Gateway Enterprise and - IBM E02HRLL-G | Administration Guide - Page 43
v Error During runtime when processing an ebMS document from a Partner, WebSphere Partner Gateway validates that the ebMS interaction conforms to the ebMS configuration (for example if encryption is required) and if there is a non conformance the document is failed. The specific failure events can - IBM E02HRLL-G | Administration Guide - Page 44
supported are as follows: v DSA-SHA1 v RSA-SHA1 If the signing fails because of a configuration issue, an event is logged is logged are two supported protocols for 3-des-cbc 2. aes-128-cbc 3. aes-192-cbc 4. aes-256-cbc If you cbc 2. aes-128-cbc. 3. aes-192-cbc 4. aes-256-cbc Configuration Guide for - IBM E02HRLL-G | Administration Guide - Page 45
channel. See Configuring document types chapter of WebSphere Partner Gateway Hub Configuration Guide for associating validation map to channel. . By default, Content Validation is enabled. Using non-repudiation logging About this task WebSphere Partner Gateway increases the configuration options for - IBM E02HRLL-G | Administration Guide - Page 46
Required attribute to No. See the WebSphere Partner Gateway Hub Configuration Guide for more information about setting the message store attributes at the package .mapLocation, which is under system administration tab 40 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 47
system. See the WebSphere Partner Gateway Hub Configuration Guide for information about creating partner profiles. Note: proceed or click Cancel to retain the passwords. Resetting the password forces all users for that partner to enter a new password at the © Copyright IBM Corp. 2007, 2008 41 - IBM E02HRLL-G | Administration Guide - Page 48
WebSphere Partner Gateway Hub Configuration Guide. Required information for destination X X X O File Directory transport X O X X X O JMS transport O O X X X O X X O O X X X O SMTP transport O O X O X X X O 42 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 49
first time, the destination is put offline and the document and subsequent documents are queued for delivery later. The destination has to be put online manually. If auto-queue is disabled, and if the document delivery fails, retries are done. The destination is not put offline. When this option is - IBM E02HRLL-G | Administration Guide - Page 50
use to generate connection to the JMS queue. Factory name used to connect to the name service. Class of message. Type of JMS message. Queue name where JMS messages are stored. access through the partner firewall. 44 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 51
where all the selected destination is being used is displayed. Note: This screen is provided with paging info as there could be many channels using the destination. Every page will hold a maximum of 10 connections. Deleting destination About this task This delete destination feature is available for - IBM E02HRLL-G | Administration Guide - Page 52
retries. The intent is to specify sufficient time for the user to correct the problem that is preventing delivery. For example, the destination Web server might be down, or are specified, the system retry pattern is: 46 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 53
v First attempt fails v Destination retry 1 fails Transport retry 1 fails Transport retry 2 fails Transport retry 3 fails v Destination retry 2 fails Transport retry 1 fails Transport retry 2 fails Transport retry 3 fails v Destination retry 3 fails Transport retry 1 fails Transport retry 2 fails - IBM E02HRLL-G | Administration Guide - Page 54
document has not been sent, the document is moved to the Gateway failed directory. For the previous scenario, the following overall time intervals occur: 48 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 55
you can select to use a different Forward proxy server. See the WebSphere Partner Gateway Hub Configuration Guide for more information about Forward proxy support. Managing certificates A digital certificate is an online identification credential, similar to a driver's license or passport. A digital - IBM E02HRLL-G | Administration Guide - Page 56
information about loading the certificates, see the WebSphere Partner Gateway Hub Configuration Guide. The Certificate Management view allows you to modify certificate sets that are . Steps to manage Certificates sets: 50 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 57
1. In the Console, navigate to Profile > {Partner} > Certificate > Certificate Management 2. If you have logged in as a Hub Operator, then choose an internal partner and external partner. Make sure that both the values are not ″ALL″. 3. Click Search to filter - IBM E02HRLL-G | Administration Guide - Page 58
To enable the use of CRLDP, set the com.ibm.security.enableCRLDP Java Virtual Machine property in the Generic JVM Properties field to true as follows: -D-com.ibm.security.enableCRLDP=true To disable the use of CRL DP, set the com.ibm.security.enableCRLDP Java Virtual Machine property in the Generic - IBM E02HRLL-G | Administration Guide - Page 59
2. Click the View details icon next to a certificate. The Console displays the Viewing Certificate Details window. 3. Click the Edit icon to edit the digital certificate. 4. Update the following parameters in the window, then click Save. Table 6. Digital Certificate Parameters Parameter - IBM E02HRLL-G | Administration Guide - Page 60
one system. This improves connection efficiency by multiplying the use of a single connection for production, test, or routing to multiple systems within one organization. 54 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 61
Connection duplication The system avoids inadvertent duplication of connections by uniquely identifying each connection based on the following parameters: v Source Partner v Source package and version v Source protocol and version v Source document type and version v Source Activity (if defined) v - IBM E02HRLL-G | Administration Guide - Page 62
procedure to conduct an advanced search for connections. When selecting a Source and a Target, observe the following guidelines: v The Source and Target must be unique. 56 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 63
v Do not mix a production destination with a test destination when selecting Source and Target; otherwise, an error occurs. Both the Source and the Target must be production or test destinations. 1. Click Account Admin > Connections > Partner Connections. The Console displays the Manage Connections - IBM E02HRLL-G | Administration Guide - Page 64
about Connection Profiles, see the WebSphere Partner Gateway Hub Configuration Guide. Managing exclusion lists An exclusion list lets the hub administrator for routing restriction: v 0A1 - Notification of Failure 58 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 65
Sent to the internal partner by a partner that cannot complete a particular document type. v Backend Event A system-generated XML file sent to notify the internal partner that the partner has received a business document successfully. Adding partners to the exclusion list About this task Use the - IBM E02HRLL-G | Administration Guide - Page 66
60 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 67
the migration utility. See the WebSphere Partner Gateway Programming Guide for more information about using the API. The migration by the hub installer in this directory: hub installation/console/support. Using the migration utility from the command line About this Copyright IBM Corp. 2007, 2008 61 - IBM E02HRLL-G | Administration Guide - Page 68
files to the directory c:\IBM\migration, then you should set MIGRATION_PATH to c:\IBM\migration\bcgmigrate. Note: manually) v Fixed workflow definitions (metadata only, user-written executable code jar files are transferred manually all of the supported configuration data types from a system. The options - IBM E02HRLL-G | Administration Guide - Page 69
the file directory used by the receiver in its file system. Be sure to delete any such directories before importing. 5. The migration utility has to log on to the console that you are using. The WebSphere Partner Gateway user account must have permission to export or import configurations. The hub - IBM E02HRLL-G | Administration Guide - Page 70
is omitted, only errors are logged. v -r is the root path where exported data is stored and the log file is written. The host name provided in -h option>.zip. Logs are written to the file BCGMigration.log. If the -r option is not specified for \output -d 5 64 IBM WebSphere Partner Gateway Enterprise - IBM E02HRLL-G | Administration Guide - Page 71
a UNIX system, the invocation is similar, except you use bcgmigrate.sh instead of bcgmigrate.bat. Once the import is completed, the logs are written to the file BCGMigration.log. If the -r option is not specified for an import, then the output will be placed in the directory configured in -f option - IBM E02HRLL-G | Administration Guide - Page 72
by CapabilityInfo. There is an edit attribute icon that takes the attributes. These attributes are also part of CapabilityInfo in the form of ROAttrValueInfo. 66 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 73
exists. The connections that are not even activated once are not actual connections. ProxyConfigInfo Account Admin > Destinations > Forward Proxy Support. Each row in the list page is represented by ProxyConfigInfo. EventCodeInfo Hub Admin > Hub Configuration > Event Codes. AlertInfo Account - IBM E02HRLL-G | Administration Guide - Page 74
or None s. Event Codes - All or None t. Alert Notifications - All alert notifications or selected alert notifications or None. u. System admin properties - All or None 68 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 75
about the content of the file that are not controlled by the schema. Manual validation of the import file If you invoke your migration utility from the command ID must contain numeric characters only. Remember: It is important to manually validate all of your data before you enter it from the command - IBM E02HRLL-G | Administration Guide - Page 76
workflow (actions) Handlers v Contacts Partners v Addresses Partners v Control number initialization Partners v XML families and format Routing objects v Destinations Transport types, destination types, and handlers 70 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 77
v Transformation maps Routing objects v User configuration Partners and Group configuration v FTP User Configuration User configuration, Group configuration, and Partners v Group configuration Partners v Certificates Partners, Certificate sets, Destination types, and Routing objects Complex - IBM E02HRLL-G | Administration Guide - Page 78
Capabilities 29. Connections 30. Gateways 31. Certificates 32. User configuration 33. FTP users 34. Error flow configuration 35. Archiver configuration 36. System Admin properties 72 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 79
system. It does not exist on the test system. v Reports and logs are not migrated. They are not configuration items. v Also, EDI Map following reasons: - The exported file is edited manually and the required information is removed. - The manually created import file does not have all the required - IBM E02HRLL-G | Administration Guide - Page 80
74 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 81
WebSphere Application Server supports 3 types of authentication authenticated against the LDAP server when logging into WebSphere Partner Gateway. Note: When wpg.policy) for the Java Runtime Environment (JRE) granting the necessary security permissions. To add this file into IBM Corp. 2007, 2008 75 - IBM E02HRLL-G | Administration Guide - Page 82
for UNIX users: 1. UNIX users who use DB2 must log in as the db2instance user and use the db2instance username and password run the script. 2. UNIX users who use Oracle must log in as the oracle user and use the username and to False. 76 IBM WebSphere Partner Gateway Enterprise and Advanced Editions - IBM E02HRLL-G | Administration Guide - Page 83
in the LDAP server. 1. Install the IBM Tivoli Directory server. Follow the instructions in the installation guide that comes with IBM Tivoli Directory server. Installation Tips: v The server from the list. 7. Logoff the console administration ID. Chapter 7. LDAP support for logon authentication 77 - IBM E02HRLL-G | Administration Guide - Page 84
(for example, o=ibm, c=us). 10 settings: Relative DN='o=ibm' Reqd attributes= o='ibm' Parent DN= 'c= 'o=ibm,c=us'. For example, to add user 'cn=user1,o=ibm,c=us (for example, cn=user1,o=ibm,c=us) b. Type of LDAP ) e. Base Distinguished Name: o=ibm,c=us f. Bind distinguished name ( IBM WebSphere - IBM E02HRLL-G | Administration Guide - Page 85
-password Now the user can login using any username created in the IBM Tivoli Directory server. Specifying LDAP users to use the WebSphere Partner Gateway Console About include only selected users to be a member of Hubuser role. Chapter 7. LDAP support for logon authentication 79 - IBM E02HRLL-G | Administration Guide - Page 86
80 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 87
over the current IPv4 protocol. IPv6 features support for 128 bit address as opposed to the 32 bit address supported by IPv4. Except the change in at http://www.microsoft.com/windowsserver2003/techinfo/overview/ ipv6faq.mspx. If you are operating on a IPv6 supported Windows platform consult your - IBM E02HRLL-G | Administration Guide - Page 88
Virtual Machine parameter for runtime support in the WebSphere Application Server console. To change the Java Virtual Machine parameter: 1. Log in to the WebSphere Application minutes. 5. Restart all of the servers. 82 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 89
the IPv6 address of the workstation must be configured. To configure the workstation address: 1. Log in to the WebSphere Gateway Console. 2. Go to System Administration > DocMgr Administration > Delivery exists, leave the property bcg.receiver.ipv6 blank. 8. Click Save. Chapter 8. Support for IPv6 83 - IBM E02HRLL-G | Administration Guide - Page 90
84 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 91
extended amount of time (30 seconds or more). You can also view document details to troubleshoot documents from the queue. Note: If you are implementing an FTP Scripting Destination with an > Destination Queue. The Console displays the Destination Queue window. © Copyright IBM Corp. 2007, 2008 85 - IBM E02HRLL-G | Administration Guide - Page 92
documents About this task To view documents queued for a specific Partner: 1. Click Viewers > Destination Queue. 2. From the Destination Queue Search window, click Documents Search. 86 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 93
3. From the Queue Documents Search window, specify the search criteria (see Table 12). Table 12. Queue Documents Search window Criteria Description Partner Name To complete this field you can: 1. Specify the Partner name in the field. 2. Specify part of the partner name in this field and click - IBM E02HRLL-G | Administration Guide - Page 94
and a list of queued documents appear. 5. Click Online in Destination Info to place a destination offline, or click Offline to place destination online. (You must be logged in as hubadmin to change destination status.) 88 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 95
Protocol v Document type v Process version The Document Volume Report helps manage, track, and troubleshoot the flow of your business documents by locating and viewing the failed documents and investigating the and investigate the reason for the failures. © Copyright IBM Corp. 2007, 2008 89 - IBM E02HRLL-G | Administration Guide - Page 96
Test, CPS Partner, or CPS Manager. Test is only available on systems that support the test Operation Mode. Describes document format, packaging, encryption, and content-type refreshed (used by internal partner only). 90 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 97
report also includes a Document Event Summary. Document Volume Report The Document Volume Report is a valuable tool used to manage, track, and troubleshoot the flow of your business documents. The report displays the volume of documents processed by the system within a specific time period. This - IBM E02HRLL-G | Administration Guide - Page 98
type. Production or test. Test only available on systems that support the test Operation Mode. Describes document format, packaging, encryption, example, the request is similar to entering the Yahoo Web address (www.yahoo.com) into your browser address field. Nothing is sent; it is an empty request - IBM E02HRLL-G | Administration Guide - Page 99
to be defined with the partner involved. For details, see the section for pinging ebMS partners in the WebSphere Partner Gateway Hub Configuration Guide. To ping an ebMS partner, complete the following steps: 1. Click Tools > Test Partner Connection. 2. For Command, select PING ebMS. 3. Select From - IBM E02HRLL-G | Administration Guide - Page 100
provide a valid user name or password. v 402 - Payment Required This code is not currently supported, but is reserved for future use. v 403 - Forbidden The server understood the request but turned off. v 404 - Not Found 94 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 101
not to be indexed by search engines) - Users guessing file names - Bad links from your site or other rejected by the server or were insufficient to grant authorization to access the resource. v 412 fix this error; the server administrator checks the error log for the server to see what happened. This - IBM E02HRLL-G | Administration Guide - Page 102
does not support the functionality required to fulfill the request. Application method (either GET or POST) is not implemented. v 502 - Bad Destination The server received an unusable response from the destination or upstream server it accessed in attempting to fulfill the request. v 503 - Service - IBM E02HRLL-G | Administration Guide - Page 103
Table 18. EDI FA Overdue Search Criteria (continued) Value Description Sort By Results Per Page Specifies the criteria for sorting the search results. The defaults are Overtime Due and Descend. Use Descend to display the most overdue FAs first. Select Ascend to display the least overdue FAs - IBM E02HRLL-G | Administration Guide - Page 104
the transaction. The group number of the transaction. The identifying number of the transaction. The status code of FA. The status text of FA. 98 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 105
Description The login userid for this connection. If this is blank, it means that the user has only established a connection but has not logged in. The time when the user logged in. If this is blank, it means that the user has only established a connection. Chapter 10. Analyzing document flows 99 - IBM E02HRLL-G | Administration Guide - Page 106
Time Client Address The time when the user last accessed this connection. If this is blank, it means that the user has only logged in and not issued any command yet. The client IP from which the user has logged in. 100 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 107
you a view into overall system health. They are also troubleshooting tools for event resolution. v "Event Viewer" v "AS WebSphere Partner Gateway Hub Configuration Guide. Event Viewer Use the to investigate and correct the problem preventing similar failures in the future IBM Corp. 2007, 2008 101 - IBM E02HRLL-G | Administration Guide - Page 108
events are used for low-level system operations and support. Their visibility and use is subject to the permission when services are terminated because of a system failure. Critical events require intervention by support IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 109
event that appear in your viewer page of your console. This self help will provide the cause, diagnosis, and solution for the problem. The following example provides the necessary details when connection parse XML failure occurs: BCG240065-Connection Parse XML Failure XML connection parsing failed - IBM E02HRLL-G | Administration Guide - Page 110
Problem incoming XML. Solution: To solve this problem, do the following: v Check whether support: For further information on this error event, visit our technical support site at: WebSphere Partner Gateway technical support IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 111
source partner, defined by the content of the payload. Operation Mode Production or test. Test is only available on systems that support the test operation mode. Package Describes the document format, packaging, encryption, and content-type identification. Protocol Document format available to - IBM E02HRLL-G | Administration Guide - Page 112
the message that you want to view. The system displays the message and the associated document details, described in Table 27 on page 107. 106 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 113
processing. Either test or production. Test is only available on systems that support the test Operation Mode. The destination address for the MDN. The address can be specified as an HTTP URI, or an e-mail address. This text provides the status of the originating message that was - IBM E02HRLL-G | Administration Guide - Page 114
, DUNS. Production or test. Test is only available on systems that support the test operation mode. Protocols available to the partners. The specific business by document type. Initiating partner. Receiving partner. 108 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 115
attachments, click the Copy link in the Raw Document Viewer to copy the file, including any attachments, to your local disk. Tips: v To troubleshoot documents that have failed processing, see "Viewing data validation errors" on page 115. v The raw document viewer displays the HTTP header with the - IBM E02HRLL-G | Administration Guide - Page 116
system when configuring XML Formats, EDI Transformation maps, or can be defined in custom user exits. For more information about configuring XML Formats, see 110 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 117
creating user exits, see the WebSphere Partner Gateway Programmers Guide. If custom search fields have not been defined for is being transacted. Test or production. Test is only available on systems that support the test operation mode. Identifies that the document was received in synchronous mode - IBM E02HRLL-G | Administration Guide - Page 118
event, then click the View original document icon. 2. For information about troubleshooting documents that have failed processing, see "Viewing data validation errors" on page selecting the check box against it. 112 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 119
EDI documents In addition to pass through support for EDI Interchanges, WebSphere Partner Gateway supports the de-enveloping and enveloping of EDI on page 114 See the WebSphere Partner Gateway Hub Configuration Guide for more information about de-enveloping and enveloping EDI Interchanges - IBM E02HRLL-G | Administration Guide - Page 120
the erroneous value that is not being accepted for the element shown. v Error description: Describes the error condition and the correct element value expected. 114 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 121
> John John [email protected] +1-234-567-8998-8 +1-234 - IBM E02HRLL-G | Administration Guide - Page 122
Contactinformation [email protected] String - IBM E02HRLL-G | Administration Guide - Page 123
can fail while encrypting or signing the message because of incorrect certificate configurations for partner or hub. v For a Delivery Manager failure: - If the problem was because of an error in the BPE flow, the In document should be resubmitted. This ensures that any corrections in the BPE flow - IBM E02HRLL-G | Administration Guide - Page 124
send is processed. ebMS Viewer The ebXML Message Service (ebMS) mechanism provides a standard way to partner. Test is only available on systems that support the test operation mode. Protocols available to the partners IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 125
3. Click Search. The system displays ebMS processes that match your search criteria. Viewing ebMS process details About this task 1. Click Viewers > ebMS Viewer. The system displays the ebMS Viewer Search window. 2. Select the search criteria from the lists. 3. Click Search. The system displays the - IBM E02HRLL-G | Administration Guide - Page 126
to copy the file, including any attachments, to your local disk. Tips: v To troubleshoot documents that have failed processing, see "Viewing data validation errors" on page 115. ," on page 85 for more information. 120 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 127
a way to simulate the internal partner enterprise system sending RosettaNet Service Content (RNSC) through the hub to an external partner. result, they can test without engaging test systems or technical support personnel. To initiate the test, the internal partner uploads IBM Corp. 2007, 2008 121 - IBM E02HRLL-G | Administration Guide - Page 128
response. For more information about receivers, see the WebSphere Partner Gateway Hub Configuration Guide. 3. Verify the Business IDs in the header of your test document. The VTP_TP Simulating external partner. 122 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 129
here in the context of setting up the RN PS. For more information about configuring RN in general, see the WebSphere Partner Gateway Hub Configuration Guide. You will see the directories and hub configuration settings that are used by the RN PS, and you will have a better understanding of how the - IBM E02HRLL-G | Administration Guide - Page 130
the WebSphere Partner Gateway Hub Configuration Guide for assistance when performing the following tasks: 1. Import the RN and RNSC files that support the 3A4 interactions. Upload the to be routed through the hub. 124 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 131
the partner connections between the internal partner and the external partner to support the scenario you want to simulate. 5. Set the attributes of the Upload Document window. 2. Click Browse to locate the RosettaNet Service Content document that you want to upload. The document must be signed - IBM E02HRLL-G | Administration Guide - Page 132
routed through the system to the appropriate destination based on routing information contained in the document. 6. Click View Document Type to view the document. 126 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 133
Removing an open document About this task 1. Click RosettaNet Partner Simulator > View Document Type. 2. Click Remove next to the displayed document. The document is deleted from the system. Chapter 12. Simulating production traffic 127 - IBM E02HRLL-G | Administration Guide - Page 134
128 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 135
on page 137: if the automatic archiver schedule fails due to some reason, you can manually archive the data. Archiver configuration An archiver task is a scheduled process that is executed Click Hub Admin > Hub Configuration > Archiver > Archiver Configuration. © Copyright IBM Corp. 2007, 2008 129 - IBM E02HRLL-G | Administration Guide - Page 136
. Click 'Resume' to schedule the task If the status is Disabled, Stopping, or Running, then the following parameters will be in non-editable mode. 130 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 137
Table 37. Archiver Configuration (continued) Section Field Description Data Retention Period in days The number of days of data (specified in this field) will be retained in the system, and the rest will be archived or purged. Copy NonRep data By default, this value will be checked, which - IBM E02HRLL-G | Administration Guide - Page 138
the archiver task. 5. The archiver cleans-up the files from the Common File System. All files older than the cutoff date specified are deleted. 132 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 139
the archiver task. The event will be logged in the database. v You can set up an 'Alert' for an error event and the alert will be generated when that particular error occurs. v The 'Archiver Task' will stop further scheduling and you have to manually reset the configuration for the archiver after - IBM E02HRLL-G | Administration Guide - Page 140
LG_VALIDATION LG_ACTIVITY_DTL LG_ACTIVITY_ENDSTATE Activity Logging BP_PROCESS_LOG LG_DELIVERY_LOG LG_SYNCH_REQ_RESP LG_ACTIVITY_EVENT LG_SUMMARY_RN_MI LG_EVENT_EVENTSUMMARY LG_EVENTSUMMARY LG_ACTIVITY_SUMMARY LG_SUMMARY 134 IBM WebSphere Partner Gateway Enterprise and Advanced - IBM E02HRLL-G | Administration Guide - Page 141
that have the data for specified sub-volumes and reads those during the restore operation. Upon completion of the data restore, it will update the log table with flag set to 'Imported'. b. The files are copied to dataRestore subfolder of Common File System in the appropriate sub-volume(s). The data - IBM E02HRLL-G | Administration Guide - Page 142
support the backup database archives taken on WebSphere Partner Gateway versions prior to V6.1. However, it supports create the database export files in the format supported by WebSphere Partner Gateway V6.2, which can be IBM WebSphere Partner Gateway Enterprise and Advanced Editions: - IBM E02HRLL-G | Administration Guide - Page 143
the automatic archiver schedule might cease to work due to various reasons. In such instances, you can manually archive the required data. Following sections details the process to manually archive the data. Initiating the archiver task to run from console As WebSphere Partner Gateway administrator - IBM E02HRLL-G | Administration Guide - Page 144
task. Archiver Restrictions Due to native database support for server side export and/or import, following versions: v Oracle 9i does not support export or import through database calls. You bcgDBNonRepImport . v DB2 version 8 does not support import using database calls. Hence you need to - IBM E02HRLL-G | Administration Guide - Page 145
problems that arise when documents are being processed. Logging and tracing are the tools that are used in the diagnosis of the problems problems. WebSphere Application Server provides sophisticated logging is starting up, log messages are often provided in the form of a log message by the application - IBM E02HRLL-G | Administration Guide - Page 146
log files, determine if your WebSphere Partner Gateway system was installed using simple mode or distributed mode. See the WebSphere Partner Gateway Installation Guide for port was not used during installation. 140 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 147
server name in the list. 3. Scroll down until you see the Troubleshooting heading near the bottom of the page. Click Logging and Tracing under Troubleshooting. 4. Click JVM logs to see the details of the logging configuration. 5. The tabbed window that displays contains a tab called Configuration - IBM E02HRLL-G | Administration Guide - Page 148
Troubleshooting heading near the bottom of the page. Clock Logging and Tracing under Troubleshooting not set the logging level. The logging level controls the logging levels. To change the logging levels, see "Setting log IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 149
the server name in the list. 3. Scroll down until you see the Troubleshooting heading near the bottom of the page. Click Logging and Tracing under Troubleshooting. 4. Click JVM logs to see the details of the logging configuration. The window has two pages: Configuration and Runtime. Note: a. Changes - IBM E02HRLL-G | Administration Guide - Page 150
Server documentation. Setting log detail levels When problems occur, services and support personnel may ask for trace files to help understand the nature of the problem. As the with a page that shows a tree-view of 144 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 151
names for WebSphere Partner Gateway classes all begin with the prefix com.ibm.bcg so you can locate the individual components by looking for packages . Do not refer to the FFDC logs unless directed to by product support or specific troubleshooting instructions. EDI, XML, ROD subcomponent tracing There - IBM E02HRLL-G | Administration Guide - Page 152
logs. Some of these messages might appear to be errors, but they are informational and do not pose a problem output logs. directly to SystemOut.log by the user Server logging This logged are logged as events event are: v 220 Service ready for new user. IBM WebSphere Partner Gateway Enterprise - IBM E02HRLL-G | Administration Guide - Page 153
Partner Gateway database. The possible response codes for user authentication are: v 501 Syntax errors in parameters or arguments v 503 Login with USER first. v 202 Already logged-in v 21 Maximum number of anonymous login has been reached. v 421 Maximum number of login has been reached. v 230 User - IBM E02HRLL-G | Administration Guide - Page 154
148 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 155
Event Properties: The Event properties page displays the editable configuration properties for logging FTP Server event messages. Listener Properties: The Listener Properties page lists all Properties: The Other Properties page list all the editable properties. © Copyright IBM Corp. 2007, 2008 149 - IBM E02HRLL-G | Administration Guide - Page 156
. v Edit FTP user information. v Create a new FTP user, which creates FTP user in the hub operator. v View FTP configuration information. v Edit FTP configuration information. 150 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 157
a server component or deployment manager changes. The following changes are supported post deployment of WebSphere Partner Gateway: v "Changing host name and "Prerequisites" for more details. v You need to manually change certain properties such as FTP host, database source IBM Corp. 2007, 2008 151 - IBM E02HRLL-G | Administration Guide - Page 158
the folder /bin. This command changes the host name/IP address of DMGR profile and starts the deployment manager. 152 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 159
/bin. Note: After successful completion of host name/IP address change, the deployment manager starts automatically. However, you need to manually start the node and application servers. Changing the host name and port number of database Refer to the appropriate section for detailed - IBM E02HRLL-G | Administration Guide - Page 160
components are installed. Follow these steps: a. In Machine B where deployment manager is installed, execute bcgChangeNodeHostname.bat\sh with new Host name/IP address and 154 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 161
, for example, bcgChangeNodeHostname.bat 9.1.1.2 9.1.1.1 55880. The executable is available in the folder /bin. Note: Manually start the nodes and application server. DMGR is started automatically. Example 2: Fully distributed installation In this scenario, the - IBM E02HRLL-G | Administration Guide - Page 162
.bat 9.1.1.2 55880. Ensure that you provide new host name/IP address and new port number of the MAS database that is installed on Machine A. Note: Manually restart all the servers. 156 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 163
Chapter 17. Troubleshooting This chapter provides troubleshooting information you can use to identify and resolve problems. See "Appendix B - on page 161 v "Fixing DB2 SQL errors" on page 161 v "IBM service log unreadable" on page 163 v "WebSphere Application Server informational messages" on page - IBM E02HRLL-G | Administration Guide - Page 164
logs error messages" on page 174 v "DB password required error in bcgHubInstall.log" on page 175 v "Using revocation check and using CRL DP support .log" on page 178 v "Reporting file size for documents greater than 2 GB" Extender Map" on page 185 v "IBM Support Assistant (ISA) Plugin" on page - IBM E02HRLL-G | Administration Guide - Page 165
files can be compressed before sending. Large file support with an order of size in GBs has been extended for AS2 and AS3. In version is not available, an error event BCG210050 is generated. When you log in as a hub operator, navigate to System Administration tab > . Chapter 17. Troubleshooting 159 - IBM E02HRLL-G | Administration Guide - Page 166
server, perform the following steps: 1. Log into the WebSphere Application Server admin console. collating data. If your installation supports multiple languages and your Unicode data UCA400_NO collating setting. DB2 version 8.2 does not support all special cases (as described in Unicode Standard - IBM E02HRLL-G | Administration Guide - Page 167
Table 42 contains possible user locales, supported WebSphere Partner Gateway languages, and their in the WebSphere Partner Gateway logs, indicates that there is Error in channel check for com.ibm.bcg.channel.CheckChannelParameters@ebda9664 com.ibm.ejs.cm.portability Chapter 17. Troubleshooting 161 - IBM E02HRLL-G | Administration Guide - Page 168
instance. Consult your database administrator or see your DB2 administrator's guide before changing this setting. A sample command is given below Gateway server logs when DB2 resources are running low on the system. The following is an example of the SQLCODE error. java.sql.SQLException: com.ibm.db2. - IBM E02HRLL-G | Administration Guide - Page 169
fully qualify the service log file name. This showlog command produces output in Common Base Event XML format. For more examples of Showlog scripts, go to http://publib.boulder.ibm.com/ infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.base.doc/info/ aes/ae/ttrb_viewsvclog.html. WebSphere - IBM E02HRLL-G | Administration Guide - Page 170
index. To optimize database query performance, run RUNSTATS at least once a week when IBM WebSphere Partner Gateway application and database activity is at a minimum. As database traffic space to write the documents. 164 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 171
, started the console server and logged into the console successfully, but find finest″. This setting is used to perform the finest logging of all WebSphere Application Server related classes. The to ″finest″ the processing time it takes to log all of that information along with making the requisite - IBM E02HRLL-G | Administration Guide - Page 172
.com Connected to myftp.mycompany.com 220 You have connected to myftp.mycompany.com FTP .com Connected to ftp myftp.mycompany.com 220-You have connected to myftp.mycompany.com ready. User (myftp.mycompany.com:(none)): Receiver Failure to read 166 IBM WebSphere Partner Gateway - IBM E02HRLL-G | Administration Guide - Page 173
log an event or a document status to its database, the data is placed into the DATALOGERRORQ queue for later reprocessing when the problem is resolved. To reprocess these failed events and documents, use the manual defined in reprocessDbLoggingErrors.sh on any router: Chapter 17. Troubleshooting 167 - IBM E02HRLL-G | Administration Guide - Page 174
problem with messages that the router.log file contains: 17 Oct com.ibm.bcg.server.BPEBean.doNonRepudiation(BPEBean.java(Compiled Code)) at com.ibm.bcg.server.BPEBean.processDocument(BPEBean.java(Compiled Code)) 168 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 175
Code)) at com.ibm.bcg.server.BPEBean.processDocument(BPEBean.java(Compiled Code)) These errors are produced when the affected document (identified in the log files by an menu, this does not close the active channels between that partner and the internal partner. Chapter 17. Troubleshooting 169 - IBM E02HRLL-G | Administration Guide - Page 176
Gateway is installed in C:\IBM\WPG: v Console logs are in C:\IBM\WPG\bcghub\was\profiles\bcgconsole\logs\ bcgconsole. v Receiver logs are in C:\IBM\WPG\bcghub\was\profiles\bcgreceiver\logs\ bcgreceiver. v Document manager logs are in C:\IBM\WPG\bcghub\was\profiles\bcgdocmgr\ logs\docmgr. 3. In the - IBM E02HRLL-G | Administration Guide - Page 177
'BCGPackagingHeaders' does not have a feature named 'JMS-IBM-Format' [11/1/05 14:14:07:436 PST] 00000080 SystemOut O warning : Error in the element JMSXAppIDMsg : Class 'BCGPackagingHeaders' does not have a feature named 'JMSXAppID' Chapter 17. Troubleshooting 171 - IBM E02HRLL-G | Administration Guide - Page 178
EDI transformation map can fail with the Check Channel error and errors BCGEDIEV0O56 and BCG210001 on Oracle a message. Next: "Check Channel Error - Channel lookup failed. Not enough channel info This error occurs when the IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 179
see if this is a business ID specific problem. 3. If the previous step fails, then com.ibm.bcg.*=finest" c. Delete (or backup to a different folder), the current logs in these directories: v In simple mode installation, the logs are located in the following directory: Chapter 17. Troubleshooting - IBM E02HRLL-G | Administration Guide - Page 180
logs in folders mentioned in the above two steps, along with a screen capture of the error message taken from the console viewer, to IBM customer support Command Line Processor: Start > Programs > IBM DB2 > Command Line Tools > Command Partner Gateway hub installer logs error messages When running - IBM E02HRLL-G | Administration Guide - Page 181
logs the following error messages in bcgHubInstall.log: com.ibm. the CRL Distribution Point (CRL DP). Enable CRL DP support if CRLs are to be retrieved from the CRL DP. ″. The page just flashes and returns nothing. The problem is with the browser popup blocker which prevents the Troubleshooting 175 - IBM E02HRLL-G | Administration Guide - Page 182
Gateway components are started, the logs might show the following message: is not set correctly, to resolve this error: 1. Log on to the WebSphere Application Server Admin console. 2. start with TCPC0003E and CHFW0029E errors in the SystemOut.log file. The errors can occur because of the following - IBM E02HRLL-G | Administration Guide - Page 183
config\templates\servertypes\APPLICATION_SERVER\serverindex.xml 4) installedFilters\wlm\bcgreceiver\target.xml 5) logs\portdef.props b. Edit \bcghub\receiver\lib\config\ bcg_receiver.properties. SSL certificates is not used in the business transaction. Chapter 17. Troubleshooting 177 - IBM E02HRLL-G | Administration Guide - Page 184
.crypto.provider.IBMJCE security.provider.2=com.ibm.jsse.IBMJSSEProvider security.provider.3=com.ibm.jsse2.IBMJSSEProvider2 security.provider.4=com.ibm.security.jgss.IBMJGSSProvider security.provider.5=com.ibm.security.cert.IBMCertPath #security.provider.6=com.ibm.crypto.pkcs11.provider.IBMPKCS11 In - IBM E02HRLL-G | Administration Guide - Page 185
the SystemOut.log (/opt/IBM/bcghub/wasND/Profiles/bcgdocmgr/logs/bcgdocmgr/SystemOut.log) indicating that com.ibm.ejs.j2c.work.WorkProxy.run(WorkProxy.java:497) at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1469) javax.ejb.TransactionRolledbackLocalException:; Chapter 17. Troubleshooting - IBM E02HRLL-G | Administration Guide - Page 186
com.ibm.websphere.csi.CSITransactionRolledbackException: at com.ibm.ejs.csi.TranStrategy.commit(TranStrategy.java:742) at com.ibm.ejs.csi.TranStrategy.postInvoke(TranStrategy.java:181) at com.ibm.ejs.csi.NotSupported.postInvoke(NotSupported.java:99) at com.ibm service channel channel the Channel - IBM E02HRLL-G | Administration Guide - Page 187
: ADMU3011E: Server launched but failed initialization. startServer.log, SystemOut.log(or job log in zOS) and other log files under /home/dwhare/WebSphere61/profiles/Dmgr01/logs/dmgr should contain failure information. The problem is caused by applying a fix or fix pack as root when the WebSphere - IBM E02HRLL-G | Administration Guide - Page 188
problem: (for example, when a service pack is installed), the issued in a profile after a service pack is installed. (for example, is must be updated manually. Correcting the shortcut Programs > IBM WebSphere > Application IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 189
messaging engine logs contain the IBM Technote for this issue. To find the IBM Technote: 1. Go to http://www.ibm.com/support/us/. 2. Type number 1239781 in the search box. 3. Select Oracle 9i Thin driver running in cognizance with Service Integration Bus and Scheduler Service Troubleshooting 183 - IBM E02HRLL-G | Administration Guide - Page 190
\itp\plugins\com.ibm.websphere.v61_6.1.0. But, after every fixpack release, the folder name com.ibm.websphere.v61_6 scenario, check if the WebSphere SystemErr.log file contains the following errors: v java port mentioned in the exception. v com.ibm.websphere.dtx.dtxpi.rmi.MRmiApiException: Unknown - IBM E02HRLL-G | Administration Guide - Page 191
required for analyzing the problem and managing the service requests. Refer to http://www-01.ibm.com/software/integration/wspartnergatewayfor more information on the ISA product plugin for WebSphere Partner Gateway. To know more about ISA, refer to http://www.ibm.com/software/support/isa. ISA helps - IBM E02HRLL-G | Administration Guide - Page 192
issue, add application/pkcs7- mime content type to excludedContentTypesForCanonicalization property. This is applicable only for AS2 transactions as there is no canonicalization support provided for RNIF transactions. 186 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 193
displays the Summary Service Properties window. 2. Click the Edit icon next to Processing Interval (in Minutes). 3. Type a value (from 1 through 60) indicating the number of minutes that should occur before data is summarized again. The default value is 15. 4. Click Save. © Copyright IBM Corp. 2007 - IBM E02HRLL-G | Administration Guide - Page 194
188 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 195
instanceId {0} Critical on host {1} failed to initialized, please correct the problem and restart the service, error reason:{2} BCG103201 Hub Owner State Engine Error Error Reason:{0} {0} greater Create Error than or equal to parent level = {1} Error © Copyright IBM Corp. 2007, 2008 189 - IBM E02HRLL-G | Administration Guide - Page 196
generated when an unusable Process Instance ID is received and the configuration property indicates that the system will not generate a new Process Instance ID. 190 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 197
and the configuration property indicates that the system will not use the default value on error. This event is generated when there is a check channel related error. This event is generated when data required to lookup a connection is available but the matching connection is not found. This event - IBM E02HRLL-G | Administration Guide - Page 198
document: {0} BCG210016 cXML Channel Parse Failed to parse cXML Supported on this Connection Synchronous Operation not Error Supported operation but the connection does not support synchronous operations. This event is generated IBM WebSphere Partner Gateway Enterprise and Advanced Editions: - IBM E02HRLL-G | Administration Guide - Page 199
rejected. This event is generated when destination parse fails. Typically because of a database problem. This event is generated when destination processing fails. Typically because of a database problem. This event is generated when there are conflicting inputs when processing the destination. This - IBM E02HRLL-G | Administration Guide - Page 200
spec for the PIP cannot be found. Should not occur unless there is a configuration problem. This event is generated when the system fails when attempting to insert the DocType RosettaNet preamble during unpackaging. 194 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 201
is unable to parse the RosettaNet delivery header during unpackaging. This event is generated when the system is unable to parse the RosettaNet service header during unpackaging. This event is generated when an error occurs in Mime parsing of the RosettaNet message during unpackaging. This event is - IBM E02HRLL-G | Administration Guide - Page 202
when connection info for an XML message cannot be found. This event is generated when connection info might not be found in a RosettaNet document. 196 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 203
Severity Error BCG240071 Flat File Connection Flat File connection parse Error Parse Failure failed: {0} BCG240078 Web Service Connection Parse Failed Web Service connection parse failed Error BCG240409 AS Unpackager Failure AS Unpackager Error: {0} Error BCG240411 AS Signature Failure - IBM E02HRLL-G | Administration Guide - Page 204
Protocol parse error {0} Error BCG240701 Activity Logging Error Error occurred while Error logging activity details: {0} BCG250001 Document Delivery Failed fails and the document is set to a failed state. 198 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 205
failed but more retries may be possible. Final failure will generate event 250001. This event is generated when a document fails RN pass through logging. This event is generated when the EDI transaction document is enveloped. The envelope activity id is that of the new envelope document. This event - IBM E02HRLL-G | Administration Guide - Page 206
component {0}. Character set {1} specified in property {2} is not supported Error BCGEDICM0006 Invalid Document Syntax for Component Invalid input for component specified for component {0} Extended description 200 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 207
Table 44. EDI event codes and messages (continued) EDI Event code Event name Internal description Severity BCGEDICM0020 Parsing Error in Component Component {0} failed due to errors parsing the input data Error BCGEDICM0021 Database Error An error occurred while trying to access the database - IBM E02HRLL-G | Administration Guide - Page 208
Error initializing RODScanner Error initializing Error RODScanner. Details : {0} BCGEDIEM0128 Network error message received from IBM VAN. Network error message received from IBM VAN. Details are Message Id = {0}, Message Description = {1}, Severity Code = {2} Error Extended description 202 - IBM E02HRLL-G | Administration Guide - Page 209
with ID {0} back into workflow. BCGEDIEM0205 Unable to find state information. Unable to find state information in the state management service. Error BCGEDIEV0003 Interchange Begin Not Found An attempt to deenvelope a Error message failed because a valid interchange begin could not be - IBM E02HRLL-G | Administration Guide - Page 210
Failed An attempt to deenvelope a Error message failed BCGEDIFT0100 Expected Argument Missing Syntax error on command: Error {0}. An expected argument was missing Extended description 204 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 211
Table 44. EDI event codes and messages (continued) EDI Event code Event name Internal description Severity BCGEDIFT0110 FTP script Processing Error caused FTP script Stopped processing to stop Error BCGEDIFT0111 Missing File Base Name No base name provided for Error retrieved files - IBM E02HRLL-G | Administration Guide - Page 212
command failed. Reason: {0} Error BCGEDIFT0225 LIST Command Failed LIST command failed. Reason: {0} Error BCGEDIFT0226 QUIT Command Failed QUIT command failed. Reason: {0} Error Extended description 206 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 213
read from the database. Syntax: {0}, Dictionary: {1}, Document: {2} Error BCGEDINK0001 Invalid Network Acknowledgement The document passed to the IBM VAN network acknowledgement component is not a valid network acknowledgement Error BCGEDINK0002 Invalid Attribute Value The attribute {0} has an - IBM E02HRLL-G | Administration Guide - Page 214
used for parsing were not specified or are blank Error BCGEDIUP0034 Invalid Structure Usage Character separated data is not a supported option for data formats that contain structures Error Extended description 208 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 215
. Invalid data was {1} Error BCGEDIUP0041 Unsupported Character Set The character set used for the ROD (flat file) data is not supported. The character set was {0} Error BCGEDIUP0042 Unsupported Record Found An unsupported record was found processing C and D records. The character C, D, or - IBM E02HRLL-G | Administration Guide - Page 216
Nodes Invalid ROD (flat file) Under Structure Node DataFormat. ROD (flat file) STRUCTURE node: {0} has child nodes other than STRUCTURE & FIELD Error Extended description 210 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 217
) was unable to process a control string instruction. The control string instruction was {0}, the instruction stream offset was {1}, and the map name Message Text User specified message text: {0}. This message was logged with severity code {1} and user code {2} Error BCGEDIUT0034 HexDecode - IBM E02HRLL-G | Administration Guide - Page 218
Invalid Value for Imbedded Map Imbedded map requires a byte array element. the instruction stream offset was {1}, and the map name was {2} Error BCGEDIUT0100 User Exit of a database error Extended description 212 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 219
Table 44. EDI event codes and messages (continued) EDI Event code Event name Internal description Severity BCGEDIUT0501 Input Document for Transformation is Empty The input document for the Error transformation is empty BCGEDIVA0001 Mandatory Data Element Missing Mandatory data element is - IBM E02HRLL-G | Administration Guide - Page 220
other must be present. Segment name = {2}, segment position = {3}, sending trading partner id/qualifier = {4}/{5}, receiving trading partner id/qualifier = {6}/{7}, control numbers = {8} Error Extended description 214 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 221
Table 44. EDI event codes and messages (continued) EDI Event code Event name Internal description Severity BCGEDIVA0014 Failed 'List Conditional' (L) Condition Failed 'list conditional' (L) condition, the standard defines items {0} as conditionally paired, but only {1} is present. If the first - IBM E02HRLL-G | Administration Guide - Page 222
= {1}, segment position = {2}, sending trading partner id/qualifier = {3}/{4}, receiving trading partner id/qualifier = {5}/{6}, control numbers = {7}. Element type = {8}, value = {9} Error Extended description 216 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 223
Table 44. EDI event codes and messages (continued) EDI Event code Event name Internal description Severity BCGEDIVA0034 Invalid Time Element Invalid time element, element name = {0}, segment name = {1}, segment position = {2}, sending trading partner id/qualifier = {3}/{4}, receiving trading - IBM E02HRLL-G | Administration Guide - Page 224
set or message trailer missing or invalid, control number = {0}, sending trading partner id/qualifier = {1}/{2}, receiving trading partner id/qualifier = {3}/{4}, control numbers = {5} Error Extended description 218 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 225
Table 44. EDI event codes and messages (continued) EDI Event code Event name Internal description Severity BCGEDIVA0103 Transaction Set or Transaction set or message Message Trailer Count trailer contains an invalid Invalid segment count, transaction set or message control number = {0}, - IBM E02HRLL-G | Administration Guide - Page 226
segment validation not supported for document syntax. Service segment validation Error not supported for document syntax BCGEDIVA0991 Required Property or Required property or Content Element Not content element {0} not Found found Error Extended description 220 IBM WebSphere Partner - IBM E02HRLL-G | Administration Guide - Page 227
Table 44. EDI event codes and messages (continued) EDI Event code Event name Internal description Severity BCGEDIVA0992 No Message Properties Found No message properties found Error BCGEDIVA0993 Metadata Not Found Metadata not found, dictionary = {0}, document type = {1}, syntax = {2} - IBM E02HRLL-G | Administration Guide - Page 228
222 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 229
[0]/ProprietaryMessageIdentifier[0] thisDocumentGenerationDateTime[0]/DateTimeStamp[0] Document creation date and time stamp theMessageDatetime[0]/DateTimeStamp[0] thisMessageDateTime[0]/DateTimeStamp[0] GlobalDocumentFunctionCode[0] GlobalFunctionCode © Copyright IBM Corp. 2007, 2008 223 - IBM E02HRLL-G | Administration Guide - Page 230
queries. Editing FTP Administration The FTP administration has the following properties: v Listener Properties v Connection Properties v IP Restrictor v Event properties v Database Properties v Other Properties 224 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 231
Listener properties: The component in the FTP server that listens to clients connection, command execution and so on. The properties of this listener are default listener properties and Client auth. Table 46. Default Listener Properties Property name Description bcg.ftp.config.listeners.default - IBM E02HRLL-G | Administration Guide - Page 232
the value can be set to "SSL_TLS", which will enable both SSLv3 and TLSv1 support. bcg. config.listeners. clientauth.ssl.client-authentication If Client auth is required bcg.ftp connections Maximum logins allowed 226 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 233
event levels (debug/info, warning, error and critical). The default value for this property is 2, so by default all error and critical events will be logged. These values are used to determine the level of FTP events that are - IBM E02HRLL-G | Administration Guide - Page 234
receiver component-Table 69 on page 248 v Attributes used to configure the directory names used by the receiver component-Table 70 on page 248 228 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 235
v Attributes used to configure miscellaneous aspects of the receiver component-Table 71 on page 248 v Attributes used to configure the summary engine subcomponent of the Document Manager-Table 72 on page 249 v Attributes used to configure the sponsor engine subcomponent of the Document Manager-Table - IBM E02HRLL-G | Administration Guide - Page 236
operation will not be performed. bcg.event_log_exclude No default value String List the event codes, separated by commas, that are not to be processed. 230 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 237
TRUE value for this attribute TRUE or FALSE. will generate SSL debug logs. The debug information will be put in the SystemOut.log file in /wasND/Profiles/bcgprofile/ logs/ directory. bcg.rosettanet.encrypt. CertDbRefreshInterval 60000 Integer CRLs and VTP - IBM E02HRLL-G | Administration Guide - Page 238
to trace logs. The trace logs are located in /wasND/Profiles/ bcgprofile/logs/bcgdocmgr/ The default name of the trace file is bcg_router.log. See the .All. See the description for traceLevel.All. 232 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 239
Table 54. Attributes used for processing EDI documents (continued) Entry Default value Possible settings traceLevel.XML-Serializer 0 Integer between 0 and 2 traceLevel.ROD-Serializer 0 Integer between 0 and 2 traceLevel.EDI-Splitter 0 Integer between 0 and 2 traceLevel.XML-Splitter 0 - IBM E02HRLL-G | Administration Guide - Page 240
using 0 and 1 to turn database debug trace on (1) or off (0). Internal setting for IBM use only The name of the subdirectory that is created under the root directory that you what is specified for directory names. 234 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 241
ansi_x3.4-1968| encoding names that are Assigned Numbers iso646- supported by the class Authority encodings is us|default|ascii7| sun inter-component communications. This is for IBM use only. bcg.jms.jndi_factory com.ibm. Class name websphere.naming. WsnInitialContextFactory Internal - IBM E02HRLL-G | Administration Guide - Page 242
IBM IBM use only. bcg.console.jmsPosterInstance com.ibm IBM use only. bcg.jms.reloadCache.name No default value JNDI name Internal setting that affects inter-component communications. This is for IBM IBM SystemErr.log. IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 243
alert. This helps to assure that all documents received during the interval are in the count. Integer To avoid excessive e-mail notifications several properties are used. If there are more than maxNotificationsInInterval in the time interval maxNotificationIntervalInMins for the same alert, alerts - IBM E02HRLL-G | Administration Guide - Page 244
.com e-mail address The e-mail address to use as the sender of alert notifications bcg.alertNotifications.mailReplyTo unknown@ unknown.com e-mail address The e-mail will generate the notification alerts. 238 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 245
Table 59. Attributes used to configure the AS state engine Entry Default value Possible setting bcg.asstate.thread_count 1 Integer bcg.asstate.batchSize 1 Integer bcg.asstate.runinterval 60000 Integer Description Number of threads used by the AS state engine. Batch size is always set to - IBM E02HRLL-G | Administration Guide - Page 246
. bcg.in_thread_count.synchronous 2 Integer Number of inbound threads for synchronous router. bcg.inbound_files_per_pass. 5 synchronous Integer Maximum number of files to pick up in a scan. 240 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 247
smtpHostPort $ROUTER.DM. SMTP_RELAY.PORT$ Integer The port on the SMTP mail host that is used. bcg.delivery.responseDir /common in milliseconds is used to determine if there is a connectivity problem or not. bcg.http.socketTimeout 120000 Integer HTTP socket timeout in - IBM E02HRLL-G | Administration Guide - Page 248
. This is for IBM use only. bcg. IBM use only. bcg.jms.jndi_factory com.ibm .websphere. naming. WsnInitialContextFactory Class name Internal setting that affects inter-component communications. This is for IBM communications. This is for IBM use only. Port 58809 This is for IBM use only. - IBM E02HRLL-G | Administration Guide - Page 249
use only. bcg.alertQueue.queue jms/bcg/queue/alertQ JNDI name Internal setting that affects inter-component communications. This is for IBM use only. bcg.eventAlertQReceiver.queue jms/bcg/queue/ alertEventQ JNDI name Internal setting that affects inter-component communications. This is for - IBM E02HRLL-G | Administration Guide - Page 250
is for IBM use only This is for IBM use only. on (1) or off (0). In the debug logs, the procedure name and the parameters passed AS Inbound and Outbound documents are logged into DB using GlobalStateEngInstanceId. The AS IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 251
Table 65. Attributes used to configure the Document Manager packaging process (continued) Entry Default value Possible setting Description bcg.ediint.retryWaitTmMS 5000 Integer For AS outbound messages (with asynchronous MDN), if the MDN is not received, the AS Engine retries after this - IBM E02HRLL-G | Administration Guide - Page 252
of the 0A1 contact. bcg.0A1.fromEMailAddr $ROUTER. CONTACT. MAIL_FROM$ String E-mail of the 0A1 contact. bcg.0A1.fromPhoneNbr $ROUTER. CONTACT. PHONE_NO$ String Telephone the 2-action of a two action PIP. 246 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 253
be validated. bcg.rosettanet.encrypt.Algorithm 3des 3des or des or aes or Encryption algorithm used for rc2-40 RosettaNet messages. This Property is inter-component communications. This is for IBM use only. bcg.jms.jndi_factory com.ibm.websphere. naming. WsnInitialContextFactory Class name - IBM E02HRLL-G | Administration Guide - Page 254
communications. This is for IBM use only. bcg.jms component communications. This is for IBM use only. Table 69. Attributes of ".vcd" in this location. This is for IBM Internal Use. Table 71. Attributes used to configure IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 255
). For details on XML events, seeXMLEvent section of Enterprise Integration Guide. bcg.sponsor.in_thread_count 1 Integer Number of threads that is used Time interval in seconds that determines how often the archiver service processing occurs. Table 75. Attributes used to configure processing - IBM E02HRLL-G | Administration Guide - Page 256
as ebXML message. Currently, only 2.0 is supported. bcg.ebms.xsd.schemaName ebXMLSchema.xsd String determines how often reliable message service processing occurs. bcg.rm used by the reliable messaging service. Table 77. Attributes used to 250 IBM WebSphere Partner Gateway Enterprise and - IBM E02HRLL-G | Administration Guide - Page 257
Table 78. Other EDI properties (continued) Entry Default value PageThreshold 1000 database.encoding UTF-8 Possible setting Description 0-n This property controls paging of repeating message structures in the EDI components. Set it zero to disable paging. Nonzero values specify the - IBM E02HRLL-G | Administration Guide - Page 258
252 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 259
, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM® Director of Licensing IBM Corporation North - IBM E02HRLL-G | Administration Guide - Page 260
IBM Burlingame Laboratory Director IBM Burlingame IBM under terms of the IBM Customer Agreement, IBM IBM IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM All IBM prices shown are IBM's suggested to IBM, - IBM E02HRLL-G | Administration Guide - Page 261
platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. Each copy or any portion of these sample programs or any derivative work, - IBM E02HRLL-G | Administration Guide - Page 262
WebSphere Partner Gateway Enterprise and Advanced Editions includes software developed by the Eclipse Project (www.eclipse.org) 256 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 263
Copyright IBM Corp. logging out 18 navigating through 16 Components connections 54 Configuration validate webserivces 38 Configurations changing connection 57 deleting transports 46 destination required information 42 managing destination 42 uploading transports 46 Configuring alert mail supported - IBM E02HRLL-G | Administration Guide - Page 264
viewing queued 86 Download packages, configuring 23 E ebMS support 36 ebMS Viewer 119 description 118 searching for processes and editing receiver details 22 I IBM service log 163 Icons in the Community Console 16 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration Guide - IBM E02HRLL-G | Administration Guide - Page 265
Report 92 Profile managing partner 41 Proxy support, forward 49 Q Queue overflow 187 Queue 58 Selecting (continued) transformation map 58 service log, IBM 163 Source destination, changing 58 SQLCODE -1225 proxy 49 retries 46 uploading 46 Troubleshooting 01A 165 Alerts Notification 166 avoiding - IBM E02HRLL-G | Administration Guide - Page 266
Troubleshooting (continued) size 0 KB 178 FTPScripting Receiver 166 hub installer errors 174 IBM service log 163 increasing buffer size 174 information messages 163 java.security.InvalidKey managing formats 24 260 IBM WebSphere Partner Gateway Enterprise and Advanced Editions: Administration - IBM E02HRLL-G | Administration Guide - Page 267
- IBM E02HRLL-G | Administration Guide - Page 268
Printed in USA
-
1 -
2 -
3 -
4 -
5 -
6 -
7 -
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
-
155
-
156
-
157
-
158
-
159
-
160
-
161
-
162
-
163
-
164
-
165
-
166
-
167
-
168
-
169
-
170
-
171
-
172
-
173
-
174
-
175
-
176
-
177
-
178
-
179
-
180
-
181
-
182
-
183
-
184
-
185
-
186
-
187
-
188
-
189
-
190
-
191
-
192
-
193
-
194
-
195
-
196
-
197
-
198
-
199
-
200
-
201
-
202
-
203
-
204
-
205
-
206
-
207
-
208
-
209
-
210
-
211
-
212
-
213
-
214
-
215
-
216
-
217
-
218
-
219
-
220
-
221
-
222
-
223
-
224
-
225
-
226
-
227
-
228
-
229
-
230
-
231
-
232
-
233
-
234
-
235
-
236
-
237
-
238
-
239
-
240
-
241
-
242
-
243
-
244
-
245
-
246
-
247
-
248
-
249
-
250
-
251
-
252
-
253
-
254
-
255
-
256
-
257
-
258
-
259
-
260
-
261
-
262
-
263
-
264
-
265
-
266
-
267
-
268
 |
 |
WebSphere
®
IBM WebSphere Partner Gateway Enterprise and Advanced Editions
Administration Guide
Version 6.2
±²³