Using the Integration Network

This chapter discusses how to:

• Access the integration network.

• Configure the integration network.

• Verify integration network status.

• Introspect and deploy network integrations.

• Set up integration network service operation permissions.

• Use the Integration Network Monitor.

• Use the Integration Network Transactional Tracker.

Understanding the Integration Network

The integration network centralizes the administrative tasks of configuring, administering, and monitoring integrations in PeopleSoft Integration Broker. The network is delivered as a WorkCenter.

The integration network provides configuration and node status pages that allow you to quickly assess if the integration network is properly configured, as well as identify the nodes that are in the network and their configuration status. The integration network enables you to activate and deploy groups of integrations, assess the security permission status of service operations, and more. The integration network also provides several for monitoring integration activity in the network, by node or by transaction.

Important! Only nodes defined as PeopleSoft nodes (PIA node type) can participate in the integration network.

Common Elements Used in the Integration Network

Accessing the Integration Network

This section discusses how to:

• Access the integration network using the Integration Network WorkCenter.

• Access the integration network using the Integration Network folder.

Understanding Accessing the Integration Network

You can access integration network features using the Integration Network WorkCenter or in the Integration Network folder, both of which are located in the PeopleSoft Pure Internet Architecture.

Note. Procedures for accessing and using the integration network are documented in this chapter using the Integration Network WorkCenter

Accessing the Integration Network Using the Integration Network WorkCenter

The default location of the Integration Network WorkCenter is in the Integration Broker folder in the PeopleSoft Pure Internet Architecture. To access the Integration Network WorkCenter , select PeopleTools, Integration Broker, Integration Network WorkCenter. The following example show the Integration Network WorkCenter:

When you access the Integration Network WorkCenter, the Network Status page appears in the main work area.

The left navigation pane of the Integration Network WorkCenter provides links to the integration network features and pages. When you select a link from the left navigation pane, the corresponding page appears in the main work area.

Information for working with and customizing WorkCenters is provided elsewhere in PeopleBooks.

See PeopleTools 8.52: Using PeopleSoft Applications PeopleBook

Accessing the Integration Network Using the Integration Network Folder

You can access integration network features in the Integration Network folder in the PeopleSoft Pure Internet Architecture. To access the folder, select PeopleTools, Integration Broker, Integration Network. The Integration Network folder opens and links to integration network features appear, as shown in the following example:

Configuring the Integration Network

This section discusses how to:

• Use the Configuration Status page.

• Verify and manage integration gateway configuration.

• Verify node network status.

• Add and modify nodes in the PeopleSoft database.

• Add notes to the network.

• Verify publication/subscription server domain status.

Understanding Configuring the Integration Network

The integration network is properly configured when the integration gateway is configured, when the default local node is configured, local and remote nodes are configured, and when the application server domain is active. The Integration Network folder features a Configuration Status page that enables you to quickly assess if the integration network is configured. The page also provides access to the PeopleSoft Integration Broker components used to perform configuration tasks if you want to view or modify settings.

Understanding Minimum Configuration Requirements for the Integration Network

The Configuration Status page indicates if the integration network is minimally configured to run. The following table lists the minimum configuration requirements for the network.

Note. All nodes to be managed and monitored in the Integration Network must be PeopleSoft nodes. PeopleSoft nodes are those nodes defined as PIA node types in the node definition.

Using the Configuration Status Page

The Configuration Status page indicates if the integration network is minimally configured to run as described in the previous section.

The page provides visual cues that enable you to quickly asses if the integration network is properly configured. Integration components that are properly configured display on the page with a green check mark icon next to them; components that are not configured, are not configured properly, or that require additional configuration display on the page with a red “X” icon next to them.

To access the Configuration Status page, select PeopleTools, Integration Broker, Integration Network WorkCenter and click Configuration Status. The following example show the Configuration Status page:

In the previous example, green check mark icons appear next to the Gateway Configured and Node Network Configured links and indicate that each of these integration components are properly configured. A red “X” icon appears next to the Activate Domain link, and indicates that the domain is not active.

The following page elements appear on the Configuration Status page:

Verifying and Managing Integration Gateway Configuration

At a minimum the following setting and options must be configured on the integration gateway for the integration network to function properly:

• Default gateway URL.

• Target connectors loaded.

• Jolt connection information configured for PeopleSoft nodes on the integration gateway.

The Configuration Status page features a Gateway Configured link. When you click the link the Gateways component appears and you can view and configure integration gateway settings and options. You can also use the Gateway link in the Integration Network WorkCenter navigation pane to access the Gateways page and the features described in this section.

The following example shows the Gateways page when no integration gateway has yet been defined:

The following table provides links to PeopleBooks documentation that describes how to perform the minimum tasks required to configure the integration network:

Viewing Node Network Status

The Configuration Status page features a Node Network Configured link that opens a Node Network page. Use the Node Network page (IB_INTNETWORK) to view and configure details about PeopleSoft nodes in the integration network. The Node Network page provides a view of all the PeopleSoft nodes in the database.

Note. Only PeopleSoft nodes can be viewed and managed in the integration network pages. A PeopleSoft node is one defined as a PIA node type on the Nodes-Node Definition page.

The following example shows the Node Network page:

The Node Network page allows you to easily identify the current default local node, nodes that are defined in the integration network, active nodes, and so on.

The following page elements appear on the Node Network page:

Adding and Modifying Nodes in the PeopleSoft Database

You can click the name of any node in the Node Network list to open the node definition in the Node Definition page and view or modify the node definition.

The following table lists the actions you must take to properly configure a node for the node network. The table also provides links to the corresponding PeopleBooks documentation that describes how to perform the actions:

Adding Nodes to the Network

A check mark in the In Network column on the Node Network page indicates that the node is defined as part of the integration network. A node must be in network for you to be able view integration information and use the features of the integration network on the node.

