Files Tracking

Viewing Contact's Files

The Files window in the MassTransit Administrator application shows all files that are sent, received, or waiting to be sent, on the server or for a particular contact, as well as information about the files themselves - file size, transmission date, contact name, set priorities, and requested services.

To open it:

Files Window Options

In the Files window, you can filter your contacts in order to see only the files that are sent, received, or waiting to be sent for a particular contact. In addition, you are allowed to connect to contacts, to create job tickets and attach them to the files, to reveal mailboxes in Windows Explorer. The job tickets provide detailed information about the transmission, the transmitted files, shipping and billing information, etc.

Note: See the Job Tickets page for more information about job tickets.

All actions available in the Files window are listed below:

  1. Filter the displayed files by contact – select a contact from the User Filter drop-down menu and the files to send, sent, and received from that contact will be displayed in the To Send, Sent, and Received tabs respectively.
  2. Designate files for sending – in the Files window there are two ways to designate files for sending to a contact:

    Note: Designating files in the Files window is available on MassTransit HP servers only.

    1. Drag and drop the files in the To Send tab of the window.
    2. Select a contact from the User Filter drop-down menu and click on the Add Files... button. Then, browse for the files, select them and add them to the list.
  3. Connect to a Server contact – select the desired Server contact from the User Filter and click on the enabled Connect button.

    Note: This action is available on MassTransit HP servers only.

  4. Update the information displayed in the Files window – click Resume or close and reopen the Files window.
  5. Reveal contact's mailbox in Windows Explorer – select a contact that has files in any of the tabs of the Files window or highlight a file and click on the Reveal in Explorer button.
  6. Add job ticket – highlight a file and click on the Add... button. This will display the Job Ticket window. Enter the desired information in it and click on the OK button.

    Note: Find more information about job tickets and how to configure them on the Job Tickets page.

    Note: This action is available on MassTransit HP servers only.

  7. Select a priority for sending of the files – highlight a designated file from the To Send tab and select a predefined priority from the Priority drop-down menu.

    Note: Find detailed information about configuring priorities in the Setting Priorities for Sending Files section of the Transferring Files page.

    Note: This action is available on MassTransit HP servers only.

  8. Select services to be performed for a file – in the Received tab, highlight a file and select a service from the Services drop-down menu. The selected service will be displayed in the Requested Service column of the files table.

    Note: Find detailed information about configuring services on the Services page.

    Note: This action is available on MassTransit HP servers only.

  9. Process a service – highlight a file from the Received tab of the window, select a service if there is not a selected one, and click on the Process button.

    Note:This action is available on MassTransit HP servers only.

  10. Filter the received files by the status of the assigned services – in the Received tab of the Files window, select a service status from the Status Filter drop-down menu. You can filter the files by the following statuses:

    1. All – displays all files.
    2. All Not Completed – displays all files that haven't been processed by a service.
    3. Holding – displays all received files.
    4. Error – displays all files where an error occurred during a service execution.
    5. Queued – displays the files which are queued to a service.
    6. Processing – displays the files which currently are being processed by a service. The files processing is quite fast so you may not see any files if this filter is selected.
    7. Completed – displays all files where a service has been completed.
  11. Remove files from MassTransit – there may be times when you want to remove a file from your system, either without processing it or after you have already processed it and sent a copy to your contact. Or, the list of files you’ve sent may be too long and you may want to reduce it. A long file list may slow MassTransit down. Whenever you remove a file from one of MassTransit’s default locations (for example, a received file in the Received tab or folder or a file for sending in the To Send tab or folder), MassTransit asks you if you want to move files to the trash. However, if you remove a file that is in a custom mailbox folder, only its name is removed from the list; the file and its location remain unchanged. If you want to delete or move such a file, you must do so using the Windows Explorer. If you want to remove only entries for files that have already been sent or for received files that have already been processed, you can have MassTransit remove those entries automatically. This automatic deletion does not affect entries for files that are waiting to be sent or entries for files that have been received and not processed. Furthermore, automatic deletion does not delete the files themselves. You need to remove the files manually. Automatic file-entry deletion only affects entries in the Files window.
    1. To remove a file from MassTransit manually, follow these steps:
      • In the Files window, select a file you want to remove from any tab.
      • Press Shift and click to select multiple nonadjacent files. You can also press Control and click to select/deselect an individual file. To select all, choose Select All from the Edit main menu, or press Control+A.
      • Click on the Remove button. If the file you are removing is in the default mailbox folder, MassTransit asks whether to move the file to the Trash. Select Delete or click Cancel. If the file you are removing is not in its default location, clicking Remove eliminates the item from the list, but leaves the file itself in its current location.
    2. To remove files entries automatically, follow these steps:
      • Open the Setup window of the MassTransit Administrator by clicking on the Setup button from the Navigation Bar or by selecting the Setup... option from the Window main menu.
      • Open the Special tab of the Setup window.
      • From the Log and File Handling section, select the Clear File Entries Older Than __ Days checkbox and type an age in days.

Note: For more information about the Files window and its options, please refer to the Tracking page.

Controlling the Interval Between Removing File Entries

When you have set automatic removing of files (step 11b above), you can make changes to the MassTransit.cfg file to control the interval of deleting the files concerning low disk space:

