background image

To re-send a failed

In

document, select

In

document and click

Resend

. The

document is resubmitted either from DAE or BPE based on the failure location. For
example,

In

document failures can occur in DAE in the following cases:

v

Received document size is more than the maximum size limit.

v

Non-repudiation of the received document failed.

v

Failed sending the document to BPE.

In

document failures can occur in BPE in the following cases:

v

Fixed inbound workflow failures

While unpackaging, the message failures can occur while decrypting the

message or verifying the signature. This can be caused by incorrect
configuration of certificates at the partner or hub.

B2B capabilities are not configured for the partner.

v

Variable workflow failures

Validation maps are not configured.

Invalid Translation maps are configured.

Note:

Documents that fail in the Receiver are resubmitted when the administrator

resolves the problem.

To re-send failed

Out

documents, select the

Out

document and click

Resend

. The

document is resubmitted either from BPE or Delivery Manager.

Out

document failures can occur in the following cases:

v

For a BPE failure resubmitting the

Out

document itself does not make sense, so

in a BPE failure the

In

document should be resubmitted. This ensures that

anything that was incorrect in the BPE flow that was corrected will get picked
up. An example of a correction may be in the transformation.

Out

document

failures in BPE can be Fixed outbound workflow failures. Packaging of the
message 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 will
get picked up. For example, if the destination information was incorrect.

– If the failure was caused by something else, for example, the destination

transport was down, then a resubmit of the

Out

document can be done,

although the

In

document can also be resubmitted.

There is an underlying assumption that nothing has changed that would break a
re-send, especially from the DAE or BPE. For example, if the

In

document is

encrypted, the certificates required to decrypt the document should not have been
changed from the certificates that were used to encrypt the document. The
administrator has to be aware of any potential consequences of the re-send.

When re-sending the

In

document, the document goes through the complete

workflow processing steps. For example, if a document is an AS2 Request from the
partner and an MDN is required, then an MDN is sent to the partner even though
an MDN might have already been sent the first time the document was processed.
Also duplicate document ID checking is bypassed. However, depending on the
business protocol, a

duplicate document ID is detected

warning might still be

issued.

Chapter 11. Viewing events and documents

117

Summary of Contents for E02HRLL-G - WebSphere Partner Gateway Express

Page 1: ...WebSphere IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide Version 6 2 ...

Page 2: ...f Advanced Edition product number 5724 L68 and to all subsequent releases and modifications 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 way it believes appropriate without incurring any obligation to you Copyright International Business Machines Corporation 2007 2008 US Government Users Re...

Page 3: ...P synchronous target time out 23 Managing interactions and document definitions 23 Managing XML formats 24 Large file support 25 Enabling or disabling actions 25 Managing handlers 25 Importing a handler 26 Deleting a handler 26 Configuring the content type attribute in handlers 26 Managing maps 27 Updating validation maps 27 Viewing validation maps Where used 27 Deleting validation maps 27 Managin...

Page 4: ...ng the processing of documents from the destination queue 87 Viewing destination details 88 Changing destination status 88 Chapter 10 Analyzing document flows 89 Document Analysis tool 89 Viewing the state of documents in the system 90 Viewing documents in the system 90 Viewing process and event details 91 Document Volume Report 91 Creating a Document Volume Report 91 Exporting the Document Volume...

Page 5: ...62 SQLCODE 289 error 162 SQLCODE 1225 error 162 SQL 0964C Transaction log full error on the BCGMAS database 162 IBM service log unreadable 163 WebSphere Application Server informational messages 163 Increasing the Receiver timeout setting 163 Optimizing database query performance 164 Resolving event 210031 164 Documents routed twice when network is lost or document manager server shutdown abruptly...

Page 6: ...se 2 183 Document processing when the database goes down 183 java lang NoClassDefFoundError with reprocessDbLoggingErrors bat 184 Recovery process when queue and disk is full or unavailable 184 Workflow Handler Runtime Error 184 Error while invoking WebSphere Transformation Extender Map 185 IBM Support Assistant ISA Plugin 185 Partner Migration Utility with LDAP 185 AS signature failure for intero...

Page 7: ...nal partners have to complete a configuration process to connect to the hub community Once connected external partners can exchange electronic business documents with the internal partner Refer to WebSphere Partner Gateway Partner Guide for more information on hub administrator internal partner and external partner Roles access levels and responsibilities In WebSphere Partner Gateway the hub admin...

Page 8: ...conventions This document uses the following conventions Table 1 Typographic conventions Convention Description Monospace font Text in this font indicates text that you type values for arguments or command options examples and code examples or information that the system prints on the screen message text or prompts bold Boldface text indicates graphical user interface controls for example online b...

Page 9: ...ocumentation available with this product includes comprehensive information about installing configuring administering and using WebSphere Partner Gateway Enterprise and Advanced Editions You can download the documentation or read it directly online at the following site http www ibm com software integration wspartnergateway library Note Refer to Technical Support Technotes and Flashes in WebSpher...

Page 10: ...scheduler v Ability to federate into an existing WebSphere Application Server 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 integration wspartnergateway abou...

Page 11: ...ng one application server called server1 As simple mode system does not use Deployment Manager the mechanics of starting and stopping the WebSphere Partner Gateway components are similar to usage of WebSphere Application Server base rather than network deployment All the computers can have WebSphere Application Server installed but only the Deployment Manager requires the installation of WebSphere...

Page 12: ...ms and concepts regarding the way that the Deployment Manager operates Distributed topology terms and concepts v The system consists of one or more nodes v The WebSphere Deployment Manager is an application that runs on one of the nodes in the system v The WebSphere Partner Gateway components console receiver and router are installed on application servers on the nodes in the system v The default ...

Page 13: ...d from the command line but other administration tasks cannot be performed until the Deployment Manager is available again The most common administration task that is performed is starting and stopping the WebSphere Partner Gateway components Other administration tasks like configuring a server for logging and tracing or changing the startup parameters for the Java Virtual Machine used by a server...

Page 14: ...h WebSphere Partner Gateway server by running the startServer script located in the WebSphere Parnter Gateway Install Dir wasND Profiles bcgprofile bin directory on the computer where the server was installed The syntax is startServer server_name Where the server_name is bcgconsole bcgreceiver bcgdocmgr or bcgmas 3 Stop each WebSphere Partner Gateway server by running the stopServer script located...

Page 15: ...ing servers prior to starting the WebSphere Partner Gateway component servers Starting all the servers using the Deployment Manager About this task 1 Confirm that the node agent is running for each node with the bcgmas server and the bcgserver installed 2 Using the Deployment Manager console select the messaging cluster bcgmasCluster and click Start 3 Wait for the bcgmasCluster to start before per...

Page 16: ...erforming the next step 2 Select the messaging cluster bcgmasCluster and click Stop Stopping the individual servers on each computer About this task If you do not want to stop all servers in each cluster you can stop the servers on each computer where they are installed To stop the servers on each computer perform the following steps 1 Select the bcgserver server to stop and click Stop 2 Repeat th...

Page 17: ...gdocmgr The names shown here are the installation default names Be aware that during installation the installer might have chosen different names and you must use these names instead of the default names Starting servers in a full distributed mode system To start your servers in a full distributed mode system the startup sequence is as follows 1 Messaging servers 2 WebSphere Partner Gateway docume...

Page 18: ...bcgmas server and any of the WebSphere Partner Gateway component servers installed make sure that the node agent s are running 2 Start each WebSphere Partner Gateway server by running the startServer script located in the WebSphere Partner Gateway Install Dir wasND Profiles bcgprofile bin directory on the computer where the server was installed The syntax is startServer server name Where server na...

Page 19: ...revious step until you have stopped all the servers you want to stop 7 Wait until the servers have stopped before stopping the messaging servers 8 Select the bcgmas server messaging you want to stop and click Stop 9 Repeat the previous step until you have stopped all of the servers Note If some of the WebSphere Partner Gateway component servers are still running then keep at least one bcgmas serve...

Page 20: ...14 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 21: ...ed For optimum viewing use a minimum screen resolution of 1024 x 768 To log in to the Community Console follow these steps 1 Type the following URL in the location field of any Web browser http hostname domain 58080 console unsecure https hostname domain 58443 console secure Where hostname and domain are the name and location of the computer hosting the Community Console component 2 In the Communi...

Page 22: ...he procedure under Logging in to the Community Console on page 15 v Help Opens the online help for WebSphere Partner Gateway Note If you do not see a help window after clicking help check to make sure you are not running a popup blocker Community Console icons Table 2 lists the icons that are used throughout the Community Console windows Table 2 Community Console Icons Icon Icon name Collapse Copy...

Page 23: ... Submitted Synchronous data flow No icon is displayed for asynchronous transactions Upload map View a previously sent original document when there is a duplicate document event 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 ...

Page 24: ...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 ...

Page 25: ...ation Environment on page 40 Managing password policy You can set up a password policy for the hub community if you want to use values other than those set by the system as defaults The password policy applies to all users who log in to the Community Console You can change the following elements of the password policy v Minimum Length which represents the minimum number of characters the partner h...

Page 26: ...phere Application Server for use by the component applications You can use the WebSphere Application Server admin console to modify the data sources To configure the database connections used by the components perform the following steps 1 Use a browser to view the administrative console 2 Click Resources JDBC Data sources in the left pane of the console 3 Locate the data source that you want to c...

Page 27: ...s to Critical most serious Debug Low level system operations and support Visibility and use of the debug information are subject to the permission level of the user Info Successful system operations These events also provide the status of documents being processed Informational events require no user action Warning Non critical anomalies in document processing or system functions that enable the o...

Page 28: ...idation Errors on page 114 Managing receivers The Receiver List window is used to view and edit existing receivers details and enable disable or delete receivers Viewing and editing receiver details About this task The following procedure describes how to view details for a receiver As part of this procedure you can edit the parameters of the receivers 1 Click Hub Admin Hub Configuration Receivers...

Page 29: ...r is configured separately through managed application to allow or limit the number of HTTP connections To modify the values of Max sync time out and Max sync connection 1 Navigate to Receiver creation page Hubadmin Receivers 2 Click Edit icon corresponding to the HTTP receiver 3 Modify the values of Max sync time out and Max sync connection Note Max sync time out does not accept negative values E...

Page 30: ...any of the channels 6 Click OK to delete the interaction along with its corresponding channels To find out where document definitions are being used follow these steps WHERE USED icon displays information on where all the selected Document definition is being used 1 Click Hub Admin Hub Configuration Document Definition 2 Click Where used icon of the document definition you want to view This lists ...