The default local node is automatically defined in the network.

The In Network box for a node is enabled for selection or available to clear only when:

• The node is active.

  Information about activating a node is described elsewhere in PeopleBooks.

  See Defining Node Parameters.

• The jolt connection strings for the node have been defined in the integration gateway

  Information about setting the jolt connection strings for a node is described elsewhere in PeopleBooks.

  See Setting Oracle Jolt Connection Properties.

Verifying Publication/Subscription Server Domain Status

For the integration network to be properly configured the pub/sub server domain must be set to Active.

When the No Domain Active link appears on the Configuration Status page, the pub/sub server domain is not set to Active. Click the link to access the Domain Status page in the Service Operations Monitor and to activate the domain status.

See Activating Pub/Sub Server Domains.

Verifying Integration Network Status

This section discusses how to:

• Navigate the Network Status page.

• Verify network connectivity with integration partners.

• Verify integration status with integration partners.

Understanding Verifying Integration Network Status

The Integration Network provides a Network Status page that enables you to verify integration network connectivity with PeopleSoft integration partners and to verify the status of integrations between those partners.

Prerequisites for Verifying Integration Network Status

Before you can verify integration network connectivity and status with remote PeopleSoft nodes in the integration network:

• You and your PeopleSoft integration partners must have your Integration Broker systems configured and running.

  See Verifying and Managing Integration Gateway Configuration.

• You and your PeopleSoft integration partners must have the integration network node network configured.

  See Viewing Node Network Status.

• Use the Network Monitor Setup page to set the number of days for which to retrieve network status data.

  See Setting Up the Integration Network Monitor.

Navigating the Network Status Page

The Integration Network features a Network Status page (IB_VERIFYNETRS) that enables you to verify proper connectivity and status of all integrations between the default local node and remote nodes in the integration network.

To access the Network Status page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Administration, Network Status. The following example shows the page:

The page features the following fields and control:

Verifying Network Connectivity with Integration Partners

Use the Ping Status control on the Network Status page to verify connectivity with remote PeopleSoft nodes in the integration network.

A successful ping indicates that you have correctly defined the selected remote PeopleSoft nodes in the Integration Network and that the local system can connect to them. A successful ping also indicates that the PeopleSoft integration partners represented by the remote nodes have correctly defined your node as part of their integration network and they should be able to perform a successful integration network ping to your system as well.

The following table lists the possible results from performing a ping on an integration network nodes:

To verify integration network connectivity with integration partners:

1. Access the Network Status page. (Select PeopleTools, Integration Broker, Integration Network WorkCenter.)

2. Click the Ping Status button.

The system displays the outcome of the ping in the Results column in the Network Node Status grid.

Verifying Integration Status with Integration Partners

The Network Integration Status control on the Network Status page enables you to verify integration network connectivity between the default local node and the selected remote PeopleSoft node as well as verify that integrations between the two systems are being processed.

The following table lists the possible results from performing an integration network status check:

To verify integration status with integration partners in the integration network:

1. Access the Network Status page. (Select PeopleTools, Integration Broker, Integration Network WorkCenter.)

2. Click the Network Integration Status button.

The system displays the outcome of network status check in the Results column in the Network Node Status grid.

Introspecting and Deploying Network Integrations

This section discusses how to:

• Use the Search for Items-Introspection/Deployment page.

• Search for items to introspect and deploy.

• Select integrations to introspect and deploy.

• Select nodes for introspection and deployment.

• Verify nodes and services to introspect.

Understanding Introspecting and Deploying Integrations

The Integration Network features a series of pages that enable you to introspect and deploy services on remote nodes. Once the services or introspected and deployed, you can activate service metadata and routings to establish a proper connection between the default local node and the selected remote node.

The introspection process pulls service information from the target node to the local node, and the deployment process pushes service information from the local node to the target node, allowing the two nodes to perform integrations.

Using the Search for Items–Introspection/Deployment Page

The Integration Network features a Search for Items – Introspection/Deployment page (IB_INTNETWORK2) that you use to search for select integrations to introspect and deploy.

To access the Search for Items – Introspection/Deployment page, select PeopleTools, Integration Broker, Integration Network WorkCenter,, Administration, Introspection and Deployment. The following example show the page:

Searching for Integrations to Introspect and Deploy

You can search for integrations to introspect and deploy at the integration group, service , or service operation level.

Use one of the following options to search for an integration:

After selecting one of the search options, click the Search button at the bottom of the page.

Results of the search appear in the Select Items to Process grid at the bottom of the page.

Selecting Integrations to Introspect and Deploy

When you search for integrations to introspect and deploy to remote PeopleSoft nodes in the integration network, the results appear in the Select Items to Process grid at the bottom of the Search for Items – Introspection/Deployment page. Use the grid to select the integrations to introspect and deploy.

The following controls and fields appear in the Select Items to Process grid:

By default, all integrations returned in the search are selected for introspection and deployment.

To select an integration to introspect and deploy:

1. Use one of the following methods to select integrations from the grid to introspect and deploy:

   • Check the Select box next to individual integrations to select them or deselect them.

   • Click the Select All link to select all the integrations in the results grid.

   • Click Deselect All link to deselect all the integrations in the results grid.

2. Click the Continue button to select access the Target page and to select the remote PeopleSoft nodes to introspect and deploy.

Selecting Nodes for Integration Introspection and Deployment

Use the Target page (IB_INTNETTARGET) to select nodes for integration introspect and deploy integrations. You can select the default local node, for local-to-local integrations, or select one or more remote nodes.

To access the Target page, from the Search for Items – Introspection/Deployment page, click the Continue button. The following example, shows the page:

To select nodes for introspection and deployment:

1. Access the Target page. (From the Search for Items – Introspection/Deployment page, click the Continue button.)