If you need to, you can configure automatic removing of queued (To Send) file entries when the files cannot be found. Enabling automatic removing can avoid repeated errors if forwarded or programmatically added files are removed from their source locations.

  1. Open the MassTransit.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
    1. for MassTransit 7.6 and later:
      • on 64-bit machines:

      C:\Program Files (x86)\Acronis\MassTransit Server

    2. for MassTransit 7.1 to 7.6:
      • on 32-bit machines:

      C:\Program Files\Group Logic\MassTransit Server

      • on 64-bit machines:

      C:\Program Files (x86)\Group Logic\MassTransit Server

    3. for MassTransit 7.0.x:
      • on 32-bit machines:

      C:\Program Files\Group Logic\MassTransit Server 7

      • on 64-bit machines:
      • C:\Program Files (x86)\Group Logic\MassTransit Server 7
  2. Locate the Missing Queued Files Settings section.

    Note: Settings with a '%%' preceding them are not enabled. Delete the '%%' symbols at the front of the line in order to activate the settings.

  3. Configure the following setting:

    PURGE_TO_SEND_RECORDS = TRUE – setting this option to TRUE enables the automatic removing of missing queued file entries from the Files window; when set to FALSE, MassTransit will not remove the file entries from the To Send queue.

    Note: If the queued files are on remote volumes, enabling this will unqueue the files permanently if the remote volume is inaccessible.

  4. Save and close the MassTransit.cfg file.
  5. Restart the MassTransit services in order to apply the changes immediately:
    1. Go to Start → Control Panel → Administrative Tools → Services;
    2. Highlight the MassTransit (for MasTransit SFTP, the service name is MassTransit SFTP) service and click on the Stop button from the Services tool bar, or select the Stop option from the context menu of the service.
    3. Highlight the MassTransit Transporter service and click on the Restart button from the Services tool bar, or select the Restart option from the context menu of the service;
  6. Locate the Log/File Aging [in seconds] section and configure the desired settings. This section controls how often and how long garbage collection of log and job browser records occurs. Settings with a '%%' preceding them are not enabled.
             a. FILE_AGE_INTERVAL = – configure this setting (in seconds) to set at what interval the file entries should be removed from the Files window;
             b. FILE_AGE_DURATION = – configure this setting (in seconds) to set how long the file entry removing should last.
  7. Save and close the MassTransit.cfg file.
  8. Restart the MassTransit services in order to apply the changes immediately:
    1. Go to Start → Control Panel → Administrative Tools → Services;
    2. Highlight the MassTransit (for MassTransit SFTP, the service name is MassTransit SFTP) service and click on the Stop button from the Services tool bar, or select the Stop option from the context menu of the service.
    3. Highlight the MassTransit Transporter service and click on the Restart button from the Services tool bar, or select the Restart option from the context menu of the service;
    4. Highlight the MassTransit (for MassTransit SFTP, the service name is MassTransit SFTP) service and click on the Start button from the Services tool bar, or select the Start option from the context menu of the service.
Automatic Removing of Queued Files

If you need to, you can configure automatic removing of queued (To Send) file entries when the files cannot be found. Enabling automatic removing can avoid repeated errors if forwarded or programmatically added files are removed from their source locations.

  1. Open the MassTransit.cfg in an application suitable for plain text editing. By default, this file is placed on the system drive in:
    1. for MassTransit 7.6 and later:
      • on 64-bit machines:

      C:\Program Files (x86)\Acronis\MassTransit Server

    2. for MassTransit 7.1 to 7.6:
      • on 32-bit machines:

      C:\Program Files\Group Logic\MassTransit Server

      • on 64-bit machines:

      C:\Program Files (x86)\Group Logic\MassTransit Server

    3. for MassTransit 7.0.x:
      • on 32-bit machines:

      C:\Program Files\Group Logic\MassTransit Server 7

      • on 64-bit machines:
      • C:\Program Files (x86)\Group Logic\MassTransit Server 7
  2. Locate the Missing Queued Files Settings section.

    Note: Settings with a '%%' preceding them are not enabled. Delete the '%%' symbols at the front of the line in order to activate the settings.

  3. Configure the following setting:

    PURGE_TO_SEND_RECORDS = TRUE – setting this option to TRUE enables the automatic removing of missing queued file entries from the Files window; when set to FALSE, MassTransit will not remove the file entries from the To Send queue.

    Note: If the queued files are on remote volumes, enabling this will unqueue the files permanently if the remote volume is inaccessible.

  4. Save and close the MassTransit.cfg file.
  5. Restart the MassTransit services in order to apply the changes immediately:
    1. Go to Start → Control Panel → Administrative Tools → Services;
    2. Highlight the MassTransit (for MasTransit SFTP, the service name is MassTransit SFTP) service and click on the Stop button from the Services tool bar, or select the Stop option from the context menu of the service.
    3. Highlight the MassTransit Transporter service and click on the Restart button from the Services tool bar, or select the Restart option from the context menu of the service;
    4. Highlight the MassTransit (for MassTransit SFTP, the service name is MassTransit SFTP) service and click on the Start button from the Services tool bar, or select the Start option from the context menu of the service.