Page 31: ...sing the large file processing option on a document family the following limitations are placed on the expressions used in the XML formats that are stored in the family 1 Only simple element paths that begin at the root of the document can be used 2 Element paths cannot include namespace prefixes even though they can appear in the documents Enabling or disabling actions The Actions window displays...

Page 32: ...ppears in the list of available handlers Deleting a handler About this task To delete a handler follow these steps 1 Click Hub Admin Hub Configuration Handlers 2 On the HandlersList page click the Delete icon next to the handler you want to delete Configuring the content type attribute in handlers About this task In some cases the Document Manager may not be able to route some EDI X12 documents wi...

Page 33: ...dation map Deleting validation maps About this task Use this procedure to delete validation maps 1 Click Hub Admin Hub Configuration Maps Validation Maps The validation maps currently in the system are displayed 2 Click Delete icon Note A warning message is displayed to verify whether the selected validation map is used by any of the document definitions If the validation map is not used by any of...

Page 34: ...s you can define specific envelopes to be used for certain exchanges you can set up control numbers that are assigned to the various parts of an interchange and you can set connection profiles so that the same interchange can be delivered in a different way These tasks are described in this section Envelope profile Use the Envelope profiles window to view edit create or delete an envelope profile ...

Page 35: ... Hub Configuration EDI Envelope Profile 2 Click the Delete icon next to the Envelope profile name that you want to delete Enveloper About this task Use the Enveloper page to view and edit the Lock and Queue and Scheduling values for the enveloper 1 Click Hub Admin Hub Configuration EDI Enveloper 2 Click the Edit icon to edit the Scheduler attributes v For Maximum Lock Time type the maximum amount ...

Page 36: ...e the applicable information in the following profile attribute fields v Connection Profile Name an unique name identifier for the new profile This is the only required field v Description a brief description of the connection profile v Qualifier1 the value that determines which connection to use for an EDI interchange v EDI Usage Type indicates whether this is a test production or information int...

Page 37: ...ue next to Interchange to indicate the number you want to use to initialize control number generation for interchanges 6 Type or change the value next to Group to indicate the number you want to use to initialize control number generation for groups Alternatively you can click Mask and type a mask to be used instead of a fixed value 7 Type or change the value next to Transaction to indicate the nu...

Page 38: ...ared by all of the hub component instances there might be times when component instances require their own configuration and not use the shared configuration data To handle this situation the components are always checked using server scope for the attribute values in the WebSphere Application Server environment before obtaining the attribute data from the central database Check WebSphere Applicat...

Page 39: ...tion DocMgr Administration Alert Engine within the WebSphere Partner Gateway console The attributes are v bcg alertNotifications mailHost v bcg alertNotifications mailFrom v bcg alertNotifications mailReplyTo v bcg alertNotifications mailEnvelopeFrom Additional descriptions regarding the purpose and values for these attributes are located in Table 58 on page 237 Viewing system activity About this ...

Page 40: ... programming interface API calls instead of using the Community Console to perform certain tasks To change the setting of the administration API follow these steps 1 Click System Administration Feature Administration Administration API 2 On the Administration API Properties window click the Edit icon next to Enable the XML Based API 3 Select the check box to enable the use of the API or clear the ...

Page 41: ...time for the DAE instance that polls the synchronous message s directory for example sync_in folder under Common The default value is 3 seconds v In Signal folder type a value in seconds representing the maximum lock holding time for the DAE instance that polls the signal message s directory for example signal_in folder under Common The default value is 3 seconds Maximum files per poll interval Ab...

Page 42: ...y to aid in configuring the product If a CPA has not been provided the product can be configured manually There are two ways to upload a CPA from the Document Definition page or from the Hub Admin page Uploading from the Document Definition page About this task Perform the following to upload a CPA 1 Click Hub Admin Hub Configuration Document Definition 2 Click the Upload Download Packages link on...

Page 43: ...esent in the CPA Non prepopulated attributes Attribute values are set at connection level during the upload of the CPA Some attributes however do not have pre populated values The following is the list of such attributes and example values v Encryption Mime Parameter Values can be i smime type enveloped data ii type text xml version 1 0 v Encryption Constituent Values can be i text xml application...

Page 44: ...f you are using the XML encryption you can use the following algorithms 1 3 des cbc 2 aes 128 cbc 3 aes 192 cbc 4 aes 256 cbc If you are using the using SMIME encryption you can use the following algorithms 1 3 des cbc 2 aes 128 cbc 3 aes 192 cbc 4 aes 256 cbc 5 rc2 128 cbc Configuration details for validating Webservices This feature validates SOAP Body or Payload that is available under SOAP Env...

Page 45: ...ng Content Validation routing object attribute the content validation over payload XML can be altered By default Content Validation is enabled Using non repudiation logging About this task WebSphere Partner Gateway increases the configuration options for using non repudiation by enabling a Trading Partner or internal partner to configure it at the package protocol and document flow levels By using...

Page 46: ... V8 2 is installed and running 3 WebSphere Transformation Extender server must have access to the WebSphere Partner Gateway common file system 4 Copy the dtxpi jar from the WebSphere Transformation Extender installation directory into the directory WebSphere Partner Gateway Install router lib userexits This jar file contains the WebSphere Transformation Extender runtime classes that are required t...

Page 47: ... Follow these steps to view and edit partner profiles 1 Click Account Admin 2 Click Search 3 Click the View details icon next to the partner whose details you want to view 4 On the Partner Details window click the Edit icon 5 Modify the partner profile as necessary Note If you click Reset User Passwords the Community Console displays a confirmation window Click OK to proceed or click Cancel to ret...

Page 48: ...formation required for destination setup In Table 4 the boxes marked with an X require configuration information boxes marked with the letter O are optional See Table 5 on page 43 for the destination parameter descriptions Note The ability to edit certain destination configuration values varies with the permission level of the user Table 4 Required transport information Required transport informat...

Page 49: ...ick Online or Offline in the Access column to change the access of a destination 3 Click Enabled or Disabled in the Status column to change the status of a destination 4 Click the View details icon to view destination details 5 Click the Edit icon 6 On the Destination Detail window edit the destination parameters that are described in Table 5 7 Click Save You can also delete the destination by cli...

Page 50: ...is placed in the lock request queue when it is denied a lock request Number of Threads Number of threads allocated for routing a document Default value is 3 This parameter is available to users who are hub administrators Online Offline Indicate whether the destination is online or offline If offline documents are queued until the destination is placed online Password Password for secure access thr...

Page 51: ...he information as required then click Save Viewing destination Where used About this task To view the details of where all a particular destination is employed use the following procedure 1 Click Account Admin Profiles Partner Destinations 2 From the destination list click Where used icon against the appropriate destination The list of where all the selected destination is being used is displayed ...

Page 52: ...out requiring the user to define the retry parameters explicitly The number of transport retries bcg delivery gwTransportMaxRetries and the time interval between retries bcg delivery gwTransportRetryInterval are defined in the Console under System Administration DocMgr Administration Delivery Manager The default values are 3 retries at 3 second intervals If the retry interval is set to 0 then no T...

Page 53: ...t value of 120 seconds from the Connection time out value specified 2 Console Gateway retry 1 of 3 The Delivery Manager checks the Console Gateway level retries If it is greater than 0 then the delivery Manager waits for the specified Console interval in this case 20 seconds a The HTTP Destination Sender sends the request but does not get the response within the connection timeout of 120 seconds f...

Page 54: ... Manager waits for the specified Console interval of 20 seconds before starting Console Gateway retry 3 of 3 a The HTTP Destination Sender sends the request but does not get the response within the connection timeout of 120 seconds from the Connection timeout b The Delivery Manager waits for the specified Sleep per Transport properties interval of 3000 ms c The HTTP Destination Sender sends the re...

Page 55: ...or signed by a Certifying Authority 120 seconds Item 1 on page 47 Console Gateway Connection timeout Item 1 subtotal 120 seconds 20 seconds Item 2 on page 47 Console Gateway Interval Console retry 1 of 3 120 seconds Item 2a on page 47 Console Gateway Connection timeout 3 seconds Item 2b on page 47 Transport Interval Transport retry 1 of 2 120 seconds Item 2c on page 47 Console Gateway Connection t...

Page 56: ...ice once for the Digital Signature and again for the Encryption certificate However if the certificate is used for Digital Signature and for SSL Client then the corresponding check boxes can be set in the same certificate entry Secondary certificates can also be loaded twice once for Digital Signature and again for SSL Client If so the same pattern has to be followed for the secondary certificates...

Page 57: ...of the configuring process used with the certpath related properties bcg CRLDir This property contains the name of the directory where the CRLs are stored The default value is WebSphere Partner Gateway Install Dir common security crl bcg checkRevocationStatus This property specifies if the revocation status is checked The valid values for this property are true false and blank If the value is set ...

Page 58: ...Properties field to false as follows D com ibm security enableCRLDP false Setting HTTP Proxy host and port for CRL DP Set the following Java Virtual Machine properties in the Generic JVM Properties field D http proxyHost proxy host name or ip address D http proxyPort proxy port number To remove the HTTP proxy host and port remove the following properties from the Java Virtual Machine properties in...

Page 59: ...t to disable 3 Click the Edit icon to edit certificate details 4 For Status select Disabled 5 Click Save Note When a primary certificate is disabled the corresponding secondary certificate is made primary When a secondary certificate is disabled a warning is displayed that there is no secondary certificate Changing B2B attribute values About this task To change the attribute values in a Document D...

Page 60: ... and routing functions such as validation checking for encryption and retry count To increase the efficiency when creating connections the attributes for a new connection are inherited from the B2B capabilities of the partners automatically Action Action is the sequence of steps the system uses to process a particular document Each connection typically consists of one or more steps including trans...

Page 61: ...ons on page 56 v Using the system s Advanced Search facility to specify additional search criteria including Business ID initiating and receiving packages and protocols and initiating and receiving document flows See Performing an advanced search for connections on page 56 Use the following procedure to perform a basic search for connections When selecting a source and a target observe the followi...

Page 62: ...et Note To create a new connection the Source and Target must be unique 4 Click Search to find the connections that match your criteria 5 To activate a connection click Activate The Console displays the Manage Connections window This window shows the package protocol and document type for the Source and Receiver as well as options for viewing and changing partner connection status and parameters 6...

