Managing AS2 documents

All AS2 document tasks are performed from the AS2 tab's pages. To access the AS2 pages, click the AS2 tab. Initially, the Pending Transmission page appears. However, you can use the navigation bar to access other pages.

When you click the AS2 tab, the navigation bar contains the following:

Sending AS2 documents

To send AS2 documents, use the following procedure.

  1. Click the AS2 tab, then click Send in the navigation bar. The Send Document page appears.
  2. Complete the entries in the Send Document page (see Table 16).
  3. Click the Send button. A message in the gray area above Current Transmission Options indicates whether the file was uploaded to the send directory successfully. The does not indicate whether the document transmission was successful or otherwise. The responsibility for document transmission rests with the engine which subsequently picks up the document from the send directory for packaging and posting. In most cases this transmission will occur within a few seconds.
  4. To send additional AS2 documents, repeat steps 2 and 3.
    Table 16. Send Document page
    Parameter Description

    Participant

    Select the participant who will be sending the file.

    Content Type

    Select the appropriate content type for the file that will be sent.

    Filename

    Type the name of the file to be sent or use the Browse button to select the file.

Resending AS2 documents

WebSphere Partner Gateway - Express makes it easy to resend AS2 documents. Using the Resend Documents page, you can search for sent documents that meet your search criteria and then resend them.

To resend AS2 documents, use the following procedure.

  1. Click the AS2 tab, then click Resend in the navigation bar. The Resend Documents page appears.
  2. Complete the entries in the Resend Document page (see Table 17).
  3. Click the Search button. WebSphere Partner Gateway - Express finds the sent documents that meet your search criteria and displays them in the Resend Documents page.

    This page shows valuable information about the documents, including status information about whether the document was successfully sent previously. There is also View Document icon you can click to view the content of the documents.

  4. To resend one or more documents, click the checkbox for each document you want to resend, and click the Resend button.
    Table 17. Resend Document page
    Parameter Description

    Participant

    Select the participant who sent the documents you want to find.

    Filename

    If you know the name of the file you want to find, enter it. You can use the asterisk as a wildcard character if desired. The default *.* finds all documents that meet the other search criteria.

    Document Status

    Select whether WebSphere Partner Gateway - Express is to find documents that were sent successfully, failed transmission, or both.

    File Size

    Select the size of the AS2 documents you want to find. If you select Specify Size, specify the minimum or maximum size of the document(s) to be located.

    Content Type

    Select the content type of the documents you want to find.

    Date/Time

    Select the date and time when the documents you want to find were sent.

    For start and end dates, you can click the calendar icon to select dates from a pop-up calendar.

Viewing sent AS2 documents

Using the Sent page, you can have WebSphere Partner Gateway - Express search for sent AS2 documents that meet your search criteria.

To view AS2 documents that have been sent, use the following procedure.

  1. Click the AS2 tab, then click Sent in the navigation bar. The Sent Documents page appears.
  2. Complete the entries in the Sent Documents page.
  3. Click the Search button. WebSphere Partner Gateway - Express displays summary statistics for the numbers of successful and failed documents grouped in either hourly or daily intervals depending on the value chosen in the "Display Results" drop down on the Search page. Express will display up to 100 of the most recent intervals depending on the search criteria in the Summary Statistics page.
  4. To view detailed information about all documents in an interval represented by a row in the Summary Statistics page, click the View icon next to the appropriate summary row. This will display the Sent Documents Details page. If you only wish to view only the documents that were successfully transmitted or those that failed, click on the value in the successful or failed column respectively.
  5. To view the contents of an individual document, click the View Document icon next to the document in the sent Document Detail page. This document will only be displayed if it still exists on the file system. It is possible that the historical logs used for the search are still present but the file has been moved or deleted from the file system. If WebSphere Partner Gateway - Express cannot find the file in the location computed from the activity logs, the View Document icon will not be displayed.
  6. To view the contents of an individual document, click the View Document icon next to the document in the sent Document Detail page. This document will only be displayed if it still exists on the file system. It is possible that the historical logs used for the search are still present but the file has been moved or deleted from the file system. If WebSphere Partner Gateway - Express cannot find the file in the location computed from the activity logs, the View Document will not be displayed.
    Table 18. Sent Documents page
    Parameter Description

    Participant

    Select the participant who sent the AS2 documents, or select all participants to search all participants.

    File Size

    Select the size of the AS2 documents you want to find. If you select Specify Size, specify the minimum or maximum size of the document(s) to be located.

    Content Type

    Select the content type of the AS2 documents you want to find, or click All to search all content types.

    Date/Time

    Select the date and time when the documents you want to search were sent. If you select Between, specify the start and end dates and start and end times.

    For start and end dates, you can click the calendar icon to select dates from a pop-up calendar.

    Display Results

    Select whether results are to be displayed by the hour or by the day.

