PIP Instance Viewer Browser

You use the PIP Instance Viewer browser to view preamble and service header information for individual messages within a PIP.

This diagram illustrates the PIP Instance Viewer browser, displaying PIP details.

This diagram illustrates the PIP Instance Viewer browser, displaying document (message) details.

Information organization

The information on the PIP Instance Viewer browser is organized in a hierarchical manner, described in the following table.

Level selected (left pane) How to access Information displayed (right panes)
Partner Open PIP Instance Viewer browser Displays the PIPs for the selected partner.
PIP Open Partner node and select a PIP Displays the PIPs for the selected partner.
  • Document Name
  • Date-Time Stamp
  • Document IID (Document Instance Identifier)
  • Attempt Count

If any of these components are missing or not appropriate for a particular interchange, they are not displayed.
Document (Message) Open PIP node and select a message The upper right pane, displays the detail information for the selected message.

The lower right pane, displays the XML for the instance selected in the left pane (if available).

Parts and functions

This table describes the parts of the PIP Instance Viewer browser.

Part Function
(left pane—PIP Instance tree view) Displays an alphabetically organized hierarchical list of all the partners, PIPs, PIP Instance IDs (PIP IIDs), and documents (messages) that were sent or received.

See Information organization for more information on contents at each level. See PIP Instance Viewer tree view icons for more information on status icons.
(upper right pane—detailed list view) Displays a detailed list of the selected PIP or document. The information displayed depends on the level.
(lower right pane—HTML view) Displays the XML for the instance selected in the left pane (if available).
Note:
  • This option is only available if a single item is selected from the detailed list.
  • This option is only available if there is a file associated with the document (message) in the Sterling Gentran:Server® IntIn or IntOut folder.
Upper right pane (Partner selected in left pane)
PIPs Displays sequence number assigned by Sterling Gentran:Server for RosettaNet to uniquely identify the PIP instance.
  • The PIP Instance Key number is not associated with the PIP to which the message belongs.
  • Multiple messages from a single PIP all have the same document identity instance ID.

See PIP Instance Viewer tree view icons for more information on PIP Instance Viewer status icons.
Upper right pane (PIP selected in left pane)
PIP IID Displays the PIP IID assigned by Sterling Gentran:Server for RosettaNet to uniquely identify the PIP instance.
Note:
  • The PIP IID number is not associated with the PIP to which the message belongs.
  • Multiple messages from a single PIP all have the same document identity instance ID.

See PIP Instance Viewer tree view icons for more information on PIP Instance Viewer status icons.
Document Name Displays a unique ID from the service content of the selected message.
Date-time stamp Displays the date and time of the message from the preamble, in ISO 8601 format.
YYYYMMDDTHHMMSS.SSSZ

Where:

  • YYYY = the year
  • MM = the month
  • DD = the day
  • T = a separator between the date and time
  • HH = the hour
  • MM = the minute
  • SS = the second
  • .SSS = the hundredths of a second
  • Z = the end of the date/time indicator
Document Identity Instance ID Displays the unique PIP identifier from the document identity portion of the service header.

Every message in a single PIP has the same document identity instance ID.
Attempt Count
  • For outbound messages, indicates the number of times Sterling Gentran:Server for RosettaNet attempted to send the message.
  • For inbound messages, indicates the number of times the message was received by the partner.
Upper right pane (message selected in left pane)
This pane displays specific information from the preamble, delivery header, and service header of the selected document.

PIP Instance Viewer tree view icons

This table lists the icons that the system may use in the tree view (left pane) of the PIP Instance Viewer browser.

Each PIP Instance Identifier (PIP IID) can contain one or more messages, and each document has a status value, which determines which icon is displayed in the tree view. If any document under a PIP IID has a status of "closed," the "Closed" icon is displayed for that PIP IID. The order of display is as follows:

  1. Closed
  2. Error
  3. Warning
  4. Resend
  5. Open (no icon)

For example: If a PIP IID contains 3 messages which are status Error, Warning, and Resend, respectively. In this case, the Error icon is displayed at the PIP IID level, to notify you that there is at least one message that is in error and that no messages for this PIP IID have a status of "closed.".

Icon Description
This is the PIP Instance Viewer root icon.
(handshake) — Signifies a partner.
(blue square) — Signifies a PIP.
  (no icon) — Indicates the document status is "open."
(green sphere) — Indicates the document status is "closed."
(red sphere) — Indicates the document status is "error."
(yellow sphere) — Indicates the document status is "warning."
(yellow folder) — Indicates the document status is "resend" or indicates a PIP IID or message.