Page 63: ...pe Document type used by the Target Connection Status Enables the search for enabled and disabled connections 4 Click Search The system finds the connections that match your criteria Changing connection configurations About this task To change the configuration of a connection use the following procedure 1 Click Account Admin Partner Connections The Console displays the Manage Connections window 2...

Page 64: ...activating a connection To disable or deactivate a connection click the Deactivate icon in the Enabled column The connection display color changes to gray indicating that the connection has been disabled To re enable the connection click the Activate icon For EDI documents there can be several connections that apply to the same partners The various connections are differentiated using connection p...

Page 65: ...lusion status Send All Notifications is selected by default Editing the exclusion list About this task There might be times when you must edit the Exclusion List For example you might want to restrict a notification from being routed to the internal partner 1 Click Account Admin Exclusion List The Console displays the Exclusion List window 2 Select a partner from the Partner Name list The Console ...

Page 66: ...60 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 67: ...terface is provided so the migration utility can be started using a script 2 An API is provided so user written Java programs can invoke the migration utility See the WebSphere Partner Gateway Programming Guide for more information about using the API The migration utility is implemented as a standalone Java application that calls WebSphere Partner Gateway remotely The utility is packaged in a zip...

Page 68: ...xtracted by the utility Configuration data can be exported for the following items in a system v Enveloper schedules v Event codes v Transport and operation modes v Handler definitions metadata only user written executable code jar files are transferred manually v Fixed workflow definitions metadata only user written executable code jar files are transferred manually v Variable workflow definition...

Page 69: ... create a zip file with the XML file in the root directory for the zip file The directories are as follows The routing objects are in a file called RoutingObjects zip within the RoutingObjects directory in the root The transformation maps are in the TransformationMaps directory in the root The validation maps are in the ValidationMaps directory in the root The FA maps are in the FAMaps directory i...

Page 70: ...ata v d is the debug level from 1 to 5 where 5 provides the most debug output The d argument is optional and can be omitted If it is omitted only errors are logged v r is the root path where exported data is stored and the log file is written The r argument is optional and can be omitted If it is omitted exported data is written under the directory specified by the f option Example command for exp...

Page 71: ...unt Admin Partner Destinations Manage Transport Types DestinationTypeInfo Account Admin Partner Destinations create destination Operation Mode is represented by DestinationTypeInfo HandlerInfo Hub Admin Hub Configuration Handlers There are four more sub menus Action Fixed Workflow Destination and Receiver FixedWorkflowStepInfo Hub Admin Hub Configuration Fixed Workflow Inbound and Hub Admin Hub Co...

Page 72: ...r in the list ContactInfo Account Admin Partner Contacts ContactInfo represents each contact in the list PartnerAddressInfo Account Admin Partner Addresses PartnerAddressInfo represents each address in the list ParticipantControlInfo Hub Admin Hub Configuration EDI Control Number Initialization Search ParticipantControlInfo represents each partner s initial control numbers ConnectionProfileInfo Hu...

Page 73: ...es sets used in the connections GroupInfo Account Admin Partners Groups GroupInfo represents each group in the list UserInfo Account Admin Partners Users UserInfo represents each user in the list FTPUserInfo Account Admin Profiles Users FTP User You can also access FTPUserInfo by navigating to Account Admin FTP User Management FTPUserInfo represents each FTP user in the list ErrorFlowInfo Account ...

Page 74: ...nfiguration All or None f User configuration All or None g FTP user configuration All or None h Certificates All or None i Error flow configuration All or None j Archiver configuration All or None 2 Global configuration a Targets All or None b Enveloper c Transport Types d Destination Types e Handlers All or None f Handler attributes All or None for a handler g Actions All or None h Fixed workflow...

Page 75: ... referring to any other configured entity in the system Independent items are the configurable items that do not have any dependency before importing them into the target system Other configuration types cannot exist by themselves because they depend on other entities in the system For example a destination is associated with a partner so it cannot exist unless the partner also exists To ensure th...

Page 76: ...e routing objects of the source system has association with any of the profiles or maps the runtime behavior may not be as expected If the routing objects of the source system do not have any association with envelope profiles and FA maps the runtime behavior will be as expected even if the envelope profiles and FA Maps are not imported v Handlers Transport types v FA Map links FA Map links requir...

Page 77: ...uting object import is not performed then B2B capabilities will not be imported 5 Connection Connection is the most complex dependent item Connection import is dependent on routing object import interaction import partner import B2B capabilities import gateways import actions import and connection profile import If any one of the listed configurable items is not imported importing connections may ...

Page 78: ... Handler Attributes 7 Fixed Workflow 8 Actions 9 Proxy Configuration 10 Envelope Profiles 11 Connection Profiles 12 Validation Maps 13 Transform Maps 14 EDI FA Maps 15 Targets 16 XML format family 17 Routing Objects 18 FA Map links 19 Validation Map links 20 Transform Map links 21 Interactions 22 Partners 23 Group configuration 24 Contacts 25 Addresses 26 Control Number Initialization 27 Alert Not...

Page 79: ...mation for each object The newly configurable item is created when the utility is executed An existing configurable item is updated when the utility is executed v Only partner migrations and connections can be migrated selectively All other migrations must be migrated as a whole v If an export is made from a source system that uses a different file system type than the receiver system the XML docu...

Page 80: ...74 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 81: ...naged authentication mechanism To enable the container managed authentication mechanism set the bcg ldap containerauth property value to True in the WebSphere Partner Gateway console then configure the WebSphere Application Server Global Security setting to use LDAP After you have enabled the authentication users are authenticated against the LDAP server when logging into WebSphere Partner Gateway...

Page 82: ...ation under the following circumstances v The LDAP server stops or permanently goes down v Container based authentication was chosen when installing WebSphere Partner Gateway but the LDAP server is not ready Notes for UNIX users 1 UNIX users who use DB2 must log in as the db2instance user and use the db2instance username and password to run the script 2 UNIX users who use Oracle must log in as the...

Page 83: ...ation Server to authenticate users 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 username used to install the product should be the same as the DB2 instance name and must be a member of the administrators and the DB2Admin groups v The directory server name should be ...

Page 84: ...lications and infrastructure 18 In the right pane of the page click Security Configuration Wizard The wizard opens to step 1 of 4 for configuration 19 For step 1 select Enable application security and click Next to go to step 2 of the configuration wizard 20 For step 2 select standalone LDAP registry and click Next to go to step 3 of the configuration wizard 21 For step 3 of the wizard you specify...

Page 85: ... member of this role 1 Start the WebSphere application server that has the Console application deployed 2 Select Applications Enterprise Applications and then click BCGConsole 3 On the right side of the page in the Additional Properties pane click Security role to user group mapping 4 You can either specify that all successfully authenticated users are made member of the Hubuser role or that only ...

Page 86: ...80 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 87: ... index htm Enabling tunneling IPv6 over IPv4 The IPv6 protocol cannot be used throughout the entire Internet so you must encapsulate IPv6 packets within IPv4 and tunnel through networks where only IPv4 is available RHEL Linux 3 About this task To enable tunneling on an RHEL Linux 3 platform follow the steps below 1 Login as the Root user 2 Add the line add NETWORKING_IPV6 yes to the file etc sysco...

Page 88: ...g in to the WebSphere Application Server Admin console 2 Go to Servers Application servers and select server 3 Select each server and change the java net preferIPv4Stack property using the following process a Select the server bcgdocmgr bcgreceiver or bcgconsole b On the Configuration page expand Java and Process Management in the Server infrastructure section of the page and select Process Defini...

Page 89: ...es 3 Click the Editing publishing info properties icon 4 Type the IPv6 address of the local workstation where the hub is running in the bcg router ipv6 address property Note If more than one instance of document manager exists leave the property bcg router ipv6 address blank 5 Click Save 6 For Receiver go to System Administration Receiver Administration Others 7 Type the IPv6 address of the local ...

Page 90: ...84 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 91: ...ot documents from the queue Note If you are implementing an FTP Scripting Destination with an interval or calendar schedule documents may stay in this queue for an extended period until that interval or date and time is reached This is expected operation and the documents should not be removed from the queue v View destination details to ensure proper operation Documents backing up in a Destinatio...

Page 92: ... Sort search results by Partner default or Destination Name Refresh Turn refresh on or off default Minimum Queued Minimum number of documents in a destination queue The default is 1 Direction Click Ascend to display documents starting with the oldest time stamp or end of the alphabet or Descend to display documents starting with the most recent time stamp or the beginning of the alphabet Refresh R...

Page 93: ...ent by the system Direction Click Ascend to display documents starting with the oldest time stamp or beginning of the alphabet or Descend to display documents starting with the most recent time stamp or end of the alphabet Document ID Type the unique identification number assigned to the document by the source partner Results Per Page Specifies the number of documents displayed on a page Maximum D...

Page 94: ...earch screen 5 Click Search in Queued Documents Search The Destination details and a list of queued documents are displayed Changing destination status About this task To place a destination online or offline use the following procedure 1 Click Viewers Destination Queue 2 From the Destination Queue window type the search criteria see Table 10 on page 86 3 Click Search 4 From the list of destinatio...

Page 95: ...ments processed by the system within a specific time period and can be viewed printed and saved exported to send to other staff members You can customize this report to view information based on specific search criteria The Test Partner Connection tool is used to test the connection to the destination Features covered in this chapter include v Document Analysis tool v Document Volume Report on pag...

Page 96: ...From the Document Analysis Search window select the search criteria from the lists Table 14 describes the values that you can specify to determine which documents are displayed Table 14 Document search criteria Value Description Start Date Time The date and time the process was initiated End Date Time The date and time the process was completed Source Partner The partner that initiated the busines...

Page 97: ... troubleshoot the flow of your business documents The report displays the volume of documents processed by the system within a specific time period This report can be viewed printed and saved exported to send to other staff members You can customize this report to view information based on specific search criteria The Document Volume Report shows the number of documents currently in process by the...

Page 98: ...g the Document Volume Report About this task 1 Click Tools Document Volume Report The system displays the Document Volume Report Search window 2 Select the search criteria from the lists 3 Click Search The system displays the report 4 Click the Export report icon to export the report Navigate to the location where you want to save the file Note Reports are saved as comma separated value csv files ...

Page 99: ...eturned see Web Server result codes Pinging ebMS partners About this task From the Test Partner connection page you can ping ebMS partners This means that you can send a ping message to a partner and if the partner is up and ready to receive the partner responds with a pong message Once you upload a CPA the ping pong connection is created For the Ping to work connections have to be defined with th...

