Enterprise PeopleTools 8.50 PeopleBook: Integration Broker Service Operations Monitor

Viewing Asynchronous Service Operation Details

This chapter discusses how to:

View asynchronous service operation instance details.
View asynchronous publication contract details.
View asynchronous subscription contract details

Understanding Viewing Asynchronous Service Operation Details

The Asynchronous Details component (IB_MONITOR_DET) enables you to gather in-depth information about a specific asynchronous service operation. It also enables you to perform tasks such as correct errors and resubmit service operations.

Note. The pages and tabs in the Asynchronous Details component appear in read-only mode if you do not have the proper permissions.

Common Elements Used to View Asynchronous Service Operation Details

Cancel	Click the Cancel button to cancel processing attempts for a service operation. This button is enabled when a service operation has a status of New, Retry, Time Out, Error, or Edited.
Edit XML	An Edit XML link appears when there are errors with the transaction. Click the link to edit the service operation instance, publication contract or subscription contract XML to correct errors. If you do not have appropriate permission for the particular service operation being viewed, this link is disabled.
Error Messages	This link can appear in the service operation instance details section, the publication contracts section, or the subscription contracts section. Click the link to view error messages for these items. If the link is disabled, there are no errors to view or you do not have the appropriate permissions to view the information.
Last Update Date/Time	Displays the date and time the transaction was last updated.
Process Identifier	Identifies the process ID on the local application server.
Resubmit	Click the Resubmit button to resubmit a service operation for processing. This button is enabled when a service operation has a status of Time Out, Error, Edited, or Cancelled. If a service operation contains an error or has timed out, typically you can just correct the problem and resubmit the service operation. After you edit a service operation, the status becomes Edited. When you resubmit the service operation, the status changes, yet again, to New. If you do not have appropriate permission for the particular service operation being viewed, this button is disabled.
Retry Count	If the first attempt to deliver the service operation failed, this value reflects the number of times the system has attempted to resend the service operation.
Segment	If using message segments, indicates the segment number for which the page or section is displaying information. If you are using nonsegmented messages, a value of 1 appears. When working with asynchronous operation instance details, use the Segment drop-down list box to select a different segment for which to view information. Click the Refresh button to refresh the page.
Service Operation	Indicates the name of the service operation.
Status	Status of the service operation in the system. Descriptions of the possible service operation statuses are described elsewhere in this chapter.
Transaction ID	Displays the unique identifier that the system assigns to each transaction.
Transaction Type	Indicates the transaction type. The valid values are: Inbound synchronous. Outbound synchronous.
Version(Service operation)	Indicates the service operation version.
View IB Info	Click the link to view IB info. If you do not have appropriate permission for the particular service operation being viewed, this link is disabled.
View XML	Click to view XML for the service operation instance, publication contract or subscription contract. If you do not have appropriate permission for the particular service operation being viewed, this link is disabled.

Viewing Service Operation IB Info Data

Viewing Service Operation Errors

Viewing and Editing Service Operation XML

Viewing Service Operation Nonrepudiation Signature Information

Viewing Asynchronous Service Operation Instance Details

Use the Asynchronous Details page (IB_MONITOR_DET) to view asynchronous service operation instance details. To access the page, select PeopleTools, Integration Broker, Service Operations Monitor, Monitoring, Asynchronous Details. The following example shows the Asynchronous Details page:

The section at the top of the Asynchronous Details page provides general information pertaining to a particular service operation instance to assist in troubleshooting.

When you are monitoring outbound asynchronous integrations, a Publication Contracts grid appears at the bottom of the page. When you are monitoring inbound asynchronous integrations, a Subscription Contracts grid appears at the bottom of the page. These grid are described elsewhere in this chapter.

See Viewing Asynchronous Publication Contracts Details, Viewing Asynchronous Subscription Contracts Details.

