Using the Integration Point Viewer

This chapter describes the Integration Point Viewer and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding the Integration Point Viewer

The Integration Point Viewer is a read-only tool located in the Integration Point Viewer component (PT_IBPOINTVIEWER) that enables you to display a point-to-point view of an integration to validate its structure and confirm that the objects that comprise it are active.

Depending on the how the integration is set up and the transaction type, the Integration Point Viewer provides direct links to the node definition, the transaction and the relationship where you can view additional information and make modifications.

Click to jump to top of pageClick to jump to parent topicAccessing Integrations

To access an integration using the Integration Point Viewer, select PeopleTools, Integration Broker, Integration Setup, Integration Point Viewer.

Initially, the search section of the Integration Broker Point Viewer page displays where you enter criteria for the integration to view.

After you enter the search criteria and click the View button, summary information for the transaction displays.

Click to jump to top of pageClick to jump to parent topicCommon Elements Used to Access Integration Points

Click the View button to view an integration based on the criteria entered in the Integration Point Viewer.

Click the Clear button to clear the integration search criteria or the summary information for the displayed integration.

Click to jump to top of pageClick to jump to parent topicAccessing Integration Points

To access an integration point:

  1. Select PeopleTools, Integration Broker, Integration Setup, Integration Point Viewer.

  2. In the Sender Node field, select the sending node.

  3. From the Transaction Type drop-down list, select the type of transaction. The valid values are:

  4. In the Receiver Node field, select the receiving node.

  5. In the Request Message field, select the name of the request message.

    Integration Point Viewer displays a list of messages from which you can select, based on the node and transaction type selected.

  6. In the Request Message Version field, select the version of the request message.

  7. Click the View button to access and view the integration point.

Click to jump to top of pageClick to jump to parent topicViewing Integration Information

After you enter the details about an integration and click the View button, the Integration Point Viewer displays summary information about the integration.

When viewing information for asynchronous integration points, view the information from top to bottom. When viewing information for synchronous and asynchronous-to-synchronous integration points, view the information in a u-shape fashion, starting at the top left-side of the page, reading downward to the bottom, rightward across the bottom of the page, and then upward on the right-side of the page.

Click to jump to top of pageClick to jump to parent topicCommon Elements Used to View Integration Point Information

Go to Inactive Objects Page

This link displays when one or more objects associated with an integration are inactive.

Click the link to open the Inactive Objects page to view and activate any inactive objects.

Note. If any object associated with an integration is inactive, the status of the integration in Inactive.

Go to Node Transaction

Click this link to open the Transaction Detail page for the node. The Transaction Detail page opens in a separate window, where you can view and change information about the transaction, such as its effective date, status, routing type, connector overrides, and so on.

When you are done working with the information, save any changes and click the Close button at the top right corner of the window.

Go to Transaction Modifier

Click this link to open the Trans Modifiers page for the relationship. The Trans Modifiers page opens in a separate window, where you can view and change information about the relationship.

When you are done working with the information, save any changes and click the Close button at the top right corner of the window.

Click to jump to top of pageClick to jump to parent topicViewing Asynchronous Integration Point Information

This section discusses viewing integration point information for asynchronous integration points.

The integration point information in the previous graphic shows and that QE_LOCAL is the sending node and the receiving node is QE_REMOTE. Since the sending node is the local node and the receiving node is a remote node, this is an outbound asynchronous integration point.

The page shows the following about the outbound request:

  1. The box labelled 1. Request Message shows the original request message is QE_ASYNC_REQ_MSG.

  2. The Transformation box shows that the transformation QE_ASYNC_REQ was applied to the message QE_ASYNC_REQ_MSG.

  3. The box labelled 2. Request Message shows that the transformation QE_ASYNC_REQ has transformed the message QE_ASYNC_REQ_MSG to ASYNC_REMOTE_REQ_MSG.

    As a result, the message ASYNC_REMOTE_REQ_MSG is the message that is sent to the receiving node, QE_REMOTE.

Click to jump to top of pageClick to jump to parent topicViewing Synchronous Integration Point Information

This section discusses viewing integration point information for synchronous integration points.

For synchronous integration points, view the information in a u-shape fashion, starting at the top left-side of the page, reading downward to the bottom, rightward across the bottom of the page, and then upward on the right-side of the page.

The page shows that the sending node is QE_LOCAL and the receiving node is QE_REMOTE. Since the sending node is the local node and the receiving node is a remote node, this is an outbound synchronous integration point.

The page shows the following about the outbound request:

  1. The box labelled 1. Request Message shows the original request message is QE_SYNC_REQ_MSG.

  2. Moving down the page, the Transformation box shows that the request transformation QE_SYNC_REQ was applied to the message QE_SYNC_REQ_MSG.

  3. Continuing down the page, the box labelled 2. Request Message shows that the transformation transformed the message into the message SYNC_REMOTE_REQ_MSG.

    As a result, the message SYNC_REMOTE_REQ_MSG is sent to the receiving node, QE_REMOTE.