2. Perform one of the following actions:

   • Select the Local Node radio button for local-to-local integrations.

   • Select the Remote Nodes radio button to introspect and deploy integrations to remote PeopleSoft nodes.

Selecting the Local Default Node for Integration Introspection and Deployment

To select the local default node for integration introspection and deployment:

1. Access the Target page. (From the Search for Items – Introspection/Deployment page, click the Continue button.)

2. Select the Local Node radio button.

3. Click the Continue button.

Selecting Remote PeopleSoft Nodes for Integration Introspection and Deployment

To select remote PeopleSoft nodes for integration introspection and deployment:

1. Access the Target page. (From the Search for Items – Introspection/Deployment page, click the Continue button.)

2. Select the Remote Nodes radio button.

3. Use one of the following methods to select nodes for integration introspection and deployment:

   By default, all remote nodes in the integration network are selected for introspection and deployment.

   • Check the Select box next to individual integrations to select them or deselect them.

   • Click the Select All link to select all the integrations in the results grid.

   • Click Deselect All link to deselect all the integrations in the results grid.

4. Click the Continue button to preview the integrations to be introspected and deployed.

Verifying Nodes and Services to Introspect

The Introspection/Deployment page (IB_INTNETWORK4) displays the nodes and service operations you selected for integration and deployment in the previous step. The following example shows the Introspection/Deployment page:

To make changes, use the Previous Step button located at the bottom of the page to return to the previous pages and make any necessary changes.

If the information is satisfactory, click the Introspect button to introspect the nodes in the node list. The results appear in the Introspection Results page discussed in the next section.

Viewing Introspection Results and Deploying Actions

The results of the introspection appear on the Introspection Results page (IB_INTNETWORK3_SEC). The following example shows the page:

The Introspection Results page lists any needed deployment actions that you can correct using the page. To deploy an action, select a row in the grid and click the Deploy button.

For example, in the previous example, the first row in the Operation List grid for the QE_CRM grid shows that an inbound routing does not exist for the routing alias QE_FLIGHTPLAN_SYNC.VERSION_1. To create the routing, check the Select box for the item and click the Deploy button. The system generates a routing. The following example shows the Introspection Results page after the system performs the deployment action:

The status of the action appears in the Information field and the deployment action performed appears in the Deployment Action field.

Click the Return to Target Page link to return to the Target page select additional or different nodes to introspect. Click the Return to Search link to return to the Search for Items – Introspection/Deployment page to work with different integration groups, services, and service operations.

Setting Service Operation Permissions

This section discusses how to:

• Use the Service Operation Permissions page.

• Search for service operations to set permissions.

• Set permissions for service operations.

Understanding Setting Service Operation Permissions

The PeopleSoft Integration Network features a Service Operations Permissions page (IB_HOME_PAGE10) that enables you to set and modify permissions for network services operations defined on the local node.

Note. You can set and modify service operation permissions on the local node only.

Using the Service Operation Permissions Page

To access the page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Administration, Service Operation Permission. The following example shows the page:

Use the options in the Level section to search for service operations for which to set permissions. The results of your search appear in the Service Operations grid at the bottom of the page.

A check mark in the Permission Set field denotes if permissions have been set for a service operation. In the example, permissions have been set for the IB_EX_MP_ROWSET_ASYNC and IB_EX_MP_ROWSET_SYNC service operations.

Click the Set Security link to access the Web Service Access page to set permissions for the service operation. The Web Service Access page opens in a new browser window as shown in the following example:

Use the Web Service Access page to assign a permission list and access level to the service operation.

Searching for Service Operations to Set Permissions

You can search for service operations for which to set permissions at the integration group, service , or service operation level.

Use one of the following options to search for a service operation:

After selecting a search option , click the Search button at the bottom of the page.

Results of the search appear in the Select Items to Process grid at the bottom of the page.

Setting Service Operation Permissions

The results of a search for service operations for which to set permissions appear in the Service Operation grid of the Service Operation Permissions page. Click the Set Security link to access the Web Service Access page. The page opens in a separate browser page.

Using the Web Service Access page to assign permission lists and access levels to service operations is described elsewhere in PeopleBooks.

See Setting Web Services Permissions.

Using the Integration Network Monitor

This section discusses how to:

• Set up the Network Monitor.

• Select nodes to monitor.

• Fetch and synchronize Network Monitor data.

• Monitor asynchronous network service operations.

• Monitor synchronous network service operations.

• Activate and deactivate network domains.

• Resubmit and cancel network transactions.

Understanding Using the Integration Network Monitor

System administrators use the Integration Network Monitor to monitor integrations among other PeopleSoft systems defined in the integration network. Many of the pages and functions of the Network Monitor resemble those in the monitoring pages of the Service Operations Monitor. The major differences are that with the Network Monitor you are not limited to monitoring activity on the local node; you can monitor activity any remote PeopleSoft node defined in the network.

Network Monitor Features

The Network Monitor provides the following features:

• Status on queues, nodes, and individual service operations.

• Control and administration of domains that have publication and subscription (pub/sub) servers running against the current database.

  You can activate or deactivate domains, recover from stalls, and so forth.

Continue to use the Service Operation Monitor to perform the following tasks:

• View and edit XML.

• Archive data.

• Run batch processes to receive notification of issues affecting the messaging system.

• Administrative tasks, such as administer domains, view and maintain queue status, delete orphaned data after segment batch processing errors, define custom components for monitoring activities, and so on.

See PeopleTools 8.52: Integration Broker Service Operations Monitor PeopleBook

Network Monitor Pages

The Network Monitor features the following pages:

In addition, every page of the Network Monitor features these links:

Network Monitor Security

Upon accessing the monitor, you can see a list of all transactions in the system. However, to see specific information about a transaction and to view transaction details, you must have permission to the service operation.

