Setting up the sample involves setting up Business Integration Connect,
WebSphere MQ, and WebSphere Interchange Server. The following sections
describe how to do this.
The following procedure describes how to set up Business Integration
Connect so that it has the settings and resources it needs to run all the
scenarios of the PIP sample. The setup for System B and C is the same
except where noted.
- Start Business Integration Connect and log in to the Community Console as
Hub Admin.
- Create a Community Manager profile to represent Business Integration
Connect and a Community Participant profile for the other system. For
example, on System B, you create a Community Participant profile for System
C. For information on creating profiles, see the Administrator
Guide.
- Create the gateways for the profiles:
See the Administrator guide for more information on creating
gateways.
- Click Account Admin > Profiles > Community
Participant.
- Search for the Community Manager profile you created.
- Select the profile and click Gateways.
- In the Gateway List section, click Create.
- In the Gateway Detail section, type or select the following values:
Use the default values for all other parameters.
Table 8. Community Manager gateway values
Parameter
| Value to type or select
|
Gateway name
| Type any name for the gateway
|
Transport
| JMS
|
Target URI
| Type the context URL such as file:///export/jndi/myctx
|
JMS Factory Name
| Type the name of the JMS factory
Example: myqcf
|
JMS Queue Name
| Type the name of the JMS queue
Example: SENDERQ
|
JMS JNDI Factory Name
| Type the name of the JNDI factory for JMS
Example:
com.sun.jndi.fscontext.RefFSContextFactory
|
JMS Message Class
| Type the JMS Message Class Example: TextMessage
|
- Note:
- Refer to the Integration Overview guide for more information on
back-end configuration using JMS with WebSphere MQ 5.3.
- Click Save.
- Create the gateway for the Community Participant in the same way but use
the following values for the Gateway Detail section:
Table 9. Community Participant gateway values
Parameter
| Value to type or select
|
Gateway name
| Type any name for the gateway
|
Transport
| HTTP/1.1
|
Target URI
| Type the URL for the other Business Integration Connect system.
That is, if you are creating System B, type the URL for System C.
Example: http://<IPAddress of System
C:57080>/bcgreceiver/submit/test
|
For the other parameters, use the default values.
- Click Save.
- Set the gateways as default gateways:
- Click Account Admin > Profiles > Community
Participant.
- Search for the Community Manager profile you created.
- Select the profile and click Gateways.
- In the Gateway List section, click View Default
Gateways.
- For all of the gateway types, select the gateway you created.
- Set the default gateways for the Community Participant profile in the same
way.
- Upload the following PIP document flow packages:
- Package_RNIF_V02.00.zip
- Package_RNSC_1.0_RNIF_V02.00.zip
- BCG_Package_RNIFV02.00_3A4V02.02.zip
- BCG_Package_RNIFV02.00_3C3V01.01.zip
- BCG_Package_RNIFV02.00_0A1V02.00.zip
- BCG_Package_RNSC1.0_RNIFV02.00_3A4V02.02.zip
- BCG_Package_RNSC1.0_RNIFV02.00_3C3V01.01.zip
- BCG_Package_RNSC1.0_RNIFV02.00_0A1V02.00.zip
See "Uploading packages" in the Administrator Guide for
information on uploading packages. If packages for the other RNIF
version or another version of the PIP have already been loaded, set the
Overwrite Data parameter to Yes.
You can verify that the packages have been uploaded by clicking Hub
Admin > Hub Configuration > Document Flow Definition. Click
All and look for the following in the RNIF (V02.00) and
Backend Integration packages:
- Document Flow: 3A4 (V02.02)
- Document Flow: 3C3 (V01.01)
- Document Flow: 0A1 (V02.00)
- Create interactions for the PIPs:
- Click Hub Admin > Hub Configuration > Document Flow
Definition.
- In the Manage Document Flow Definitions screen, click Manage
Interactions.
- In the Manage Interactions screen, click Create
Interaction.
- Expand the Document Flow Definition trees by clicking All in
the Source tree and in the Target tree.
- In the Source tree, select the radio button for Action:
Purchase Order Request Action in the following context:
Package: RNIF (V02.00)
Protocol: RosettaNet (V02.00)
Document Flow: 3A4 (V02.02) "Request Purchase Order"
Activity: Request Purchase Order
- In the target tree, select the radio button for Action:
Purchase Order Request Action in the following context:
Package: Backend Integration (1.0)
Protocol: RNSC (1.0)
Document Flow: 3A4 (V02.02) "Request Purchase Order"
Activity: Request Purchase Order
- In the Action field, select Bi-directional Translation of RosettaNet
and RosettaNet Service Content with Validation.
- Click Save.
- Repeat steps a-h to create an interaction in the other direction.
That is, the RNIF Package is the target and the Backend Integration package is
the source.
- Repeat steps a-i to create interactions for the following actions:
- 3A4 Purchase Order Confirmation Action.
- 3C3 Invoice Notification Action
- 0A1 Failure Notification Action
- Create an interaction for XMLEvent.
- Click Hub Admin > Hub Configuration > Document Flow
Definition.
- In the Manage Document Flow Definitions screen, click Manage
Interactions.
- In the Manage Interactions screen, click Create
Interaction.
- Expand the Document Flow Definition trees by clicking All in
the Source tree and in the Target tree.
- In the Source tree, select the radio button for Document Flow:
XMLEvent (1.0) in the following context:
Package: Backend Integration (1.0)
Protocol: XMLEvent (1.0)
- In the Target tree, select the radio button for Document Flow:
XMLEvent (1.0) in the following context:
Package: Backend Integration (1.0)
Protocol: XMLEvent (1.0)
- In the Action field, select Pass Through.
- Click Save.
- Create an interaction for XMLEvent to 0A1 RNSC.
- Click Hub Admin > Hub Configuration > Document Flow
Definition.
- In the Manage Document Flow Definitions screen, click Manage
Interactions.
- In the Valid Document Flow Interactions screen, click Create
Interaction.
- Expand the Document Flow Definition trees by clicking All in
the Source tree and in the Target tree.
- In the Source tree, select the radio button for Document Flow:
XMLEvent (1.0) in the following context:
Package: Backend Integration (1.0)
Protocol: XMLEvent (1.0)
- In the target tree, select the radio button for Action: Failure
Notification Action in the following context:
Package: Backend Integration (1.0)
Protocol: RNSC (1.0)
Document Flow: 0A1 (V02.00) "Notification of Failure"
Activity: Distribute Notification of Failure
- In the Action field, select Bi-directional Translation of RosettaNet
and xml with validation.
- Click Save.
- Create targets for the transport protocols:
- Click Hub Admin > Hub configuration > Targets.
- Click Create.
- In the Target Name field, type a name.
- In the Transport field, select HTTP/S.
- In the Target Configuration section, type the URI for the Receiver that
handles HTTP messages such as /bcgreceiver/Receiver.
- Select the appropriate Gateway Type. (Example:
Production).
- Click Save.
- Click Hub Admin > Hub configuration > Targets.
- Click Create.
- In the Target Name field, type a name.
- In the Transport field, select JMS.
- In the Target Configuration section, type the appropriate values for the
following fields:
- JMS Provider URL
Example: file:///export/jndi/myctx
- JMS Queue Name
Example: RECEIVERQ
- JMS Factory Name
Example: myqcf
- JNDI Factory Name
Example:
com.sun.jndi.fscontext.RefFSContextFactory
- Note:
- Refer to the Integration Overview guide for more information on
back-end configuration using JMS with WebSphere MQ 5.3.
- Select the appropriate Gateway Type. (Example:
Production).
- Click Save.
- Refer to the Administrator's guide for information on enabling
security.
- Enable the B2B capabilities for the profiles.
- Click Account Admin > Profiles > Community
Participant.
- Search for the Community Manager profile you created.
- Select the profile and click B2B Capabilities.
- Expand the Document Flow Definition tree by clicking
All.
- Ensure that the Community Manager has the B2B capabilities for the RNIF
(V02.00) and Backend Integration (1.0) packages enabled.
If the packages are inactive (neither enabled or disabled), active them by
clicking the icon in the Set Source and Set Target columns.
- Repeat the previous step for the RosettaNet (V02.00) protocol under
the RNIF (V02.00) package and the XMLEvent (1.0) and RNSC
(1.0) protocols under the Backend Integration (1.0)
package. Do the same for the following Document Flows:
- Document Flow: XMLEvent (1.0) under Protocol: XMLEvent
(1.0)
- Document Flow: 3A4 (V02.02) under Protocol: RNSC
(1.0)
- Document Flow: 3C3 (V01.01) under Protocol: RNSC
(1.0)
- Document Flow: 0A1 (V02.00) under Protocol: RNSC
(1.0)
- Document Flow: 3A4 (V02.02) under Protocol: RosettaNet
(V02.00)
- Document Flow: 3C3 (V01.01) under Protocol: RosettaNet
(V02.00)
- Document Flow: 0A1 (V02.00) under Protocol: RosettaNet
(V02.00)
- Repeat a-f for the Community Participant profile.
- Create Participant Connections.
- Click Account Admin > Participant Connections.
- In the Source, select the Community Manager profile.
- In the Target, select the Community Participant profile.
- Click Search.
- Click Activate for the following interaction:
Table 10.
Source
| Target
|
Package: Backend Integration (1.0) Protocol: XMLEvent
(1.0) Document Flow: XMLEvent (1.0)
| Package: Backend Integration (1.0) Protocol: RNSC
(1.0) Document Flow: 0A1 (V02.00) Activity:
Distribute Notification of Failure (N/A)
|
- Enable all other interactions on the screen.
- In the Source, select the Community Participant profile.
- In the Target, select the Community Manager profile.
- Click Search.
- Click Activate for the following interaction:
Table 11.
Source
| Target
|
Package: Backend Integration (1.0) Protocol: XMLEvent
(1.0) Document Flow: XMLEvent (1.0)
| Package: Backend Integration (1.0) Protocol: XMLEvent
(1.0) Document Flow: XMLEvent (1.0)
|
- Enable all other interactions on the screen.
To set WebSphere MQ to support the sample, create the following queues in
the Queue Manager:
- CWLD_Unsubscribed
- CWLD_InProgress
- CWLD_Result
- CWLD_Error
- The input queue that the JMS connector polls for incoming messages.
- The output queue that the JMS connector uses for outbound messages.
Consult the WebSphere MQ documentation for information on how to create the
queues.
The following procedure describes how to set up WebSphere Interchange
Server so that it has the settings and resources it needs to run all the
scenarios of the PIP sample. For more information on any of the steps
in the procedure, see the WebSphere Interchange Server documentation.
- Once the WebSphere Interchange Server is running, start the system manager
and create an integration component library (ICL).
- Import the contents of the ICS Repository into the newly created
ICL.
- Create the Database Connection Pool at Initiator side:
- Create a database for Requestor and create the RNState table using the
BCG_pip_sample_table_creation.sql script.
- In the ICL, right click the Database Connection Pool folder and select
Create new Database Connection Pool.
- Specify the database, database driver (DB2), DBConnection name, login,
password, and maximum number of connections.
- In the new connection pool section, right click and select New
Connection Pool.
- Specify the name of the pool as CWLDPool and set the minimum number of
connections to 1.
- Click OK and then click Finish to create the
Database Connection Pool.
- Create the Database Connection Pool at Responder side:
- Create second database for Responder and create the RNState table using
the BCG_pip_sample_table_creation.sql script.
- In the ICL, right click the Database Connection Pool folder and select
Create new Database Connection Pool.
- Specify the database, database driver (DB2), DBConnection name, login,
password, and maximum number of connections.
- In the new connection pool section, right click and select New
Connection Pool.
- Specify the name of the pool as CWLDPool1 and set the minimum number of
connections to 1.
- Click OK and then click Finish to create the
Database Connection Pool
- Create the Connectors:
- In the ICL, right click the Connectors folder and select Create new
connector.
- The Connector Configurator window appears. In the New Connector
panel, select Cancel.
- Select File > Open > From File.
- In the File Open dialog, select the connector configuration file for the
JMS Connector and click Open.
- Repeat a-d to create the Port Connector.
- Open the JMS Connector and select File > Save As > To
Project. Save a copy of the JMS Connector using the name
JMSConnector1.
- Configuring the JMS Connectors
- In the ICL, open the Connectors folder and double-click the JMS
Connector.
- In the Connector Configurator window, select the Connector-Specific
Properties tab.
- Set values for the following attributes:
Table 12.
Attribute
| Value
|
CTX_InitialContextFactory
| com.sun.jndi.fscontext.RefFSContextFactory
|
ReplyToQueue
| The name of the queue in which the JMS Connector puts the messages
|
UnsubscribedQueue
| CWLD_Unsubscribed
|
CTX_ProviderURL
| The URL of the JMS context provider
|
InProgressQueue
| CWLD_InProgress
|
DataHandlerConfigMO
| MO_DataHandler_Default
|
MessageResponseResultProperty
| CWLD_Result
|
DataHandlerMimeType
| Attachment
|
QueueConnectionFactoryName
| The queue connection factory created in WebSphere MQ
|
ErrorQueue
| CWLD_Error
|
InputQueue
| The name of the queue that the JMS Connector polls for incoming messages
|
- Select the Supported Business Objects tab.
- Select the following Business Objects from the list and enable Agent
Support for each one:
- BCG_Pip3A4PurchaseOrderRequest
- BCG_Pip3A4PurchaseOrderConfirmation
- BCG_Pip3C3InvoiceNotification
- BCG_Pip0A1FailureNotification
- BCG_EventNotification
- MO_DataHandler_Default
- Select the Trace/Log Files tab and configure the log and trace
files.
- Repeat a-f for JMSConnector1
- In the MO_DataHandler_Default business object, add the Attachment
attribute and set its BO Type as
MO_DataHandler_DefaultAttachmentConfig.
- Configure the Port Connector:
- In the ICL, open the Connectors folder and double-click the Port
Connector.
- In the Connector Configurator window, select the Supported Business
Objects tab.
- Select the following Business Objects from the list and enable Agent
Support for each one:
- BCG_Pip3A4PurchaseOrderRequest
- BCG_Pip3A4PurchaseOrderConfirmation
- BCG_Pip0A1FailureNotification
- BCG_Pip3C3InvoiceNotification
- BCG_EventNotification
- Select the Trace/Log Files tab and configure the log and trace
files.
- Compile the collaboration templates by right clicking the Collaboration
Templates folder and selecting Compile All.
- Create the collaboration objects
- Right-click the Collaboration Objects folder and select Create new
collaboration object.
- Select the template and provide a name for the collaboration object
name. Click Next.
- Bind the ports with the appropriate connectors given in the following
table:
Table 13. Port-connector bindings for BCG_Pip3A4_Request collaborations
Port
| Connector
|
RequestFromBackend
| PortConnector
|
RequestToWBIC
| JMSConnector
|
EventToWBIC
| JMSConnector
|
EventFromBackend
| PortConnector
|
ResponseFromWBIC
| JMSConnector
|
ResponseToBackend
| PortConnector
|
- Click Next.
- Specify the e-mail notification address, set the system trace level to 2,
and set the collaboration trace level to 5. Click
Next.
- Specify values for the following collaboration properties, using the
default values where available:
- DB_CONN_POOL_NAME
- ATTACHMENT_FILE_DIR
- Click 'Finish' to complete creation of collaboration
object.
- Repeat a-g for the following collaborations
Table 14. Port-connector bindings for BCG_Pip3A4_Response collaborations
Port
| Connector
|
RequestFromWBIC
| JMSConnector1
|
RequestToBackend
| PortConnector
|
EventFromBackend
| PortConnector
|
EventFromWBIC
| JMSConnector1
|
ResponseFromBackend
| PortConnector
|
ResponseToWBIC
| JMSConnector1
|
Table 15. Port-connector bindings for BCG_Pip3C3_Notifier collaborations
Port
| Connector
|
RequestFromBackend
| PortConnector
|
RequestToWBIC
| JMSConnector
|
EventToWBIC
| JMSConnector
|
EventFromBackend
| PortConnector
|
Table 16. Port-connector bindings for BCG_Pip3C3_Receiver collaborations
Port
| Connector
|
RequestFromWBIC
| JMSConnector1
|
RequestToBackend
| PortConnector
|
EventFromBackend
| PortConnector
|
EventFromWBIC
| JMSConnector1
|
Table 17. Port-connector bindings for BCG_0A1FailureNotification collaboration for Requestor
Port
| Connector
|
NOFFromWBIC
| JMSConnector
|
NOFToBackend
| PortConnector
|
EventFromWBIC
| JMSConnector
|
EventToBackend
| PortConnector
|
Table 18. Port-connector bindings for BCG_0A1FailureNotification collaboration for Responder
Port
| Connector
|
NOFFromWBIC
| JMSConnector1
|
NOFToBackend
| PortConnector
|
EventFromWBIC
| JMSConnector1
|
EventToBackend
| PortConnector
|
- Note:
- Two 0A1 Failure Notification collaboration objects are needed; one for
the initiator side and another for the responder side.
Initiator side 0A1 collaboration: One end connects to the
buyer's back-end system and the other end connects to Business
Integration Connect through WebSphere BI adapters, i.e.
JMSConnector.
Receiver/Responder side 0A1 collaboration: One end connects
to the receiver's back-end system and the other end connects to Business
Integration Connect through WebSphere BI adapters, i.e.
JMSConnector1. Change the value of the property
DB_CONN_POOL_NAME to CWLDPool1.
- Deploy the ICL into the ICS Repository
- Open the User Projects folder.
- Right-click Interchange Server Projects and select New User
Project.
- Type a name for the project.
- In the Available Integration Component Libraries drop down list, select
the ICL you created.
- Click Finish. This associates the project with the
ICL.
- In InterChange Servers, connect to the ICS Server.
- Right-click the server name and select Add User Project.
Select the project you created.
- Right-click the server name and select Deploy Projects.
- Select the entire project and click Next.
- Click Next.
- Select the folder for the project and click Finish. This
deploys the project on the server.
- Restart the Interchange Server.
- In a DB2 command window, run the DB creation scripts
(db2RNtable_create.sql).
- Verify that the scripts created the RNState table.
- Start the JMS adapters. Ensure that the JMS queues are properly
configured. Consult the adapter configuration guide for details.
- Start Monitor.exe and verify that the collaborations and connectors
are active.
To run Scenario 1, do the following:
- Start the VT connector and define a profile for the Port Connector.
Select File > Connect Agent to begin simulating the
agent.
- Load the sample 3A4 request object (PIP3A4Request.bo) and update
the following fields in the test BO:
- Send it in asynchronous mode.
- Open the log viewer and load the Interchange Server trace file.
Search for the following text:
Collaboration Success: Collaboration Name {The collaboration
name}, Scenario Name SendRequest, BLOCK Name SendBO.
This indicates that the 3A4 request has been successfully posted to the JMS
connector.
- Verify that the Business Integration Connect on the buyer's side has
received the 3A4 request and sent it to the Business Integration Connect
instance configured as the seller's gateway.
- The Port Connector receives the 3A4 request message. This is the
3A4 request at the seller's back-end process. Select the request
and click Reply success.
- Load the 3A4 response object (PIP3A4Response.bo) and update the
following fields in the test BO:
- Send it in asynchronous mode.
- Open the log viewer and load the Interchange Server trace file.
Search for the following text:
Collaboration Success: Collaboration Name {The collaboration
name}, Scenario Name SendResponse, BLOCK Name SendBO.
The Port Connector receives the 3A4 response message is received in the
Port Connector. This is the 3A4 response at the buyer's back-end
process. Select the response and click Reply success.
To run Scenario 2, run Scenario 1 and then do the following:
- Load the PIP3A4Cancel.bo and update the following fields in the
test BO:
- Send it in asynchronous mode.
- Open the log viewer and load the Interchange Server trace file.
Search for the following text:
Collaboration Success: Collaboration Name {The collaboration name},
Scenario Name SendEvent, BLOCK Name SendEvent.
This indicates the event message has been successfully posted to the JMS
connector.
- The buyer's Business Integration Connect instance receives the event
message. The instance sends a PIP 0A1 message to the seller's
gateway.
- The Port Connector receives the PIPA1 message.
To run Scenario 3, do the following:
- Start the VT connector and define a profile for the Port Connector.
Select File > Connect Agent to begin simulating the
agent.
- Load the sample 3C3 request object (PIP3C3Request.bo) with the URI
of the attachment or with a default attachment BO or both. Update the
following fields in the test BO:
- Send it in asynchronous mode.
- Open the log viewer and load the Interchange Server trace file.
Search for the following text:
Collaboration Success: Collaboration Name {The collaboration name},
Scenario Name SendRequest, BLOCK Name SendBO.
This indicates the 3C3 request has been successfully posted to the JMS
connector.
- Verify that the Business Integration Connect instance on the buyer's
side has received the 3C3 request and sent it to the trading partner (in this
case the Business Integration Connect instance configured as the seller's
gateway).
- The 3C3 request message must reach the responder's gateway and the
seller process. The collaboration at the seller side decodes the
attachment and writes it to a file mentioned in the collaboration properties,
and this URI is set in the business object and sent to back end.
- The Port Connector receives the 3C3 request message. This is the
3C3 request at the seller's back-end process. Select the request
and click Reply success.