External Service Name	Indicates the name of the service operation sent by the sending node.
Publishing Node	Identifies the name of the sending node.
Queue Name	Identifies the queue to which the service operation is associated.
Queue Sequence ID	Identifies the sequence of a particular service operation in a queue. This field is applicable to only service operations in ordered queues.
Sub Queue	If queue partitioning exists for a queue, indicates the name of the sub queue to which the service operation is associated.
Original Publishing Node	Indicates the name of the original sending node. In most cases the original publishing node and the publishing node are the same. However, if the service operation goes through a hub, the original publishing node and publishing node differ.
Refresh	Click the button to refresh page data.
Archive	Click the Archive button to archive a service operation. This button is enabled when a service operation has a status of Done or Cancelled and no associated contract has pending work. If the queue is not set up for archiving, the Archive button is replaced with a Delete button. .
Uncompressed Data Length	Indicates the size of the XML service operation in bytes.
Data Length View Limit	Indicates the maximum size of an XML document in bytes that is automatically loaded in the XML Viewer page. The default is 100000 bytes. Set this property in the Service Operations Monitor using the Monitor Setup Options page. See Setting the Data Length View Limit for Displaying XML.

Other page elements that appear on the page are discussed elsewhere in this section.

Resubmitting and Canceling Service Operations for Processing

Viewing Service Operation IB Info Data

Viewing Service Operation Errors

Viewing and Editing Service Operation XML

Viewing Service Operation Nonrepudiation Signature Information

Viewing Asynchronous Publication Contracts Details

Use the Publication Contracts section of the Asynchronous Details page to view asynchronous publication contract details. The following example shows this section:

Note. The section displays only when there are publication contracts associated with the service operation.

Viewing and Working with Publication Actions

The Actions tab reveals all the nodes subscribing to a particular service operation and the current status of the publication contract, as in whether the publication has been successfully posted to the subscribing node.

The Actions tab in the Publication Contracts section provides the following information.

Subscriber Node

Identifies the name of the subscribing or receiving node.

Other page elements that appear on the page are discussed elsewhere in this section.

Resubmitting and Canceling Service Operations for Processing

Viewing Service Operation IB Info Data

Viewing Service Operation Errors

Viewing and Editing Service Operation XML

Viewing Publication Information Details

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

The Information tab contains the following information about the publication contract:

Signature

When nonrepudiation is implemented, this page element displays as a hyperlink.

Click the link to view nonrepudiation information associated with the publication contract.

Other page elements that appear on the page are discussed elsewhere in this section.

Viewing Service Operation Nonrepudiation Signature Information

Viewing Asynchronous Subscription Contracts Details

Use the Subscription Contracts section of the Asynchronous Details page to view asynchronous subscription contract details. The following example shows this section:

Note. The section displays only when there are subscription contracts associated with the service operation.

Viewing and Working with Subscription Actions

The Actions tab of the Subscription Contracts section of the Asynchronous Services page reveals the status of a particular subscription contract.

Note. The page elements that appear on the page are discussed elsewhere in this section.

Resubmitting and Canceling Service Operations for Processing

Viewing Service Operation IB Info Data

Viewing Service Operation Errors

Viewing and Editing Service Operation XML

Viewing and Working with Subscription Information

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

Note. The page elements that appear on the page are discussed elsewhere in this section.

Setting the Data Length View Limit for Displaying XML

The data view length limit determines the size of service operation XML (in bytes) that is automatically loaded into the XML Viewer in the Asynchronous Details component.

The default is 100000 bytes.

If the limit is exceeded, you are given the option of downloading and uploading the XML to view it or make changes.

You can change the default value using the Monitor Setup Options page in the Services Operations Monitor.

To set the data length view limit:

Select PeopleTools, Integration Broker, Service Operations Monitor, Administration, Monitor Setup Options.

The Monitor Setup Options page appears.
In the Data Length View Limit box, enter a value in bytes.

Note. Do not enter a negative value.

Click the Save button.