See Setting Permissions to Service Operations.

Understanding Network Monitor Processing Status Information

The Network Monitor uses the same asynchronous and synchronous processing statuses as those that appear in the Service Operations Monitor.

See Asynchronous Service Operation Statuses, Understanding Synchronous Service Operation Statuses.

Prerequisites for Using the Integration Network Monitor

Note the following prerequisites for using the Network Monitor:

• You must set up Network Monitor options using the Network Monitor Setup page. The options you set on the page apply to your monitoring activity in the Network Monitor and the Transactional Tracker.

  Information about setting up these options is provided elsewhere in this chapter.

  See Setting Up the Integration Network Monitor.

• To track transactions with remote PeopleSoft nodes the remote nodes must be active and defined in the integration network.

  See Adding Nodes to the Network.

• The Synchronous Transactions provides links the Synchronous Details page for viewing logging data. To capture logging data for a service operation you must set the log level on the routing definition for the service operation.

  See Adding Nodes to the Network.

Common Elements Used in the Integration Network Monitor

Setting Up the Integration Network Monitor

Use the Network Monitor Setup page (IB_INTNET_MONSETUP) to set up Integration Network Monitor and Transactional Tracker options, such as the number of rows to display in the monitor, date/time ranges for query results, and more.

To access the page, select PeopleTools, Integration Broker, Integration Network WorkCenter and click the Network Monitor Setup link.

The following example shows the page:

Specifying the Number of Rows to Return

Use the Maximum Number of Rows to return field on the Network Monitor Setup page to specify the number of rows to return as search results. The default value is 1000 rows.

There is no minimum or maximum value that you can set for this parameter. Consider integration volume when setting this value.

Enabling Integration Broker Performance Statistics

Check the IB Profile Status On field on the Network Monitor Setup page to enable the collection and display of runtime Integration Broker performance statistics.

Viewing Integration Broker performance statistics is discussed elsewhere in PeopleBooks.

See Viewing System Performance Statistics.

Defining Date and Time Ranges for Query Results

Use the Time Frame section on the Network Monitor Setup page to define the date and time range in which query results should fall.

By default, the system returns search results for activity that has taken place in the past 30 days. However, you change the day range, or set parameters based on date and time ranges.

To define a date range in which query results are to fall:

1. Select the Last X Days radio button.

2. In the Last Number of Days field, enter a value.

   By default the value is 30, and the system returns query results for the last 30 days of activity.

To define a date and time range in which query results are to fall:

1. Select the Date/Time Range radio button.

2. Select the date range.

   1. In the Search from Date field, enter the start date of the date range.

      Alternatively, click the calendar icon to select a date.

   2. In the Search to Date field, enter the end date of the date range.

      Alternatively, click the calendar icon to select a date.

3. Select the time range.

   1. In the Search from Time field, enter the start time of the time range.

   2. In the Search to Time field, enter the end time of the time range.

      Time field format is HH:MI:SS.999999, where HH represents hours, MI represents minutes, SS represents seconds, and 999999 represents microseconds.

Defining the Date Range of Network Status Query Results

In the Network Status Data section, select the number of days for which to return results of network status information for the Network Status page.

The default value is 30 days.

Selecting Nodes to Monitor in the Integration Network Monitor

Each page of the Network Monitor features a Network Node List. The Network Node List contains a list of active integration network nodes for which you can monitor integration activity. The following example shows the Network Node List:

The example shows that there are three active network nodes for which you can monitor data, AKTT, QE_CRM and QE_HCM. The QE_CRM node is highlighted and denotes that it is the currently selected node for monitoring network activity.

To change or select a node, click the node name in the tree.

When you select a node in the Network Node List, the system automatically resynchronizes and fetches the most current transaction data for the selected node.

Fetching and Synchronizing Integration Network Monitor Data

The PeopleSoft system fetches and synchronizes Network Monitor data when you initially access the Network Monitor component and when you change nodes in the Network Node List.

You can also manually synchronize data by clicking the Re-Sync Monitor Data button. The Re-Sync Monitor Data appears on each page of the Network Monitor under the Network Node List.

The synchronization process synchronizes and updates the fetched data with changes in the database since the last synchronization.

A Last Sync field appears under the Re-Sync Monitor Data button and displays the date and time that the monitor data was last synchronized, whether it be by manual synchronization or system synchronization.

Filtering Integration Network Monitor Query Results

Controls on the Monitor Overview, Operation Instances, Publication Contracts, Subscription Contracts, and Synchronous Transaction pages provide data filters that enable you to narrow the fetched data results to that data which is most relevant to you.

The filters are listed on the pages on which they appear and are described in the Common Elements Used to Filter and View Asynchronous Network Monitor Data and the Common Elements Used to Filter and View Synchronous Network Monitor Data sections.

After choosing the filters, you click the Filter button to obtain the filtered results.

Monitoring Asynchronous Integration Network Service Operations

This section discusses how to:

• Filter asynchronous network service operation data.

• Monitor general asynchronous network service operation data.

• Monitor asynchronous network service operation instances.

• Monitor asynchronous network service operation publication contracts.

• Monitor asynchronous network service operation subscription contracts.

Common Elements Used to Filter and View Network Monitor Asynchronous Service Operation Data

The following elements are used to filter and view the query results of Network Monitor service operation data.

Monitoring General Asynchronous Network Service Operation Information

Use the Monitor Overview page (IB_INTNET_OVRVIEW) for a high-level overview of the status of asynchronous service operation transactions in the integration network. You can group transactions by queue or service operation for viewing. To access this page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Network Monitor. The Monitor Overview page shown in the following example appears:

When you access the page, the system automatically synchronizes the with the database for the selected node in the Network Node List. The processing status of asynchronous transactions appears in the Results grid at the bottom of the page. The number of operation instances in a particular status display as a linked value. Click the link to open the data in the Operation Instances page where you can view more detailed information.