Page 100: ...ng one of the returned URLs v 302 Moved Temporarily The requested resource resides temporarily under a new URL Redirection to a new URL The original page has moved This is not an error most browsers invisibly fetch the new page when they see this result 400 Series v 400 Bad Request The request might not be understood by the server because it has a malformed syntax Bad request was made by the clien...

Page 101: ...s that the client must first authenticate itself with a proxy HTTP 1 0 does not provide a means for proxy authentication v 408 Request Time Out The client did not produce a request within the time the server was prepared to wait v 409 Conflict The request might not be completed because of a conflict with the current state of the resource v 410 Gone The requested resource is no longer available at ...

Page 102: ...erdue searches that were removed from the resulting reports will be ignored by later searches Therefore removed records are not displayed in later reports Records can be removed from a report by selecting Ignore Selected Records on the EDI FA Overdue Report page Only the hub administrator can remove records from a report To search for the EDI FA Overdue records do the following 1 Click Tools EDI R...

Page 103: ... document type of the transaction Target Trading Partner The partner that sent the transaction Target Package The target package of the transaction Target Protocol The target protocol of the transaction Target Document Type The target document type of the transaction Interchange Number The interchange number of the transaction Group Number The group number of the transaction Transaction Number The...

Page 104: ...cted Transaction report Viewing EDI Rejected Transaction reports Depending on the search criteria selected on the EDI Rejected Transaction Search page the search result is displayed in the EDI Rejected Transaction Report page The following data when applicable is displayed in the EDI Rejected Transaction report Table 21 EDI Rejected Transaction Report Value Description Date The Date on which the E...

Page 105: ...r of files deleted Number of files deleted by all users using delete command Uploaded Bytes Total number of bytes uploaded Downloaded Bytes Total number of bytes downloaded Current logins Displays existing logins Total Logins Total logins since the last reset Total failed logins Total number of logins failed Current Connections Current connections since the last reset Total Connections Total conne...

Page 106: ...en 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 Client Address The client IP from which the user has logged in 100 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 107: ...ocument Most types of documents are resent multiple times so when a document fails and generates an event you can use this information to investigate and correct the problem preventing similar failures in the future WebSphere Partner Gateway includes predefined events The Alerts feature in the Account Admin module allows you to do the following v Create event based alerts v Identify the events tha...

Page 108: ...intervention by support personnel Searching for events About this task 1 Click Viewers Event Viewer Check boxes for Event severity are organized from left to right and Debug is located on the left in the Event Viewer Search window Information on the left is the least severe event type Critical information located on the right side of the window is the most severe For any selected event that event ...

Page 109: ...ails About this task 1 Click Viewers Event Viewer 2 Select the search criteria from the lists 3 Click Search 4 From the displayed list of events click the View details icon next to the event you want to view 5 From the displayed event details click the View details icon next to the document that you want to view if one exists 6 Click the Display raw document icon to view the raw document if one ex...

Page 110: ...describe how to connect deliver validate and reply to data They do not interact with the content of the document only the transport AS2 and AS3 create a wrapper around a document so that it can be transported over the Internet using HTTP or HTTPS for AS2 or FTP for AS3 Together the document and wrapper are called a message AS2 provides signing and encryption around the data carried within HTTP pac...

Page 111: ...r documents in which the Partner is the Target or Source partner only AS Source Business ID Business identification number of the source partner defined in the AS header Payload Source Business ID Business identification number of the 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...

Page 112: ... state Sort by Sort results by v Target Timestamp v Source Document Definition v Target Document Type v Message ID v MDN Status v Document ID The default is Target Timestamp Descend or Ascend Descend displays the most recent time stamp or the beginning of the alphabet first Ascend displays either the oldest time stamp or the end of the alphabet first The default is Descend Results per page Use to ...

Page 113: ...iled unsupported MIC algorithms 5 Optional Click the Document details icon to view more information about the document RosettaNet Viewer RosettaNet is a group of companies that created an industry standard for e business transactions Partner Interface Processes PIPs define business processes between members of the hub community Each PIP identifies a specific business document and how it is process...

Page 114: ...alphabet first Ascend displays either the oldest time stamp or the end of the alphabet first The default is Descend Results Per Page Specifies the number of results displayed per page 3 Click Search The system displays RosettaNet processes that match your search criteria Viewing RosettaNet process details About this task 1 Click Viewers RosettaNet Viewer The system displays the RosettaNet Viewer S...

Page 115: ...nature is located at the bottom of the raw document rno file and the size of the raw document exceeds 100K or the signature is present after the first 100K of the rno file the signature will not be shown in Document Viewer To view the complete file you can download the file to the local disk using the copy option 2 The Raw Document Viewer might not display document attachments To view any attachme...

Page 116: ... of a document definition falling below Package and Protocol Original File Name The initial name assigned to the file Document ID Created by the source partner Criteria can include asterisk wildcard Reference ID The ID number created by the system for tracking document status Source IP Address The IP address of the source partner Filter Search for documents received in synchronous mode This means ...

Page 117: ...pen until the transaction is complete including request and acknowledgment or request and response Viewing document details events and raw documents About this task 1 Click Viewers Document Viewer The system displays the Document Viewer Search window 2 Select the search criteria from the lists 3 Click Search The system displays a list of documents 4 Click the View details icon next to the document...

Page 118: ...signature is located at the bottom of the raw document rno file and the size of the raw document exceeds 100K or the signature is present after the first 100K of the rno file the signature will not be shown in Document Viewer To view the complete file you can download the file to the local disk using the copy option 2 The Raw Document Viewer might not display document attachments To view any attac...

Page 119: ...arios will assist you in locating this information v Viewing EDI document source transactions v Viewing EDI document target transactions v Locating the source interchange for an EDI transaction on page 114 v Locating the target interchange for an EDI child transaction on page 114 See the WebSphere Partner Gateway Hub Configuration Guide for more information about de enveloping and enveloping EDI I...

Page 120: ...m displays the Document Viewer Search window 2 Select the search criteria from the lists 3 Click Search The system displays a list of documents 4 Click the View details icon next to the Document ID 5 Click Information in the Document Events section 6 Click the Expand icon next to EDI Transaction Enveloped in the Event Name column 7 Locate and copy the Envelope activity id from the Event Details li...

Page 121: ...ed FreeFormText The data element is the third validation error since this field requires a minimum of six characters John xml version 1 0 encoding UTF 8 DOCTTYPE Pip3 A7PurchaseOrderUpdateNotifion SYSTEM 3A7_MS_V02_00_PurchaseOrderUpdateNotification dtd Pip3A7PurchaseOrderUpdateNoticifation fromRole PartnerRoleDescription GlobalPartnerRoleClassificationCode Seller GlobalPartnerRoleClassificationCo...

Page 122: ...e client server before it interfaced with the backend system There are two basic types of documents that administrators can re send v In documents are those that come into WebSphere Partner Gateway either from the Backend or the partner These documents can fail in the Receiver Document Acquisition Engine DAE or Business Process Engine BPE v Out documents are those that leave WebSphere Partner Gate...

Page 123: ... may be in the transformation Out document failures in BPE can be Fixed outbound workflow failures Packaging of the message 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 ...

Page 124: ...splays the ebMS Viewer Search screen 2 Select the search criteria from the lists Value Description Start Date and Time The date and time that the process was initiated End Date and Time The date and time that the process was completed Source Partner Identifies the sending partner Target Partner Identifies the receiving partner Source Business ID Business identification number of initiating partner...

Page 125: ...t to view The system displays details and associated documents for the selected process including the Conversation Status The Conversation status indicates what process is next for example Waiting for confirmation acknowledgment If the Conversation Status is complete then all the children have been processed 5 Click the View details icon next to the document you want to view The system displays th...

Page 126: ...tus feature is enabled 1 Click Viewers ebMS Viewer The system displays the ebMS Viewer Search window 2 Type or select the applicable search criteria 3 Click Search The system displays a list of processes 4 Click the View details icon next to the process that you want to view The system displays process details and associated documents for the selected process 5 Select a document in the details lis...

Page 127: ...port personnel To initiate the test the internal partner uploads a test document This feature only accepts RNIF v2 0 DTD based PIP it is not compatible with RNIF 1 1 The test document must be a RosettaNet Service Content file you cannot upload a RosettaNet Object RNO Service Content is the primary component of the payload of a RosettaNet Business Message It is an XML document that represents the b...

Page 128: ... header must be your own Business ID The system uses the to Business ID to find the correct connection The following is an example of the from and to Business IDs in a test document lines that are not relevant have been removed xml version 1 0 encoding UTF 8 DOCTYPE Preamble SYSTEM 3A4_MS_V02_02_PurchaseOrderRequest dtd Pip3A4PurchaseOrderRequest fromRole GlobalBusinessIdentifier 987654321 GlobalB...

Page 129: ...d as the default RN PS partner and RN PS Manager destination for the internal partner External partner Set up an HTTP sink destination for the partner just as you did for the internal partner RosettaNet PIP XML files The 3A4 interaction is the scenario described here The external partner to internal partner simulation uses XML that contains the 3A4 Purchase Order Request content The internal partn...

Page 130: ...er security properties by navigating to System Administration DocMgr Administration Security b Click the Modify icon to place the screen into edit mode c Change the value of the bcg certs vtp CertificateDir property to point to the same directory that the console pointed to step 4b Save the property setting Note These directories are named in the context of the server where the components are inst...

Page 131: ...e document to verify that it was processed correctly it is an open document pending response Examine your internal application to verify that the document was received and processed correctly Use a text editor to edit the to and destination sections of the request to create a response Then upload the response When you send a response you can also use the View Document Type window to examine the do...

Page 132: ...to and destination sections of the process requiring a response document change VTP_OWNER to VTP_TP or change VTP_TP to VTP_OWNER and make the appropriate changes to the receiver s URL See Table 36 for test scenario information Table 36 Test scenarios Scenario Destination for Connection URL Two way outbound from the internal partner to an external partner Upload Request Simulating internal partner...

Page 133: ...pen 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 ...

Page 134: ...128 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 135: ...u can view and modify the archiver task v Archiver runtime tasks on page 132 list of runtime activities that occur while archiving v Archiver reports on page 133 view the status of each archiver task v Archiver Restore on page 135 you can restore the data which is already archived v User intervention for archiving on page 137 if the automatic archiver schedule fails due to some reason you can manu...

Page 136: ...nnot be edited Status Status of the task displayed in non editable mode which can be any one of the following values v Scheduled by default the status is scheduled It means that the task is scheduled to be run v Running displayed when the archiver task is executing v Stopping displayed when you click Stop on the console v Being Scheduled displayed when the configuration changes are saved to the da...

