AS1/AS2 Viewer

Use the AS1/AS2 Viewer to search for and view transport information for documents using the AS1 or AS2 communication protocol. You can view message IDs, Message Disposition Notification (MDN) destination URI and status, and document details (the document and wrapper).

The AS1/AS2 Viewer can also be used to view packaged B2B transactions and B2B process details that use the AS1 or AS2 (Applicability Statement 1 or 2) communication protocol. You can view the choreography of the B2B process and associated business documents, acknowledgment signals, process state, HTTP headers, and contents of the transmitted documents.

Like its predecessor AS1, which defines a standard for data transmissions using SMTP, AS2 defines a standard for data transmissions using HTTP.

AS2 identifies how to connect, deliver, validate, and reply to data; it does not concern itself with the content of the document, only the transport. AS2 creates a wrapper around a document so that it can be transported over the Internet using HTTP or HTTPS. The document and wrapper together is called a message. AS2 provides security and encryption around the HTTP packets. Another bonus with AS2 is that it provides a measure of security not found in FTP. AS2 provides an encryption base with guaranteed delivery.

An important component of AS2 is the receipt mechanism, which is referred to as an MDN (Message Disposition Notification). This ensures the sender of the document that the recipient has successfully received the document. The sender specifies how the MDN is to be sent back (synchronously or asynchronously; signed or unsigned).

You can use the AS1/AS2 Viewer to view the message ID, Time Stamps, Document Flow, Gateway Type, Synchronous status, as well as document details. Additional document processing information is displayed when viewing document details.

Performing AS1/AS2 Viewer tasks

Table 17. AS1/AS2 Viewer tasks
What do you want to do? See

Search for messages

page Searching for RosettaNet processes

Viewing raw documents

page Viewing raw documents

Searching for messages

  1. Click Viewers > AS1/AS2 Viewer. The system displays the AS1/AS2 Viewer screen.
  2. Select the search criteria from the drop-down lists.
    Table 18. AS1/AS2 Viewer search criteria
    Value Description

    Start Date and Time

    Date and time the process was initiated.

    End Date and Time

    Date and time the process was completed.

    Participant

    Identifies the participant (Community Manager only).

    My role is the

    Specifies if the participant is the source (initiating) or the target (receiving).

    Initiating Business ID

    Business identification number of the source participant, for example, Duns.

    Gateway Type

    Production or test. Test is only available on systems that support the test gateway type.

    Package

    Describes the document format, packaging, encryption, and content-type identification.

    Protocol

    Document format available to the participants, for example, RosettaNet of XML.

    Document Flow

    The specific business process.

    Message ID

    ID number assigned to the AS1 or AS2 packaged document. Search criteria can include the asterisk (*) wildcard. Maximum length, 255 characters.

    Synchronous Filter

    Search for documents received in synchronous mode. This means that the connection between the initiator and the Document Manager stays open until the transaction is complete, including request and Message Disposition Notification (MDN).

    Sort by

    Sort results by this value.

    Descend or Ascend

    Ascend - Displays the oldest time stamp first or the end of the alphabet.

    Descend - Displays the most recent time stamp or the beginning of the alphabet.

    Results per page

    Use to select the number of records displayed per page.

  3. Click Search. The system displays a list of messages.

Viewing message details

  1. Click Viewers > AS1/AS2 Viewer. The system displays the AS1/AS2 Viewer screen.
  2. Select the search criteria from the drop-down lists.
  3. Click Search. The system displays a list of messages.
  4. Click the View details icon next to the message that you want to view. The system displays the message and the associated document details.

    Table 19. AS1/AS2 Viewer: Package Details
    Value Description

    Message ID

    ID number assigned to the AS1 or AS2 packaged document. This number identifies the package only. The document itself has a separate Document ID number that is displayed when viewing the document details. Maximum length, 255 characters.

    Source Participant

    Participant initiating a business process.

    Target Participant

    Participant receiving the business process.

    Initiating Time Stamp

    Date and time the document begins processing.

    Gateway Type

    Test or production. Test is only available on systems that support the test gateway type.

    MDN URI

    The destination address for the MDN. The address can be specified as a HTTP URI, or an e-mail address.

    MDN Disposition Text

    This text provides the status of the originating message that was received (either successful or failed). Examples include the following:

    • Automatic-=action/MDN-sent-automatically; processed.
    • Automatic-action/MDN-sent-automatically;processed/Warning;duplicate-document.
    • Automatic-action/MDN-sent-automatically;processed/Error;description-failed.
    • Automatic-action/MDN-sent-automatically;failed:unsupported MIC-algorithms.
  5. (Optional) Click the Display raw document icon to view the raw document.

Copyright IBM Corp. 2003, 2005