If you change the node for which to view information, by clicking a different node name in the Network Node List, the system automatically resynchronizes the page with the most up-to-date transaction information for the node.

By default, the system queries the database by service operation queue for operation instance information.

You can query the database by modifying the query filters and then clicking the Filter button. The filters available on the page are:

• Publish.

• Query Level.

• Group By.

• Time Period.

The data filters and data elements that appear in the Results grid are described in the Common Elements Used to Filter and View Asynchronous Network Monitor Data section.

Monitoring Asynchronous Network Service Operation Instances

Use the Operation Instances page (IB_INTNET_PUBHDR) to monitor the status and details related to individual asynchronous service operation instances. To access this page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Network Monitor and click the Operation Instances tab. The following example shows the Operation Instances page:

The example shows a partial view of the query results appearing in the Results grid.

If you change the node for which to view information, by clicking a different node name in the Network Node List, the system automatically resynchronizes the page with the most up-to-date transaction information for the node.

By default, the system queries the database by service operation queue and the asynchronous processing status Done.

You can query the database by modifying the query filters and then clicking the Filter button. The filters available on the page are:

• Node Name.

• External Service Name.

• Service Operation.

• Queue Name.

• Status.

• Time Period.

Query results appear in the Results Grid. If the queue in which a transaction is processed is partitioned, a hyperlinked transaction ID appears in the Sub Queue column in the Results grid. Click the link to view all network service operations in the sub queue.

For each transaction in the Results grid a Details link appears. Click the Details link access the Asynchronous Details page and to view additional details for the transaction. Based on the processing status of the transaction, the Asynchronous Details page enables you to view any transaction error messages and resubmit or cancel the transaction.

The data filters and data elements that appear in the Results grid are described in the Common Elements Used to Filter and View Asynchronous Network Monitor Data section.

Monitoring Asynchronous Network Service Operation Publication Contracts

Use the Publications Contracts page (IB_INTNET_PUBCON) to monitor the status and details related to asynchronous service operation publication contracts. To access this page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Network Monitor and click the Publication Contracts tab. The following example shows the Publication Contracts page:

The example shows a partial view of the query results appearing in the Results grid.

If you change the node for which to view information, by clicking a different node name in the Network Node List, the system automatically resynchronizes the page with the most up-to-date transaction information for the node.

By default, the system queries the database by service operation queue and the asynchronous processing status Done.

You can query the database by modifying the query filters and then clicking the Filter button. The filters available on the page are:

• Node Name.

• Service Operation.

• Queue Name.

• Status.

• Transaction ID.

• Subscriber Node.

• Time Period.

Query results appear in the Results grid.

The data filters and data elements that appear in the Results grid are described in the Common Elements Used to Filter and View Asynchronous Network Monitor Data section.

If the queue in which a transaction is processed is partitioned, a hyperlinked transaction ID appears in the Sub Queue column in the Results grid. Click the link to view all network service operations in the sub queue.

For each transaction in the Results grid a Details link appears. Click the Details link to access the Asynchronous Details page and to view additional details for the transaction. Based on the processing status of the transaction, the Asynchronous Details page enables you to view any transaction error messages and resubmit or cancel the transaction.

The following example shows the Asynchronous Details (IB_INTNET_DET) page for an asynchronous network publication contract:

The top portion of the Asynchronous Details page shows the information that appears in the Results grid of the Publication Contracts page.

The Publication Contracts grid at the bottom of the page shows additional information about the transaction.

The Actions tab shows each node that is subscribing to the contract. In this example, the AKTT node and the QE_HCM node are the nodes that are subscribing to the contract. Depending on the processing status, the Resubmit and Cancel buttons are active and you can perform those related actions.

See Resubmitting and Cancelling Integration Network Transactions.

If there are any processing errors with a transaction, a View Info Details link appears . Click the link to view the error information. In this example the View Info Details link is enabled for the QE_HCM node, indicating that processing errors occurred with the transaction.

The Information tab reveals details about the publication transaction, including the transaction ID, the transaction time stamp, and so on.

Monitoring Asynchronous Network Service Operation Subscription Contracts

Use the Subscription Contracts page (IB_INTNET_SUBCON) to monitor the status and details related to asynchronous service operation subscription contracts. To access this page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Network Monitor and click the Subscription Contracts tab. The following example shows the Subscription Contracts page:

The example shows a partial view of the query results appearing in the Results grid.

If you change the node for which to view information, by clicking a different node name in the Network Node List, the system automatically resynchronizes the page with the most up-to-date transaction information for the node.

By default, the system queries the database by service operation queue and the asynchronous processing status Done.

You can query the database by modifying the query filters and then clicking the Filter button. The filters available on the page are:

• Node Name.

• Service Operation.

• Queue Name.

• Status.

• Transaction ID.

• Time Period.

Query results appear in the Results grid.

The data filters and data elements that appear in the Results grid are described in the Common Elements Used to Filter and View Asynchronous Network Monitor Data section.

If the queue in which a transaction is processed is partitioned, a hyperlinked transaction ID appears in the Sub Queue column in the Results grid. Click the link to view all network service operations in the sub queue.

For each transaction in the Results grid a Details link appears. Click the Details link to access the Asynchronous Details page and to view additional details for the transaction. Based on the processing status of the transaction, the Asynchronous Details page enables you to view any transaction error messages and resubmit or cancel the transaction.

The following example shows the Asynchronous details page for an asynchronous network subscription contract:

The top portion of the Asynchronous Details page shows the information that appears in the Results grid of the Subscription Contracts page.

The Subscription Contracts grid at the bottom of the page shows additional information about the transaction.

The Actions tab shows the service operation handler name for the subscription contract. Depending on the processing status, the Resubmit and Cancel buttons are active and you can perform those related actions.