Page 137: ...Backup in case of DB2 ORACLE_HOME oradata ORACLE_SID dbBackup in case of Oracle Note You need to provide a fully qualified path where the database user has write permissions Purging Schedule Daily Weekly or Custom schedule The schedule for the archiver task to run which can be daily weekly or user specified The time specified will be in HH MM GMT format Archive criteria The following parameters ar...

Page 138: ...ked by the system 2 The configuration is read and the appropriate data is archived to the backup locations 3 The common file system is cleaned up and data is purged from the database tables Here is the archiver runtime flow 1 The Scheduled Archiver task runs as per the configured schedule 2 The Archiver marks itself as Running in the database The same status is displayed at that instance on the co...

Page 139: ...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 correcting the error Archiver reports To view the archiver report login as administrator and navigate to Hub Admin Hub Configuration Archiver Archiver Configuration The page lists the existing a...

Page 140: ...Y LG_STACKTRACE LG_EVENT LG_ACK LG_CHAIN LG_EDI_FA_RECONCILE LG_ENVELOPE_INCLUSION State Engine BP_RNSTATEHDRAUDITLOG BP_RNMSGDIGEST BP_SPONSOR_STATE BP_RNSTATEDTL BP_RNSTATEHDR BP_AS_STATE_DTL BP_AS_STATE_HDR BP_STATE_HDR BP_RM_STATE_DTL BP_RM_STATE_HDR BP_SPONSOR_STATE_EBMS BP_DUPCHECK LG_SUMMARY_MI LG_SUMMARY_RN LG_SUMMARY_RN_MI LG_EVENT_EVENTSUMMARY LG_EVENTSUMMARY LG_ACTIVITY_SUMMARY LG_SUMMA...

Page 141: ...ase Archive Location directory This location will be searched for the files backed up from the NONREP folder during archiving The default value will be taken from latest configuration for the archiver task The restore will fail if it fails to read from the path specified e g directory does not exist 5 Select the Append checkbox if you wish to append the data while restoring If the checkbox is not ...

Page 142: ...6 1 or later 1 Use the bcgDBNonRepImport script to import the table data into LG_MSG_ARCHIVE table 2 Run the archiver from the console This will create the database export files in the format supported by WebSphere Partner Gateway V6 2 which can be restored using the console The steps to restore the archived data are same as described for DB2 database in the previous section To restore V6 0 non re...

Page 143: ...ow link will be disabled 2 The server starts to execute the task If the Copy option is selected while configuring the data gets copied to the specified location Stopping a running archiver task Here are the steps to abort a running archiver task 1 Navigate to Hub Admin Hub Configuration Archiver Archiver Configuration The page lists the existing archiver task with the status as Running 2 Click Sto...

Page 144: ... Restore functionality will be restricted on the following versions v Oracle 9i does not support export or import through database calls You need to perform export and import of database data using the scripts provided bcgDBNonRepExport and bcgDBNonRepImport v DB2 version 8 does not support import using database calls Hence you need to perform the import of database tables using the script provide...

Page 145: ...phere Partner Gateway are described in this section SystemOut log and SystemErr log Log messages are written whenever an application writes to the standard output stream or standard error stream Application developers can write messages to these streams to provide general information about the status of the programs For example when an application is starting up log messages are often provided to ...

Page 146: ...eployed under the path WebSphere Partner Gateway install dir wasND profiles profile name logs server name Managing the log files means controlling the amount of disk space they can use Some way of limiting the size is necessary otherwise they can grow out of control and eventually affect your system s status To control the file sizes they are maintained as a set of circular log files You can confi...

Page 147: ...essages for the server v You can change the format used for the log messages Both of the formats provide the message that the application writes The difference between the basic and advanced formats is how much meta information is provided with each message Meta information is information such as the time the log was written basic and advanced and the name of the thread advanced only that wrote th...

Page 148: ...phere Partner Gateway install dir wasND profiles profile name logs server name This is the same default directory where the log files are written Table 39 Simple mode trace configuration Application Trace file name Format Number of files Maximum file size All applications Console Receiver and Document Manager trace log Basic 1 20 Mb By default the simple mode installer does not set the logging lev...

Page 149: ...console by clicking on Servers Application servers in the left pane to list the server names in the right pane 2 View the details of the server that you want to configure by selecting 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 confi...

Page 150: ... changes to configuration before saving For a complete description of these features see the WebSphere Application 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 administrator of the system you will configure the system to obtain the tracing that is useful for diagnosing p...

Page 151: ... tree views are only a fraction of all the packages and classes that make up WebSphere Partner Gateway applications You might be asked to obtain tracing for classes that are not in these lists If you change the configuration page be sure to save the configuration to the master configuration according to the message that displays at the top of the page Identifying WebSphere Partner Gateway trace me...

Page 152: ...omponents Z A placeholder to indicate that the type was not recognized Integrated FTP Server logging This section describes the integration of success and failure event messages for the FTP Server actions When WebSphere Partner Gateway Partner intends to send a document to WebSphere Partner Gateway Integrated FTP server Integrated FTP server produces a client connect notification event The appropr...

Page 153: ... v 226 Transfer complete v 550 Invalid paths v 550 Permission denied v 425 Can t open data connection v 426 Data connection error v 551 Error on output file Once the document is successfully uploaded to the FTP Location the FTP connection is disconnected FTP server produces a disconnect notification event This event is logged into WebSphere Partner Gateway database Logging and exception informatio...

Page 154: ...148 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 155: ...ties The IP Restrictor allows you to restrict access to FTP Server using IP addresses Click Add to add new IP address IP address can be specified with wild cards namely and The order of the rules is important When a client contacts the server the rules are evaluated from top to bottom Click Save to save the changes The FTP server will restart for the changes to take effect If all the passive ports...

Page 156: ...s using FTP user management page v Search for FTP users across partners based on the required search criteria 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 Guide ...

Page 157: ... also provides example scenarios considering different installation and deployment topologies Note The commands mentioned in this chapter is not case sensitive Limitations While automatically updating host name or IP address here are few things to keep in mind v Ensure that you take a backup before changing the parameters If you backup the existing configuration using backupconfig bat you will be ...

Page 158: ...e bcgChangeDataSource bat sh with new Host name IP address and Port number as the input parameters that is bcgChangeDataSource bat sh New IP Hostname PORTNUMBER This executable is available in the folder Installation directory of simple mode bin 3 Change the host name execute bcgChangeNodeHostname bat sh with new Host name IP address as the input parameter that is bcgChangeNodeHostname bat sh New ...

Page 159: ...er of database Refer to the appropriate section for detailed steps to change the host name and port number of database Ensure that you backup the configuration files before making any significant changes For more details see Prerequisites on page 151 section Simple mode Run the command bcgChangeDataSource bat sh New IP Hostname PORTNUMBER This executable is available in the folder BCG_SIMPLE_HOME ...

Page 160: ... DMGR profile as described below a In Machine B where deployment manager is installed execute bcgChangeDmgrHostname bat sh with new Host name IP address as the input parameter for example bcgChangeDmgrHostname bat 9 1 1 1 The executable is available in the folder Installation directory of Deployment Manager bin This command changes the host name IP address of DMGR profile and starts the deployment...

Page 161: ...cute bcgChangeDmgrHostname bat sh with new Host name IP address as the input parameter for example bcgChangeDmgrHostname bat 9 1 1 1 The executable is available in the folder Installation directory of Deployment Manager bin This command changes the host name IP address of DMGR profile and starts the deployment manager b In Machine C access the Node where WebSphere Partner Gateway components are in...

Page 162: ... bcgChangeDataSource bat 9 1 1 2 55880 Ensure that you provide new host name IP address and new port number of the application database that is installed on Machine A b In Machine C where WebSphere Partner Gateway components are installed execute bcgChangeMASDataSource bat sh with new Host name IP address and port as the parameters For example bcgChangeMASDataSource bat 9 1 1 2 55880 Ensure that y...

Page 163: ... the first 1000 records only on page 165 v Console does not start after a server restart on page 165 v FTPScripting Receiver receives StringIndexOutofBoundsException on page 166 v Receiver Failure to read Configuration File on page 166 v Configuring Users to receiving Alerts Notification on page 166 v Resolving ClassNotFoundException for User Exit classes on page 167 v Reprocessing events and busi...

Page 164: ...ns on page 181 v Servers fail to start after applying fixes on page 181 v Correcting the shortcut ports for WebSphere Application Server on page 182 v Avoiding duplicate document delivery when there is more than one router on page 182 v Rendering of tab headings on displays with resolution greater than 1024 on page 183 v Documents not processed when using Oracle 9i Release 2 on page 183 v Document...

Page 165: ...using streams rather than as byte arrays For example if RAM size is 512 MB then the value of bcg maximumFileSizeForByteArrays property can be set to 20 MB All documents of size greater than 20 MB will be processed using streams and not using byte arrays Documents of size less than 20 MB will be processed in memory Avoiding out of memory errors Areas that can contribute to the out of memory conditi...

Page 166: ...fail with the error OutOfMemory The OutOfMemory error is the result the working memory not being sufficient for the Websphere Partner Gateway to route the documents in bulk Therefore it is recommended that you increase the heap size To increase the heap size parameters for the DocMgr server perform the following steps 1 Log into the WebSphere Application Server admin console 2 From the WebSphere A...

Page 167: ...available to the database agent for sort processing To correct this situation decrease the value of the SORTHEAP parameter for the database that you created for WebSphere Partner Gateway Contact your database administrator for specifics on how to set that parameter in your environment The following is an example of an insufficient virtual memory error Error DBChannelCheck main Thread 2 Error in ch...

Page 168: ... error A DB2 error code 289 indicates that the database has run out of space on the file system Check with the database administrator about adding additional capacity on the database sever Alternatively WebSphere Partner Gateway data can be archived to a different storage location to free up disk space SQLCODE 1225 error You can receive the SQLCODE 1225 error followed by a stack trace in the WebSp...

Page 169: ...the service log is not in the default directory you must 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 Application Server informational messages Some WebSph...

Page 170: ...t to database name 2 db2 v reorgchk update statistics on table all 3 db2 connect reset Note Ensure that you stop all Websphere Partner Gateway components before starting this procedure You should also stop and restart the database instance after you finish the reorgchk Resolving event 210031 About this task You can receive event 210031 while a document is performing non repudation when one of the ...

