This section describes the setup necessary to support the Atlas Revenue Import process for XML formatted requests. Additional setup is needed as specified within the Atlas Integration Initial Setup topic.
Prerequisites
The following instructions operate under the assumption that the basic support for Atlas Integration is enabled as described within the Atlas Integration Initial Setup section, which details all initial setting required to support the various Atlas Integration processes.
Create Atlas Queue Service
Establish a queue service for the Atlas Revenue Download within Queue Service Server Setup. This record defines the process and the folders referenced for XML files. Provide the specified options to enable the Atlas queue service.
Figure 1: Queue Service Server Setup
|
Field |
Value |
|
Queue Service System |
MoversSuite Queue Service |
|
Queue Server Name |
Atlas Revenue Download |
|
Discard All Bad Messages |
Unchecked |
|
Inactive |
Unchecked |
|
Parent Folder for File System Queues |
Provide the base location for downloaded files managed on your system. For example, if you make available a path of D:\QueueService\AtlasMQ, then files within the server for request, retries, and errors are stored on the D: drive within the QueueService\AtlasMQ folder. |
|
Queue Service Server Queue |
Establish roles for a Request Queue, Retry Queue, and Error Queue detailed in the following section. |
For the same Atlas Revenue Download record (Figure 1,) create the following three roles:
1. Request Queue Role
Figure 2: Example service queue within Queue Service Server Setup
|
Field |
Value |
|
Queue Role |
Request Queue |
|
Queue Type |
File System Folder |
|
Queue Folder Name |
Provide the sub-directory for initial message files downloaded to your system. This sub-directory lists beneath what is specified for the Parent Folder for File System Queues. For example, if you set this to Request and the parent folder is D:\QueueService\AtlasMQ, then the application puts the request files within the D:\QueueService\AtlasMQ\request directory. |
|
Filter |
*.XML |
|
Minimum Message Age |
10000 |
|
Message Type |
XML Messages |
2. Retry Queue Role
Figure 3: Example service queue within Queue Service Server Setup
|
Field |
Value |
|
Queue Role |
Retry Queue |
|
Queue Type |
File System Folder |
|
Queue Folder Name |
Provide the sub-directory for message files that failed to download and are placed in a queue to re-attempt the download. This sub-directory lists beneath what is specified for the Parent Folder for File System Queues. For example, if you set this to Retry and the parent folder is D:\QueueService\AtlasMQ, then the application puts the retry files within the D:\QueueService\AtlasMQ\retry directory. |
|
Filter |
*.XML |
|
Minimum Message Age |
10000 |
|
Message Type |
XML Messages |
3. Error Queue Role
Figure 4: Example service queue within Queue Service Server Setup
|
Field |
Value |
|
Queue Role |
Error Queue |
|
Queue Type |
Microsoft Messaging |
|
Path to the Microsoft Messaging Queue |
Provide the path to the directory for message files that cannot be reprocessed, e.g. .\private$\mss_atlasRevenue_error. This is generally a private folder within the Microsoft Queuing System folder structure. |