See Resubmitting and Cancelling Integration Network Transactions.

If there are any processing errors with a transaction, a View Info Details link appears on the Actions tab. Click the link to view the error information.

The Information tab reveals details about the subscription transaction, including the transaction ID, the transaction time stamp, and so on.

Monitoring Synchronous Integration Network Service Operations

This section discusses how to monitor synchronous network service operation transactions.

Common Elements Used to Filter and View Network Monitor Synchronous Service Operation Data

The following elements are used to filter and view the query results of Network Monitor service operation data.

Monitoring Synchronous Network Service Operation Transactions

Use the Synchronous Transactions page (IB_INTNET_SYNC) to monitor the status and details related to synchronous service operations in the integration network. To access this page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Network Monitor and click the Synchronous Transactions tab. The following example shows the Synchronous Transactions page:

The example shows a partial view of the query results appearing in the Results grid.

If you change the node for which to view information, by clicking a different node name in the Network Node List, the system automatically resynchronizes the page with the most up-to-date transaction information for the node.

You can query the database by modifying the query filters and then clicking the Filter button. The filters available on the page are:

• Node Name.

• Service Operation.

• Status.

Query results appear in the Results grid.

The data filters and data elements that appear in the Results grid are described in the Common Elements Used to Filter and View Synchronous Network Monitor Data section.

For each transaction in the Results grid a Details link appears. Click the Details link to access the Synchronous Details page (IB_INTNET_SYNC_DET) and to view additional details for the transaction. Based on the processing status of the transaction, the Asynchronous Details page enables you to view any transaction error messages and resubmit or cancel the transaction. The following example shows the Synchronous Details page:

If there are any processing errors with a transaction, an Error Messages link appears. Click the link to view error message information.

Monitoring Integration Network Domain Status

Use the Domain Status page (IB_INTNET_DOMSTAT) to monitor the status of the domain for the node selected in the Network Node List. To access this page, select PeopleTools, Integration Broker, Integration Network WorkCenter, Network Monitor and click the Domain Status tab. The following example shows the Domain Status page:

Use the page to activate the domain of the selected node in the Network Node List, as necessary.

To activate a network node:

1. Access the Domain Status page (PeopleTools, Integration Broker, Integration Network WorkCenter, Network Monitor).

   The Network Monitor – Monitor Overview page appears.

2. In the Network Node List, select a node.

3. Click the Domain Status tab.

4. In the Domains grid, select the domain to activate.

5. Click the Activate button.

Resubmitting and Cancelling Integration Network Transactions

This section discusses how to:

• Resubmit or cancel individual network transactions for processing.

• Resubmit or cancel network transactions for processing in bulk.

Understanding Resubmitting and Canceling Network Transactions for Processing

You can resubmit and cancel network transactions for processing for only those to which you have permissions. If you attempt to resubmit or cancel a transaction for which you do not have permission, the system ignores the action.

Understanding Resubmitting and Canceling Future-Dated Network Transactions

You can cancel a future-dated transaction in the network monitor as you would any other transaction. However, when you cancel a future-dated transaction, the future date information is not retained. So if you subsequently resubmit the transaction, the system immediately submits it for processing.

Resubmitting and Canceling Individual Network Transactions

To resubmit or cancel individual transactions, select the check box next to the appropriate transaction and click the Resubmit or Cancel button. To deselect a transaction, clear the check box next to the transaction.

Resubmitting and Canceling Network Transactions in Bulk

You can resubmit and cancel network transaction for processing in bulk using the Network Monitor. Network transactions to resubmit in bulk must be in one of the following statuses:

• Cancel.

• Edited.

• Error.

• Timeout.

Network transactions to cancel in bulk must be in one of the following statuses:

• Edited.

• Error.

• Hold. (The transaction must also be future-dated.)

• New.

• Retry.

• Timeout.

In addition to the Clear All, Resubmit and Cancel buttons, you can also use the following links when resubmitting and canceling network transactions in bulk:

Using the Integration Network Transactional Tracker

This section discusses how to:

• Select nodes to track in the Transactional Tracker.

• Fetch and synchronize Transactional Tracker data.

• Filter Transactional Tracker data

• View network asynchronous transaction instances.

• View network asynchronous transaction detail information.

• View network synchronous transaction detail information.

• View network transaction information for specific transactions.

Understanding the Integration Network Transactional Tracker

The Network Transactional Tracker, or Transactional Tracker, enables you to track inbound and outbound integrations between the local node and all other nodes defined in the integration network.

The Transactional Tracker component (IB_INTNET_TRACKER) features three page for tracking activity:

The pages in the Transactional Tracker feature links to the following pages that enable you to view details for a single transaction:

Prerequisites for Using the Transactional Tracker

Note the following prerequisites for using the transactional tracker:

• You must set up Transaction Tracker monitor options using the Network Monitor Setup page. The options you set on the page apply to your monitoring activity in the Network Monitor and the Transactional Tracker.

  Information about setting up these options is provided elsewhere in this chapter.

  See Setting Up the Integration Network Monitor.

• To track transactions with remote PeopleSoft nodes the remote nodes must be active and defined in the integration network.

  See Adding Nodes to the Network.

• The Tracker Main View page and the Synchronous Tracker View page provide access to the Integration Broker performance statistics pages. To successfully use the performance statistics pages you must enable the statistics feature.

  See Adding Nodes to the Network.

• The Synchronous Tracker View page provides links to the Synchronous Details page for viewing logging data. To capture logging data for a service operation you must set the log level on the routing definition for the service operation.

  See Adding Nodes to the Network.

Common Elements Used in the Transactional Tracker

Selecting Nodes to Track in the Transactional Tracker

Each page of the Transactional Tracker features a Network Node List. The Network Node List contains a list of active integration network nodes for which you can track transaction activity between the local node. The following example shows the Network Node List:

The example shows that there are two active network nodes, QE_CRM and QE_HCM. The QE_CRM node is highlighted and denotes that it is the currently selected node for tracking transactions between the local node.

To change or select a node, click the node name in the tree.

When you select a node in the Network Node List, the system automatically resynchronizes and fetches the most current transaction data for the selected node and the local node.

Fetching and Synchronizing Transactional Tracker Data

The PeopleSoft system fetches and synchronizes Transactional Tracker data when you initially access the Transactional Tracker component and when you change nodes in the Network Node List.

You can also manually synchronize data by clicking the Re-Sync Monitor Data button. The Re-Sync Monitor Data appears on each page of the Transactional Tracker under the Network Node List.

The synchronization process synchronizes and updates the fetched data with changes in the database since the last synchronization.

A Last Sync field appears under the Re-Sync Monitor Data button and displays the date and time that the tracker data was last synchronized, whether it be by manual synchronization or system synchronization.

Filtering Transactional Tracker Data

Controls on each page the Transactional Tracker provide data filters that enable you to narrow the fetched data results to that data which is most relevant to you.

After choosing the filters, you click the Filter button to obtain the filtered results.

For example, each page of the Transactional Tracker features a Time Period group box where you can filter the fetched data by date or by date and time.

The specific data filters for each page are described in the Common Elements Used in the Transactional Tracker section and in the documentation for the pages on which they appear.

See Common Elements Used in the Transactional Tracker.

Viewing Network Asynchronous Transaction Instances

Use the Tracker Overview page (IB_INTNET_TRACKOVR) to view instance information for asynchronous transactions between the local node and remote nodes in the integration network.

Before using the Tracker Overview page see the prerequisites for using the Transactional Tracker described elsewhere in this chapter.

See Prerequisites for Using the Transactional Tracker.

The page enables you to view transaction instance counts for sending and receiving nodes at each queue level in the system. You can view this information by service operation or queue, and the direction of the transaction (inbound or outbound).

When you access the Transactional Tracker component, the Tracker Overview page appears by default.

To access the Tracker Overview page, select PeopleTools, Integration Broker, Integration Network WorkCenter. In the WorkCenter navigation pane, click Transactional Tracker. The following example shows the Tracker Overview page:

Use the Network Node List to select the remote node for which to track transactions. The system fetches available transaction data between the local node and the remote node. The system automatically synchronizes the data that appears on the page when you initially access the page and when you change the remote node.

Use one or more of the following data filters on this page:

The Results grid displays the transaction instance data based on the default values for the filters. You can change the values for any of the fields and click the Filter button to display data based on the different filters.

When viewing the fetched data click the Expand icon to view the columns for all returned data. The following example shows the Tracker Overview page with the Results grid expanded:

In the Results grid, click the Sender or Receiver tab to view counts of message instances, publication contracts, and subscription contracts processed by each respective node.

The following information appears in the Results grid on the Sender tab:

The following information appears in the Results grid on the Receiver tab:

Viewing Network Asynchronous Transaction Detail Information

This section describes how to use the Transactional Tracker to view asynchronous transaction details.

Understanding Integration Network Asynchronous Processing Status Information

Asynchronous transactional detail information that the Transactional Tracker provides includes processing status information for service operation instances, publication contracts, and subscription contracts.

The processing statuses that the Transactional Tracker uses for asynchronous service operations are the same as those used in the Service Operations Monitor.

See Asynchronous Service Operation Statuses.

Viewing Integration Network Asynchronous Transactional Details

Use the Tracker Main View page (IB_INTNET_TRACKER) to view details for asynchronous transactions between the local node and remote nodes in the integration network.

Before using the Tracker Main View page see the prerequisites for using the Transactional Tracker described elsewhere in this chapter.

See Prerequisites for Using the Transactional Tracker.

The Tracker Main View page enables you to view the transaction IDs, queue names, processing status, and more for the transactions.

You can access the Tracker Main View page from the Tracker Overview page using the Results grid; click the queue name or service operation link in the grid. You can also access the page using the standard PeopleSoft Pure Internet Architecture navigation by selecting PeopleTools, Integration Broker, Integration Network WorkCenter, then in the WorkCenter navigation pane click the Transactional Tracker link, and click the Tracker Main View page. The following example shows the Tracker Main View page:

If you access the page from the Tracker Overview page, the page populates with data based on the query results from the Tracker Overview page. If you access the page without first conducting a query on the Tracker Overview page, click the Re-Sync Monitor Data button to populate the page with query data.

Use one of more of the following filters on this page:

If you access the Tracker Main View page from the Tracker Overview page, the system defaults the queue name or service operation name from the Tracker Overview page as a filter. In addition, the direction of the transaction as viewed on the Tracker Overview page is also defaulted on the page.

The following information appears in the Results grid on the Sender Node tab:

After a query the following information appears in the Results grid on the Receiver Node tab:

Viewing Network Synchronous Transactional Details

This section describes using the Synchronous Tracker View page to view integration network synchronous transactional details.

Understanding Integration Network Synchronous Processing Status Information

Synchronous transactional detail information that the Transactional Tracker provides includes processing status information for service operations.

The processing statuses that the Transactional Tracker uses for synchronous service operations are the same as those used in the Service Operations Monitor. The statuses for synchronous service operations are:

See Understanding Synchronous Service Operation Statuses.

Prerequisites for Viewing Integration Network Synchronous Transactional Details

Before using the Synchronous Tracker View page see the prerequisites for using the Transactional Tracker described elsewhere in this chapter.

See Prerequisites for Using the Transactional Tracker.

As part of the query results for synchronous transaction queries the system provides a Details link. The Detail link provides access to the Synchronous Details page in the Service Operations Monitor where you can view logging information. To access and view the logs you must set the logging level on the routing definition of all service operations for which you want to view logging information.

