Queue Service Setup

MoversSuite Administration > Administration > Queue Service Setup

 

This setup enables you to define a location for processed MoversSuite Queue Service message files for each integration your company exchanges data with. For example, you can define a path that points to a folder titled, “REGI” for all UniGroup Registration Download files. Once a message has been processed successfully, a copy of the original message is written this folder and the XML has been imported into MoversSuite or written to the third party error log (Third Party Application Error Management).

 

By default the MoversSuite queuing services automatically creates a folder location for message files. This setup, however, overrides this default and allows you to define a particular path location for message files by a particular message type, i.e. UniGroup Registration Download.

 

 

IMPORTANT

The folders the Queue Service writes to will eventually contain a large number of files that can require a lot of disk space. MoversSuite nor the Queue Service manages these folders and their content once a message has been written to a folder. Therefore, we suggest that you frequently manage these folders to avoid running out of physical disk space. Message files typically contain the date and time in their file name, which can assist you in identifying obsolete files.

 

Typical message file format:

 

[YYMMDD] + [HHMMSSssss] + [GUID] + [FILE EXTENSION]

 

Example:

1510312034187280b827fc90-9f0a-4fd7-8ae9-326cd768a266.xml

Where:

YYMMDD is the UTC date, e.g. “151031” for October 31, 2015

HHMMSSssss is the UTC time, “2034187280” for 10:34 p.m. UTC time and 18:72;80 seconds.

GUID is the unique message identifier, e.g. “b827fc90-9f0a-4fd7-8ae9-326cd768a266”

FILE EXTENSION is either .xml, .txt, depending on the associated message type (all types create .xml files except for Atlas Suds Download and EasyDPS, which create .txt message files)

 

 

 

Use the following table to define how your MoversSuite integrations treats an imported message file.

 

Field

Description

Queue Service Message Type

Select the message type record appropriate for the service you wish to receive a copy of the message file for through the MoversSuite queuing service. For each type selected, you will be required to provide an Export Path, which is the location of the processed files for the selected service.

The message type selected in this field also determines the format of the processed messages.

Currently, MoversSuite supports the following message type:

Atlas Suds Download

EasyDPS Download

MSS Document Download Property

MSS Document Download Xml

MSS Documents Download Property

MSS Documents Download Xml

UniGroup Dispatch Download

UniGroup Distribution Download

UniGroup HHG Upload

UniGroup Local Intra Quote Download

UniGroup MemoPad Upload

UniGroup Quotes-To-Go Opportunity Download

UniGroup Rating Download

UniGroup Registration Download

UniGroup Special Services Download

UniGroup Statement Download

UniGroup Survey Download

UniGroup TransDocs Download

UniGroup TransDocs Error Download

UniGroup TransDocs Upload

 

Inactive

Check this flag to mark the record as inactive, meaning that it will no longer be referenced by MoversSuite when processing services through the queuing service.

By default, newly defined records are active (this flag is unchecked).

Export Path

Enter the fully qualified path name on your application server that will store message files from the queuing service (up to 255 characters), e.g. “http://company-server/MSSQ/UniGroup/REGI/.

The user account running the Queue Service must have WRITE permission to the folder specified as the Export Path. This allows the Queue Service the ability to add message files to the folder and to create the folder itself if one does not exist.

 You can use the same Export Path for multiple message types, if desired.