Page 171: ...lick Save EDI reports export the first 1000 records only The export function of the 2 EDI Reports FA Overdue and Rejected Transactions exports the first 1000 records only in order to minimize unexpected system shutdowns because of memory overflow issues If the number of records to export from the reports is over 1000 export the records directly from the related database view LG_EDI_Overdue_FA_VW o...

Page 172: ...ge is displayed Unable to update the Receiver Config file java io IOException A file or directory in the path name does not exist This error occurs when the WebSphere Partner Gateway Receiver is starting and it does not have a connection to the database and it is attempting to read the configuration information from the BCGReceiverConfiguration xml file The BCGReceiverConfiguration xml file is loc...

Page 173: ...plication Server Admin Console b Go to Environment Shared Libraries c Look for BCG_RCVR_USEREXISTS and BCG_ROUTER_USEREXITS d Edit the shared library information in these attributes and ensure that the corresponding jars or classes are added to the class path Reprocessing events and business documents that fail to log to the database If WebSphere Partner Gateway fails to log an event or a document...

Page 174: ...d You will not be able to create and save any destination of that transport type For example tns2 AttributeName URI tns2 AttributeName should not be used Resolving WebSphere Partner Gateway errors BCG210031 and BCG240415 WebSphere Partner Gateway continually attempts to process the same document issuing the following errors BCG210031 Unable to Non Rep document 0 BCG240415 AS Packager Error 0 The f...

Page 175: ...The router log should now be clear of the error and the router CPU usage should go back to normal Creating File directory destination on a drive other than C If a WebSphere Partner Gateway File Directory Destination address is defined for a drive other than C WebSphere Partner Gateway returns the error Destination Directory does not exist The console will accept the creation of the File Directory ...

Page 176: ...ceiver logs bcgreceiver v Document manager logs are in C IBM WPG bcghub was profiles bcgdocmgr logs docmgr 3 In the each folder check the SystemErr log This file should have the time stamp of the latest access attempt 4 Scroll down to the bottom of the file to see the latest log entries and review the error messages Downloading CRL for SSL transactions About this task SSL transactions can fail whe...

Page 177: ...ataBinding Utility warning Error in the element JMS IBM PutApplTypeMsg Class BCGPackagingHeaders does not have a feature named JMS IBM PutApplType 11 1 05 14 14 07 426 PST 00000080 SystemOut O com ibm bcg dataBinding Utility warning Error in the element JMSXGroupSeqMsg Class BCGPackagingHeaders does not have a feature named JMSXGroupSeq 11 1 05 14 14 07 426 PST 00000080 SystemOut O com ibm bcg dat...

Page 178: ...e character set on Oracle 1 Connect to the oracle database 2 Select NLS_CHARACTERSET from v nls_parameters 3 The value returned should be AL32UTF8 Verify this on your Oracle systems There is not a direct way of modifying the character set of the database once it has been created The solution is to re create the database with the database character set and the national character set as Unicode Fixi...

Page 179: ...ntent Types attribute by adding the new content type Ensure that the content type values are separated by a comma Note It is recommended not to change these content type values unless advised Fixing BCG210013 error About this task Unable to receive inbound document because of the following error BCG210013 Connection Not Fully Configured If all other configurations appear to be correct the most com...

Page 180: ...e Tools Command Line Processor 2 Connect to the database using the command DB2 connect to bcgapps user username using password 3 Increase the buffer size using the command DB2 alter bufferpool buff32k immediate size 12500 This will increase the specific buffer size from 500 default to 12500 WebSphere Partner Gateway hub installer logs error messages When running the WebSphere Partner Gateway Launc...

Page 181: ...so be provided For self signed certificates revocation check is not being done See Configuring the certpath related properties on page 51 for more information Returning document volume report search information about the console About this task A WebSphere Partner Gateway document volume report search does not return information about the console When you click the Search in the Console Tools Docu...

Page 182: ...om another location 7 Verify that the shared libraries are associated with each WebSphere Partner Gateway application To verify a On the WebSphere Application Server Admin console Applications page click any of the WebSphere Partner Gateway applications containing bcgDocMgr b Click Shared Library references c Verify that the BCG_NAV_ROUTER_DOCMGR library is associated with the application If is no...

Page 183: ...er target xml 5 logs portdef props b Edit Installed_path bcghub receiver lib config bcg_receiver properties Note The port number can also be changed using the WebSphere Application Server Admin Console by going toServer Ports page and changing the port for WC_defaulthost 3 Start the Receiver 4 Type the Receiver URL in your browser to ensure Receiver works http host_name xyz bcgreceiver The correct...

Page 184: ...andshake fails because no certificate received This problem occurs during the SSLHandShake between a partner and WebSphere Partner Gateway when you are sending to a partner using SSL with Client Authentication If the partner does not send the list of certifying authority certificates the SSL client in WebSphere Partner Gateway does not send the client certificate This causes the handshake failure ...

Page 185: ...s processing 2 1 07 14 04 40 546 EST 00000088 ExceptionUtil E CNTR0020E EJB threw an unexpected non declared exception during invocation of method onMessage on bean BeanId BCGBPE ejb bcgBpeEJB jar BPEMainEngineMDB null Exception data javax ejb TransactionRolledbackLocalException nested exception is com ibm websphere csi CSITransactionRolledbackException com ibm websphere csi CSITransactionRolledba...

Page 186: ...n all of the follow objectives are met v Graceful recovery v No document loss v No duplicate document processing v No performance degradation after restart v No hung documents Fixing WebSphere MQ messages See the following sections to fix specific MQ messages v MQJMS2007 error v MQJMS2013 error on page 181 MQJMS2007 error About this task If you are using JMS as a Gateway with Websphere MQ as the m...

Page 187: ...rade to WebSphere Partner Gateway v6 2 the AS Viewer in the Community Console will show an unknown state for the MDN Status on AS transactions that occurred prior to the upgrade This is a limitation of the migration procedures and utilities Servers fail to start after applying fixes The servers Dmgr NodeAgent and AppServers might fail to start if you have recently applied a fix or fix pack with th...

Page 188: ... is updated for example when a service pack is installed the caching data must be updated The updating of the cache is supposed to occur the first time a command is issued in a profile after a service pack is installed for example the startServer sh command However if there is an exception like one of the above then the cache is not updated is must be updated manually Correcting the shortcut ports...

Page 189: ...ception No more data to read from socket To resolve this issue install the Oracle 10g version of the JDBC driver This driver alleviates known incompatibilities between Oracle 9i and the WebSphere Application Server Messaging Engine For more details see 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 Oracl...

Page 190: ...B_INSTALL_HOME Receiver temp In this case the Hub will trigger an event 103205 with the following description Receiver Processing halted due to following reason failed to process target With Queue and File system unavailable Full Please make sure queue and disk system are available for processing and start the receiver If you get a message with the above description do the following 1 Make sure qu...

Page 191: ... Management Report Searching product specific information and so on ISA tool allows the customers to find necessary information 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 su...

Page 192: ...sactions this attribute has all the content types that are excluded from canonicalization To resolve the 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...

Page 193: ...eue depth is large enough so that it does not overflow See Appendix C component specific system attributes on page 223 for the list of attributes used to manage queue overflow Generating summary data About this task WebSphere Partner Gateway periodically summarizes data about system activity This Summary Service data is the information you see when you use the Document Analysis or Document Volume ...

Page 194: ...188 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 195: ...initialized please correct the problem and restart the service error reason 2 Critical BCG103201 Hub Owner State Engine Error Error Reason 0 Error This event is generated when a unrecoverable system occurs causing a document to fail processing An example can be a database write error BCG103203 Receiver Processing Error Receiver 0 1 failed to processing document error 2 Error This event is generate...

Page 196: ...ilure Document failed transformation due to 0 Error This event is generated because of a failure during document transformation BCG200006 Protocol Transformer Input File Failure Protocol transformer input file error 0 Critical This event is generated because of a failure with the input file during action processing for example when the file is corrupted BCG200007 Protocol Transformer Output File F...

Page 197: ...ocessor Critical This event is generated when a packager is not available for an outbound document BCG210008 IP Address Validation Failure From IP address is not in the partner profile 0 Error This event is generated when a document is posted from an IP Address that is not approved for that partner BCG210009 SSL Certificate Validation Failure Client SSL certificate name is not in the partner profi...

Page 198: ...the system failed to parse EDI routing information BCG210019 Synchronous Operation not Supported on this Connection Synchronous Operation not Supported on this Connection Error This event is generated when the document requests synchronous operation but the connection does not support synchronous operations BCG210031 Unable to Non Rep document Unable to Non Rep document 0 Critical This event is ge...

Page 199: ...ed when the system is unable to contact the database server during duplicate processing BCG210052 Duplicate Document Received This document appears to be a duplication of a document sent on 2 Error This event is generated when a document received is a duplicate and rejected BCG210061 Destination Parse Failure Error in destination Parse Critical This event is generated when destination parse fails ...

Page 200: ...bute set to Yes BCG230004 Validation Internal Error 0 Critical This event is generated because of an internal system failure during validation processing BCG230006 Validation Database Error 0 Critical This event is generated because of a database error during validation processing BCG230007 Validation Business Process Factory Error 0 Critical This event is generated when the system is unable to de...

Page 201: ...settaNet state Critical This event is generated when the unpackager encounters database communication errors when updating the RosettaNet state BCG240013 Partner Certificate Did Not Match Signer Name serial on signer certificate did not match database entry Error This event is generated when Certificate to DUNS check fails for digital signature BCG240014 Missing Signature in Document Signature not...

Page 202: ...ound Critical This event is generated when a valid certificate is not found When this event is displayed neither the primary nor the secondary certificate is valid The certificates might be expired or they might have been revoked If the certificates were expired or revoked you see the corresponding event Certificate revoked or expired in the Event Viewer along with the event BCG240033 No valid SSL...

Page 203: ...r 0 Error This event is generated when AS signature validation fails BCG240412 AS State Engine DB Failure AS State Engine DB error 0 Critical This event is generated when the AS state engine database fails BCG240415 AS Packager Failure AS Packager Error 0 Critical This event is generated when the AS packager fails BCG240416 AS Non Repudiation Error 0 Error This event is generated when AS Non Repud...

Page 204: ...ID 1 Error BCG240600 AS State Engine Error AS State Engine Error 0 Critical This event is generated when the RosettaNet State Engine encounters a system error BCG240601 AS Retry Failure AS Attribute max retry limit reached Error This event is generated when the system fails AS retries The maximum retry limit may have been reached BCG240606 Packaging Error Packaging error 0 Error BCG240610 Unpackag...