Viewing Integration Network Synchronous Transactional Details

Use the Synchronous Tracker View page (IB_INTNET_TRACKSYN) to view details for synchronous transactions between the local node and remote nodes in the integration network. The page enables you to view the transaction IDs, timestamps, service operation name, service operation version, service operation type, and more for integration network synchronous transactions.

To access the page select PeopleTools, Integration Broker, Integration Network WorkCenter, then in the WorkCenter navigation pane click the Transactional Tracker link, and click the Synchronous Tracker View page. The following example shows the Synchronous Tracker View page:

When you access the page, click the Re-Sync Monitor Data button fetch the data. The system displays the query results in the Results grid, based on the default filters.

The following example shows query results for the QE_CRM mode based on the default Outbound direction filter:

As with all the pages in the Transactional Tracker, the Synchronous Tracker View page features several filter options so that you can view the most relevant data for your business requirements. After you select filter options, click the Filter button to apply the filter(s). View the results in the Results grid. The valid data filters for the Synchronous Tracker View page are:

After a query the results appear on the Transactions and Information tabs in the Results grid.

The following information appears in the Results grid on the Transactions tab:

The following information appears in the Results grid on the Information tab:

Viewing Network Transaction Information for Specific Transactions

This section discusses how to:

• Search for transaction data.

• Access transaction data from query results grids.

• View data for an asynchronous transaction.

• View data for a synchronous transaction.

Understanding Viewing Integration Network Transaction Information for Specific Transactions

The Transactional Tracker features pages for viewing the details of specific transactions. Use the Transactional Tracker Details page to view information for an asynchronous transaction; use the Synchronous Details page to view information for a synchronous transaction.

Before using the Transactional Tracker Details page or the Synchronous Details page see the prerequisites for using the Transactional Tracker described elsewhere in this chapter.

See Defining General Routing Information.

Searching for Transaction Data

You can search for and access the Transactional Tracker Details page or the Synchronous Details page using the Search Details link that appears on the Tracker Overview page, the Tracker Main View page, and the Synchronous Main View page.

Access the pages as follows:

• Tracker Overview page — PeopleTools, Integration Broker, Integration Network WorkCenter, Transactional Tracker. The Tracker Overview page appears.

• Tracker Main View page — PeopleTools, Integration Broker, Integration Network WorkCenter, Transactional Tracker. Click the Tracker Main View tab.

• Synchronous Main View page — PeopleTools, Integration Broker, Integration Network WorkCenter, Transactional Tracker. Click the Synchronous Main View tab.

On each these pages the Search Details link appears under the Network Node list as shown in the following example:

When you click the Search Details link the Search for Transaction Details page (IB_VERIFYNET_SEC) appears where you enter the transaction ID of the transaction you want to view.

Important! The transaction ID that you enter should always be the instance transaction ID.

The following example shows the Search for Transaction Details page:

When you click the Search Details button to search for the transaction the following Multiple Target Nodes (IB_NODELIST_SEC) page appears if the transaction exists on more than one network node:

If the transaction exists on more than one network node, click the name of the node for which you want to view the transaction.

If you selected an asynchronous transaction, the Transactional Tracker Detail page appears in a separate browser window for the transaction on the selected node. If you selected a synchronous transaction, the Synchronous Details page appears in a separate browser window for the transaction on the selected node.

Note. If the Transactional Tracker Detail page or the Synchronous Details page does not appear in a full-size browser window, click the browser Restore button in the upper right-corner of the browser to restore the browser window to full size.

Accessing Transaction Data from Query Results Grids

When you conduct a query on the Tracker Main View page or the Synchronous Main View page the results appear in the Results grid at the bottom of the page. At the end of each row of results is a Details link that provides access to the transaction details for the specific transaction.

Access the pages as follows:

• Tracker Main View page — PeopleTools, Integration Broker, Integration Network WorkCenter, Transactional Tracker. Click the Tracker Main View tab.

• Synchronous Main View page — PeopleTools, Integration Broker, Integration Network WorkCenter, Transactional Tracker. Click the Synchronous Main View tab.

After you select a remote node and synchronize the data the query results appear in the Results grid at the bottom of the page. The following example shows a partial view of the Results grid for an asynchronous query on the Tracker Main View page:

The following example shows a partial view of the Results grid for a synchronous query on the Synchronous Main View page:

Click the Details link for a transaction to launch the Transactional Tracker Details page for an asynchronous transaction or to launch the Synchronous Details page for a synchronous transaction. Note that either page appears in a separate browser window.

Note. If the Transactional Tracker Detail page or the Synchronous Details page does not appear in a full-size browser window, click the browser Restore button in the upper right-corner of the browser to restore the browser window to full size.

Viewing Data for an Asynchronous Transaction

The following example shows the Transactional Tracker Details page:

The Transactional Tracker Details page features transaction information for the sending and receiving node. If errors exist in the transaction the Error Messages and View Error Details links are active and you can click them for additional details. The Resubmit and Cancel buttons on the page are enabled if the status of the transaction is such that these actions are warranted.

The fields that appear on the page are described elsewhere in this section.

You can search for a specific transaction to view or you can launch the Transactional Tracker Details page from the results grid on the Tracker Main page or the Tracker Main View page.

Viewing Data for a Synchronous Transaction

The following example shows the Synchronous Details page:

The Synchronous Details page in the Transactional Tracker has the same format and content of the Synchronous Details page in the Integration Broker Service Operations Monitor, except that you cannot view transactional XML using the page in the Transactional Tracker.

If errors exist in the transaction the Error Messages link is active and you can click the link for additional details. The Resubmit and Cancel buttons on the page are enabled if the status of the transaction is such that these actions are warranted.

The fields that appear on the page are described elsewhere in this section.