Viewing pending AS2 documents

Using the Pending Transmission page, you can search for AS2 documents that are waiting to be transmitted. This page will rarely return any documents, as the send directory is polled frequently (typically, at 1-second intervals) and the documents are moved to the sent or error directory as appropriate. However, this page does serve a useful role if troubleshooting is required.

To view pending AS2 transmissions, use the following procedure.

  1. Click the AS2 tab, then click Pending Transmission in the navigation bar. The Pending Transmission page appears.
  2. Complete the entries in the Pending Transmission page (see Table 17).
  3. Click the Search button. WebSphere Partner Gateway - Express finds the pending documents that meet your search criteria and displays them in the Pending Transmission page.

    This page shows status information about the pending documents,. There is also a View Document icon you can click to view the content of the documents.

    Table 19. Pending Transmission page
    Parameter Description

    Participant

    Select the participant whose pending documents you want to find.

    Filename

    If you know the name of the file you want to find, enter it. You can use the asterisk as a wildcard character if desired. The default *.* finds all documents that meet the other search criteria.

    File Size

    Select the size of the pending AS2 documents you want to find. If you select Specify Size, specify the minimum or maximum size of the document(s) to be located.

    Content Type

    Select the content type of the documents you want to find.

Viewing AS2 documents pending MDNs

Using the Pending MDN page, you can search for AS2 documents that are pending MDNs. Documents pending MDNs remain pending for 10 minutes - this value is not configurable via the console. The default value is 10 minutes. If the document does not receive an MDN within this time, WebSphere Partner Gateway - Express moves it to the Failed folder.

To view documents pending MDNs, use the following procedure:

  1. Click the AS2 tab, then click Pending MDN in the navigation bar. The Pending MDN page appears.
  2. Complete the entries in the Pending MDN page (see Table 20).
  3. Click the Search button. WebSphere Partner Gateway - Express finds the documents pending MDNs that meet your search criteria and displays them in the Pending MDN page.

    This page shows status information about documents pending MDNs,. There is also a View Document icon you can click to view the content of the documents.

    Table 20. Pending MDN page
    Parameter Description

    Selected Participant

    Select the participant whose pending MDNs you want to find.

    Filename

    If you know the name of the file you want to find, enter it. You can use the asterisk as a wildcard character if desired. The default *.* finds all documents that meet the other search criteria.

    File SIze

    Select the size of the pending AS2 documents you want to find. If you select Specify Size, specify the minimum or maximum size of the document(s) to be located.

    Duration

    Select the length of time that documents can wait for an MDN before being moved to the Failed folder. The default time is 10 minutes.

    Content Type

    Select the content type of the documents you want to find.

Viewing received AS2 documents

Using the Received page, you can search for AS2 documents that have been received by selected participants.

To view received AS2 documents, use the following procedure.

  1. Click the AS2 tab, then click Received in the navigation bar. The Received page appears.
  2. Complete the entries in the Received page (see Table 21).
  3. Click the Search button. WebSphere Partner Gateway - Express displays summary statistics for the numbers of successful and failed documents grouped in either hourly or daily intervals depending on the value chosen in the "Display Results" drop down on the Search page. Express will display up to 100 of the most recent intervals depending on the search criteria in the Summary Statistics page.

    This page shows status information about the received documents,. There is also a View Document icon you can click to view the content of the documents.

  4. To view detailed information about all documents in an interval represented by a row in the Summary Statistics page, click the View icon next to the appropriate summary row. This will display the Received Documents Details page. If you only wish to view the documents which were successfully transmitted or those which failed, click on the value in the successful or failed column respectively.
  5. To view the contents of an individual document, click the View Document icon next to the document in the Received Document Detail page. This document will only be displayed if it still exists on the file system. It is possible that the historical logs used for the search are still present but the file has been moved or deleted from the file system. If WebSphere Partner Gateway - Express cannot find the file in the location computed from the activity logs, the document icon will not be displayed.
    Table 21. Received Documents page
    Parameter Description

    Participant

    Select the participant whose received documents you want to find.

    File SIze

    Select the size of the received AS2 documents you want to find. If you select Specify Size, specify the minimum or maximum size of the document(s) to be located.

    Content Type

    Select the content type of the received documents you want to find.

    Date/Time

    Select the date and time when the documents you want to find were received. For start and end dates, you can click the calendar icon to select dates from a pop-up calendar.

    Display Results

    Select whether results are to be displayed by the hour or by the day.

Copyright IBM Corp. 2003, 2005