The page shows the following about the returned response:

  1. The box labelled 3. Response Message shows the initial message response received from the receiving system is SYNC_REMOTE_RES_MSG.

  2. Moving up the page directly above that box, the Transformation box shows that a response transformation QE_SYNC_RES was applied to the message.

  3. Continuing up the page, the box labelled 4. Response Message shows that the transformation transformed the message into the message QE_SYNC_RES_MSG.

    As a result, the message QE_SYNC_RES_MSG is the response message that is sent to the sending node, QE_LOCAL.

Click to jump to top of pageClick to jump to parent topicViewing Asynchronous-to-Synchronous Integration Point Information

This section discusses viewing integration point information for asynchronous-to-synchronous integration points.

For asynchronous-to-synchronous integration points, view the information in a u-shape fashion, starting at the top left-side of the page, reading downward to the bottom, rightward across the bottom of the page, and then upward on the right-side of the page.

The page shows that the sending node is QE_LOCAL and the receiving node is QE_REMOTE. Since the sending node is the local node and the receiving node is a remote node, this is an outbound asynchronous-to-synchronous integration point.

The page shows the following about the outbound request message:

  1. The box labelled 1. Request Message shows the original request message is QE_REQ_ASYNC_MSG.

  2. The Transformation box shows that the transformation ASYNC_2_SYNC was applied to the message QE_REQ_ASYNC_MSG.

  3. The box labelled 2. Request Message shows that the transformation ASYNC_2_SYNC transformed the message QE_REQ_ASYNC_MSG to the shape of a synchronous message with the name SYNC_REMOTE_REQ_MESG.

    As a result, the message SYNC_REMOTE_REQ_MESG is the message that is sent to the receiving node, QE_REMOTE.

The page shows the following about the response message:

  1. The box labelled 3. Response Message shows the initial message response received from the receiving system is SYNC_REMOTE_RES_MSG.

  2. Moving up the page directly above that box, the Transformation box shows that a response transformation SYNC_2_ASYNC was applied to the message.

  3. Continuing up the page, the box labelled 4. Response Message shows that the transformation transformed the message into the message QE_ASYNC_REPLY_MSG.

    As a result, the message QE_ASYNC_REPLY_MSG is the reply message that is used locally on the sending node, QE_LOCAL.

Click to jump to top of pageClick to jump to parent topicViewing Inactive Objects

When any objects associated with an integration are inactive, the View Inactive Objects link displays when you view the integration. When you click the View Inactive Objects link, the Inactive Objects page displays. The page lists all of the inactive objects for the integration.

Depending on how the integration is set up, the following objects related to an integration can appear on the Inactive Objects page:

Click to jump to top of pageClick to jump to parent topicActivating Inactive Objects

This section describes how to activate objects that display as inactive on the Inactive Objects page of the Integration Point Viewer.

Click to jump to top of pageClick to jump to parent topicActivating Nodes

To activate a node from the Inactive Objects page:

  1. In the Node section, click the Edit link for the node to activate. A separate window opens and displays the Node Definitions page for the node.

  2. Check the Active Node box.

  3. Click the Save button.

  4. Return to the Inactive Objects page and click the Refresh button.

Click to jump to top of pageClick to jump to parent topicActivating Transactions

To activate a transaction from the Inactive Objects page:

  1. In the Transactions section, click the Edit link for the transaction to activate. A separate window opens and displays the Node Definition —Transaction Detail tab.

  2. From the Status drop-down list, select Active.

  3. Click the Save button.

  4. Return to the Inactive Objects page and click the Refresh button.

Click to jump to top of pageClick to jump to parent topicActivating Messages

To activate messages from the Inactive Objects page:

  1. In the Message section, check the Active box for each message to activate.

  2. Click the Activate Selected Messages button.

  3. Click the Refresh button.

Click to jump to top of pageClick to jump to parent topicActivating Message Subscriptions

To activate message subscription PeopleCode for a message:

  1. In the Message Subscription section, check the Active box for each message subscription to activate.

  2. Click the Activate Selected Subscription button.

  3. Click the Refresh button.

Click to jump to top of pageClick to jump to parent topicActivating Message Channels

To activate a message channel from the Inactive Objects page:

  1. In the Message Channel section, check the Active box for the message channel to activate.

  2. Click the Activate Selected Channel button.

  3. Click the Refresh button.

Click to jump to top of pageClick to jump to parent topicActivating Relationships

To activate a relationship from the Inactive Objects page:

  1. In the Relationships section, click the Edit link for the relationship to activate. A separate windows opens and displays the Relationships-Nodes tab.

  2. From the Relationship Status drop-down list, select Active.

  3. Click the Save button and close the page.

  4. Return to the Inactive Objects page and click the Refresh button.

Click to jump to top of pageClick to jump to parent topicActivating Transaction Modifiers

To activate a transaction modifier, the relationship must first be active.

To activate transaction modifiers from the Inactive Objects page:

  1. In the Transaction Modifier section, click the Edit link for the transaction modifier to activate. A separate windows opens and displays the Relationships-Trans Modifier tab for the transaction.

  2. In the Status drop-down list, select Active.

  3. Click the Save button and close the page.

  4. Return to the Inactive Objects page and click the Refresh button.