Page 205: ...der files in 0 reject and oversize folders for document 1 Error BCG281002 Console Resend Document Already In Queue Console resend document already in queue 0 Critical BCG310002 EDI Transaction Enveloped EDI Transaction Enveloped Envelope activity id 0 Error This event is generated when the EDI transaction document is enveloped The envelope activity id is that of the new envelope document BCG310003...

Page 206: ...nvalid input for component 0 Missing required property 1 Error BCGEDICM0004 Invalid Property Value Invalid input for component 0 Value 1 is invalid for property 2 Error BCGEDICM0005 Unsupported Character Set Invalid input for component 0 Character set 1 specified in property 2 is not supported Error BCGEDICM0006 Invalid Document Syntax for Component Invalid input for component 0 The document synta...

Page 207: ...nent An internal error occurred The object passed to component 0 was missing or invalid Error BCGEDICM0102 Class Load Failure A dynamically configured class could not be loaded Configuration key 0 Class name 1 Critical BCGEDICM0103 Invalid Function Parameter An internal error occurred in component 0 An invalid value 1 was passed to function 2 Error BCGEDICM0104 Invalid Source Document The source d...

Page 208: ...y Exception Details 0 Error BCGEDIEM0109 The temporary directory value provided for the receiver component is null The temporary directory value provided for the receiver component is null Error BCGEDIEM0110 The BusinessDoucument Array passed is null The BusinessDoucument Array passed is null Error BCGEDIEM0111 Input file is null The input file is null Error BCGEDIEM0112 A splitter exception was r...

Page 209: ... Parser Exception Occurred while trying to serialize the AbsDocument Error BCGEDIEM0203 Exception occurred while serializing AbsDocument Exception Occurred while trying to serialize the AbsDocument Error BCGEDIEM0204 Unable To Introduce Business Document Unable to Introduce Business Document with ID 0 back into workflow Error BCGEDIEM0205 Unable to find state information Unable to find state infor...

Page 210: ...r Total groups greater than number allowed by control number mask Error BCGEDIEV0054 Multiple Interchanges Error The 0 deenveloper detected an error Multiple interchanges were detected but not allowed Error BCGEDIEV0055 Translation Table Lookup Warning A translation table lookup returned no entry while enveloping a message Translation table 0 value 1 Error BCGEDIEV0056 Translation Table Lookup War...

Page 211: ...ception caught when reading script Error BCGEDIFT0117 Unexpected Exception Parsing FTP Script Unexpected exception caught while parsing FTP Script Contact your system administrator Further details about the exception and a stack trace can be found in the trace file Error BCGEDIFT0118 File Upload Failed Unable to upload file File name was 0 Error BCGEDIFT0119 No File for MPUT MPUT issued but no fil...

Page 212: ...ta Socket Is Null Data Socket is null Error BCGEDIFT0211 Load Private Key Failed Could not load private key file from filename 0 Alias not found Error BCGEDIFT0212 Client Certificate Validation Failed Client Certificate local certificate validation has failed certificate could be invalid or revoked Error BCGEDIFT0220 OPEN Command Failed OPEN command failed Reason 0 Error BCGEDIFT0221 CWD Command F...

Page 213: ...ata Syntax 0 Dictionary 1 Document 2 Exception text 3 Error BCGEDIMD0002 Metadata Control String Invalid The metadata control string is invalid or is compiled for a different version Syntax 0 Dictionary 1 Document 2 Error BCGEDIMD0003 Metadata Control String Read Failed The metadata control string could not be read from the database Syntax 0 Dictionary 1 Document 2 Error BCGEDINK0001 Invalid Netwo...

Page 214: ...Metadata Read Failed An attempt to get the metadata for the message failed Error BCGEDIUP0118 Character Encoding Error Error encoding 0 into character set 1 Error BCGEDIUP0021 Unable to Identify Input Data Record Unable to identify the input data record Record number was 0 Data Image 1 Error BCGEDIUP0023 Record Exceeded Maximum Repetitions specified The data received has exceeded the maximum repet...

Page 215: ...at 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 Z was expected in the first position 0 was received Byte offset was 1 Error BCGEDIUP0052 Unexpected Serialization Exception An unexpected exception occurred while serializing the document Exception text is 0 Error BCGEDIUP...

Page 216: ...0 has child nodes other than RECORD LOOP Error BCGEDIUP0109 Missing Record Name in Node NULL or empty RecordName found in RECORD node Error BCGEDIUP0110 Error Getting Metadata Information Unable to get RODMetaDataElement from MetaData for the record 0 Error BCGEDIUP0111 Empty Record Found Child Elements not found in MetaDataElement 0 Element Type RECORD Error BCGEDIUP0112 Unexpected Nodes Under Re...

Page 217: ...cess a control string instruction The control string instruction was 0 the instruction stream offset was 1 and the map name was 2 Error BCGEDIUT0023 Output Document Creation Failed An attempt to create an output document failed The root node name was 0 the syntax was 1 Error BCGEDIUT0033 User Specified Message Text User specified message text 0 This message was logged with severity code 1 and user...

Page 218: ... 0 is invalid or was compiled for a different version Error BCGEDIUT0403 Global Variable Not Found The global variable 0 was not found The map control string 1 could not be loaded Error BCGEDIUT0404 Global Variable has Invalid Initial Value The global variable 0 has an invalid initial value The map control string 1 could not be loaded Error BCGEDIUT0405 Unexpected Exception Reading Map Control Str...

Page 219: ...ding trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 control numbers 7 Element type 8 value 9 effective length 10 defined maximum length 11 Error BCGEDIVA0003 Data Element Too Short Data element is too short element name 0 segment name 1 segment position 2 sending trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 control numbers 7 Element type ...

Page 220: ...ier 4 5 receiving trading partner id qualifier 6 7 control numbers 8 Error BCGEDIVA0012 Failed Exclusive E Condition Failed exclusive E condition the standard defines items 0 as mutually exclusive but 1 are 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 BCGEDIVA0013 Failed Conditional C Condition...

Page 221: ...ment name 1 segment position 2 sending trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 control numbers 7 Error BCGEDIVA0016 Composite Data Element Maximum Repetitions Exceeded Composite element repeats more times than defined by standard element name 0 segment name 1 segment position 2 sending trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 c...

Page 222: ...egment 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 BCGEDIVA0032 Invalid Real Numeric Element Invalid real numeric element element name 0 segment name 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 ...

Page 223: ...fier 5 6 control numbers 7 Repetition number 8 maximum defined repetitions 9 Error BCGEDIVA0050 Too Many Elements or Unexpected Element in Segment Too many elements or unexpected element in segment element name 0 segment name 1 segment position 2 sending trading partner id qualifier 3 4 receiving trading partner id qualifier 5 6 control numbers 7 Error BCGEDIVA0051 Unrecognized Segment Id Unrecogn...

Page 224: ...ng partner id qualifier 2 3 receiving trading partner id qualifier 4 5 control numbers 6 Repetition number 7 maximum defined repetitions 8 Error BCGEDIVA0101 Transaction Set or Message Control Numbers Mismatch Transaction set or message control numbers do not match in header and trailer group header control number 0 group trailer control number 1 sending trading partner id qualifier 2 3 receiving ...

Page 225: ... trading partner id qualifier 4 5 control numbers 6 Error BCGEDIVA0152 Functional Group Trailer Missing or Invalid Functional group trailer missing or invalid functional control number 0 sending trading partner id qualifier 1 2 receiving trading partner id qualifier 3 4 control numbers 5 Error BCGEDIVA0153 Functional Group Trailer Count Invalid Functional group trailer contains invalid transaction...

Page 226: ...ge count interchange header control number 0 sending trading partner id qualifier 1 2 receiving trading partner id qualifier 3 4 Value from trailer 5 actual number received 6 Error BCGEDIVA0211 Duplicate Interchange Duplicate interchange detected interchange header control number 0 sending trading partner id qualifier 1 2 receiving trading partner id qualifier 3 4 Error BCGEDIVA0981 User specified...

Page 227: ...ary 0 document type 1 syntax 2 Error BCGEDIVA0994 Empty Transaction Set or Message EDI transaction set or message is empty Error BCGEDIVA0995 Fatal Parser Error Fatal parser error encountered Error BCGEDIVA0997 Unknown Flow Direction Unknown flow direction 0 specified Error BCGEDIVA0998 Unsupported Syntax Type Unsupported syntax type 0 specified Error BCGEDIVA0999 Unknown Object Received Unknown o...

Page 228: ...222 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 229: ...cedence over the value configured in the WebSphere Partner Gateway Console For detailed information about WebSphere environment variables see the WebSphere Application Server documentation To create a WebSphere Application Server ND environment variable perform the following steps 1 Open your WebSphere Application Server Admin Console 2 Navigate to Environment WebSphere Variables 3 From the menu s...

Page 230: ...rRoleClassificationCode 0 To partner Role toRole 0 PartnerRoleDescription 0 PartnerDescription 0 BusinessDescription 0 GlobalBusinessIdentifier 0 To partner Business ID toRole 0 PartnerRoleDescription 0 PartnerDescription 0 GlobalPartnerClassificationCode 0 To partner Classification Code toRole 0 PartnerRoleDescription 0 PartnerDescription 0 BusinessDescription 0 GlobalSupplyChainCode 0 To partner...

Page 231: ...data connection class Class that handles the Data connection bcg ftp config listeners default data connection idle time Connection idle time in seconds bcg ftp config listeners default data connection active enable If active connection is enabled for this listener bcg ftp config listeners default data connection active local address Local address to listen to in active connections bcg config liste...

Page 232: ...s clientauth data connection class Class that handles the Data connection bcg ftp config listeners clientauth data connection idle time Connection idle time in seconds bcg ftp config listeners clientauth data connection active enable If active connection is enabled for this listener bcg ftp config listeners clientauth data connection active local address Local address to listen to in active connec...

Page 233: ...me Description bcg config ftpserver FTPSerializeFileInterval It is the interval in milliseconds after which the accumulated events are serialized to the file system bcg config ftpserver eventPersistThreads Pool of threads to perform database updates bcg config ftpserver FTPEventThreshold Maximum number of FTP events that can be accumulated before persisting in database or file system bcg config ft...

Page 234: ... AS state engine Table 59 on page 239 v Attributes used to configure the business process engine BPE Table 60 on page 239 v Attributes used to configure processing of signals Table 61 on page 240 v Attributes used to configure synchronous processing by the BPE and Document Acquisition Engine DAE Table 62 on page 240 v Attributes used to configure the delivery manager Table 63 on page 241 v Attribu...

Page 235: ... Entry Default value Possible settings Description bcg ldap containerauth False Boolean True or False When the Boolean value is set to True it indicates that the users are authenticated using the WebSphere Partner Gateway local database Or if the Boolean value is set to False an enterprise user registry is accessed using JAAS bcg ldap jaaslogin WSLogin String containing login ID Specifies the name...

Page 236: ...ring containing either FileSystem or JMS Determines the document routing transport for moving documents internally from the receiver to the Document Manager bcg global common introduce document transport unavailable timeout 60000 Positive integer When JMS transport is used for internal routing between the receiver and Document Manager this is the timeout value that determines whether an error has ...

Page 237: ... Integer CRLs and VTP certificates are reloaded periodically after this interval which is in milliseconds Despite its name including Rosettanet this attribute applies to all protocols bcg certs vtp CertificateDir Hub install root common security vtp String with a file directory path Directory that contains certificates used for VTP signature validation and encryption This value should match the va...

Page 238: ...sND Profiles bcgprofile logs bcgdocmgr The default name of the trace file is bcg_router log traceLevel Transformation 0 Integer between 0 and 2 See the description for traceLevel All traceLevel Validation 0 Integer between 0 and 2 See the description for traceLevel All traceLevel Enveloper 0 Integer between 0 and 2 See the description for traceLevel All traceLevel Deenveloper 0 Integer between 0 a...

Page 239: ...BMVanAckProcessor 0 Integer between 0 and 2 See the description for traceLevel All traceLevel EDIAckProcessor 0 Integer between 0 and 2 See the description for traceLevel All traceLevel Utility 0 Integer between 0 and 2 See the description for traceLevel All transcript file option N Y or N If the option Y is selected then transcript files are generated in the current working directory specified un...

Page 240: ...of characters that cannot be used in some of the fields that are configured using the console These are used for validation of partner login data and receiver and destination gateway data that is entered on the console Note For Internationalization purposes you may want to change these values depending on the language of the OS and what is specified for directory names bcg console specialCharsDir ...

Page 241: ...name The default setting has Internet Assigned Numbers Authority values for many of the most commonly used encodings bcg console help host localhost Host name or IP address The host name or IP address of the help system server used by the console bcg console help port 58080 Integer port number The port on the help system server that is used to obtain help bcg console version Version 6 2 0 0 273 St...

Page 242: ... Internal setting that affects inter component communications This is for IBM use only bcg oaq_log_q jms bcg queue datalogQ JNDI name Internal setting that affects inter component communications This is for IBM use only Table 57 Attributes used to configure the RosettaNet simulator Entry Default value Possible setting Description bcg console certs vtp CertificateDir Hub install root common securit...

Page 243: ... is used to pass documents to the Document Manager Table 58 Attributes used to configure the alert engine Entry Default value Possible setting Description bcg alertQReceiver maxRetries 100 Integer Maximum number of retries attempted by the alert receiver bcg alertQReceiver retryInterval 60000 Integer Interval in milliseconds between each retry bcg volumeAlertScheduler allowanceForProcessingReceive...

Page 244: ...reply to address for alert notifications bcg alertNotifications mailEnvelopeFrom unknown unknown com e mail address The e mail address to use for replies in the event of an incorrect e mail addresses bcg alert eventGenerator schedule 13 1 CertificateExpiration Integer minutes Integer hours Alert name Multiple records should be separated by the character Entries of each record consists of first int...

Page 245: ...in folder bcg dae main maxfiles perPass 5 Integer Maximum number of files to process per main folder poll interval bcg docmgr channelCache maxSize 20 Integer When a document is processed a Partner Connection is looked up for the document This Partner Connection configuration information is cached in the runtime The maximum number of Partner Connections that can be cached at any one time is determi...

Page 246: ...ds between directory scans bcg in_thread_count signal 2 Integer Number of inbound threads for signal router bcg inbound_files_per_pass signal 5 Integer Maximum number of files to pick up in a scan Table 62 Attributes used to configure synchronous processing by the BPE and document acquisition engine DAE Entry Default value Possible setting Description bcg dae synchronous maxLockAge 180000 Integer ...

Page 247: ...threadPoolMaxThreads 50 Integer Maximum size of the thread pool used by the delivery manager bcg delivery gatewayMaxThreads 20 Integer Maximum number of gateway threads bcg delivery gwTransportMaxRetries 3 Integer Number of retries that will be attempted by the delivery manager for each destination level retry This is a global setting that applies to all destinations gateways Each destination is a...

Page 248: ... IBM use only bcg jms topic factory jms bcg cf DOCMGRCF JNDI name Internal setting that affects inter component communications This is for 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 use only bcg jms context_url corbaloc iiop localhost 58809 URL Internal setting that affe...

Page 249: ...se only bcg delivery queue jms bcg queue deliveryManagerQ JNDI name Internal setting that affects inter component communications This is for IBM 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 compon...

Page 250: ...e content types will not be base64 encoded Wbipackaging_version 1 1 0 and 1 1 This is used for building the Backend Integration XML packaging transport envelope Version 1 0 is for version 4 2 2 FP1 and earlier Version 1 1 is for 4 2 2 FP2 and later Version 1 1 contains the content ID associated with attachments DBProcDebug 1 Integer either 0 or 1 A binary setting using 0 and 1 to turn database deb...

Page 251: ...lt value is TRUE bcg rosettanet mimeBoundaryValidate FALSE String Boolean value TRUE or FALSE If this value is set to TRUE structural validation of mime multipart Rosettanet message is performed Default value is FALSE bcg rosettanet globalUsageCode Literal String value of Literal or anything else If this value is Literal we expect the x aux production HTTP header to literally be Production or Test...

Page 252: ...und_poll_interval 10000 Integer RosettaNet engine polling interval in milliseconds bcg rne in_thread_count 2 Integer Number of threads used by the RosettaNet engine to process inbound documents bcg rne work_size 50 Integer The number of PIP messages processed per poll interval bcg 0A1 fromContactName ROUTER CONTACT_NAME String Name of the 0A1 contact bcg 0A1 fromEMailAddr ROUTER CONTACT MAIL_FROM ...

Page 253: ...rc2 40 Encryption algorithm used for RosettaNet messages This Property is applicable to all protocols Table 68 Attributes used to configure JMS for the receiver component Entry Default value Possible setting Description bcg jms queue factory jms bcg cf RCVRCF JNDI name Internal setting that affects inter component communications This is for IBM use only bcg jms topic factory jms bcg cf RCVRCF JNDI...

Page 254: ...ibutes used to configure the directory names used by the receiver component Entry Default value Possible setting Description bcg receiver configpath Hub install root common receiver config String with directory path Receiver configuration XML file location used when Database is not available bcg vms_receiver_reject_dir Hub install root common receiver reject String with directory path Receiver rej...

Page 255: ...enerate the event notification documents bcg sponsor work_size 10 Integer Number of rows per pass that are fetched from the database for generating the event notification documents Table 74 Attributes used to configure the archiver subcomponent of the Document Manager Entry Default value Possible setting Description bcg archiver maxSubVolFiles 70000 Integer Maximum number of sub volumes under a vo...

Page 256: ...l cause all incoming ebXML messages to be validated Table 76 Attributes used to configure the reliable messaging subcomponent of the Document Manager Entry Default value Possible setting Description bcg rm pollInterval 300000 Integer Time interval in milliseconds that determines how often reliable message service processing occurs bcg rm thread_count 3 Integer The number of threads used by the rel...

Page 257: ... Default value Possible setting Description bcg archive maxThreads 4 Integer Archiving of files is multithreaded and a new property bcg archive maxThreads is introduced in WebSphere Partner Gateway 6 2 with a default value of four This value specifies the maximum number of threads that is allowed while archiving Table 80 Attributes to configure WebSphere Transformation Extender properties Entry De...

Page 258: ...252 IBM WebSphere Partner Gateway Enterprise and Advanced Editions Administration Guide ...

Page 259: ...rporation Licensing 2 31 Roppongi 3 chome Minato ku Tokyo 106 0032 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF NON I...

Page 260: ...ished announcements or other publicly available sources IBM has not tested those products and cannot confirm the accuracy of performance compatibility or any other claims related to non IBM products Questions on the capabilities of non IBM products should be addressed to the suppliers of those products All statements regarding IBM s future direction or intent are subject to change or withdrawal wi...

Page 261: ...on is provided to help you debug your application software Attention Do not use this diagnosis modification and tuning information as a programming interface because it is subject to change Trademarks and service marks The following terms are trademarks or registered trademarks of International Business Machines Corporation in the United States or other countries or both IBM the IBM logo AIX CICS ...

Page 262: ...ere 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 ...

Page 263: ...isabling 53 managing 49 viewing and editing 52 Changing connection configurations 57 destination status 88 partner attribute values 57 the source or target destination 58 ClassNotFoundException 167 Collating data 160 Community Console icons 16 logging in 15 logging out 18 navigating through 16 Components connections 54 Configuration validate webserivces 38 Configurations changing connection 57 del...

Page 264: ...ons report 99 FTP Statistics report 99 FTPScripting 166 G Generating summary data 187 H Handlers configuring content type 26 deleting 26 importing 26 managing 25 Hub administrator tasks 19 configuring Document Definitions and download packages 23 configuring receivers 22 deleting receivers 23 enabling or disabling actions 25 enabling or disabling receivers 22 handlers configuring content type 26 d...

Page 265: ... 94 400 series 94 500 series 95 Web Server 93 Retries destination 46 transport 46 RosettaNet Viewer description 107 document processing details 108 search criteria 107 searching for processes 107 viewing process details 108 S Saving event code names 21 Search advanced for connections 56 basic for connections 56 ebMS processes 118 for events 102 for messages AS Viewer 105 for RosettaNet processes 1...

Page 266: ...cument Manager 179 StringIndexOutofBounds 166 tab headings 183 TCPC0003E 176 threads hanging 179 VCBaseException 178 WebSphere Application Server shortcut 182 Typographic conventions 2 U Updating maps 27 Uploading CPA 36 transports 46 URI restriction 168 Using the Destination Queue 85 V Validation errors viewing 115 Values 105 107 Document Viewer 111 112 Test Partner Connection 93 Viewers AS Viewe...

Page 267: ......

Page 268: ... Printed in USA ...

Reviews: