Professional Documents
Culture Documents
TLM Recs Premium Admin Guide 2.5.0.0
TLM Recs Premium Admin Guide 2.5.0.0
Administration Guide
DISCLAIMER
SmartStream Technologies makes no representations or warranties regarding the contents of this document. We reserve the right to revise this
document or make changes in the specifications of the product described within it at any time without notice and without obligation to notify any
person of such revision or change.
COPYRIGHT NOTICE
2000 - 2015 Copyright of SmartStream Technologies. All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted in any form or by any means - electronic, mechanical, photocopying, recording, or otherwise - without the prior written
permission of SmartStream Technologies Limited.
INTELLECTUAL PROPERTY WARNING
The contents of this document and the software it describes are the intellectual property of SmartStream Technologies Limited. The ideas
contained in this document must not be disclosed to any third party.
TRADEMARK NOTICE
TLM® is a registered trademark of SmartStream Technologies Ltd. All rights reserved.
Other trademarks recognised and property of their respective owner.
DOCUMENT INFORMATION
September 2015
Contents
Contents...................................................................................................................................................1
Introduction .............................................................................................. 7
1
Introduction
2
Introduction
3
Introduction
4
Introduction
Configuring Pass............................................................................................................................235
Configuring Pass List ....................................................................................................................236
Configuring Initiation ....................................................................................................................237
Submitting Initiation ......................................................................................................................238
5
Introduction
6
Introduction
Introduction
This guide is aimed at users responsible for the administration and maintenance of TLM Reconciliations-Premium.
This guide describes how to configure accounts, notes, user limits, and other configurable options for use with TLM
Reconciliations-Premium.
7
Introduction
• Configuring Exception Messaging describes how to create message types and templates for outbound messages
and the regular expressions required to match incoming messages to existing exceptions.
• Data Loading describes how to work with the data files and messages that have been loaded into the system, and
how to input messages manually.
• Running initiations describes how to run initiations when auto matching is disabled, or to resubmit an account.
• Maintaining and Loading General Ledger Static Data describes how to create the static data objects required for
General Ledger Reconciliations and how to load GL static data files.
• Loading Messages describes how to work with KBs for message loading.
• Configuring Archiving describes the archiving process.
• Creating custom reports describes how to create your own reports using the BIRT report designer.
• Configuring the Auto Matching Workflow describes how to configure the workflow required for the TLM
Reconciliations-Premium automatic matching functionality, using the Recon Admin client.
• Configuring Drools describes the supplied Drools spreadsheets and how to configure them.
• Software Support includes the contact details for SmartStream Support.
• Appendix I provides a list of all available elements that can be used in creating a message template.
Related information
8
Introduction
Example Describes
Right-click Click the right mouse button
Double-click Click the left mouse button twice in rapid succession without moving the
mouse
Drag Press and hold down the left mouse button, move the mouse, then release
the mouse.
Represents a link
Represents a note
If you are unable to find the solution to your problem in this help, please contact SmartStream Technologies Support.
9
Maintaining Sets
Maintaining Sets
Sets are used to track reconciliations. The overall state of reconciliations is monitored at the set level.
All Recs Premium accounts must be setup using WebConnect Dashboards and it is not recommended to create the
sets using TLM ReconAdmin application.
10
Maintaining Sets
• If you use the Search Prompt – REC Admin Set Details Grid window, it results in displaying a list of all
available sets with various columns.
11
Maintaining Sets
12
Maintaining Sets
The application provides the possibility for creating sets wherever it makes sense. This section only describes the
main access points for how to create sets.
1. Do one of the following:
• Select Menu > Set Administration > New Set.
• Select Menu > Set Administration > Set > Sets.
1. Enter your search criteria and click [Search].
2. In the resulting list right-click on a node in the tree to select New Set.
The New Set dashboard is displayed.
2. Populate the fields as required.
The following table describes the configurable fields available in the New Set and Update Set dashboards:
Field Description
Set Enter the set ID. This field can accept value up to 60 characters.
Business Name Enter the business name. This field can accept value up to 60 characters.
Category Click the more […] button to select a category.
The category is a code for a sub-custodian or correspondent that receives and delivers
Securities or Cash transactions on behalf of a global custodian/counterparty. A category
can be responsible for one or more sets.
Currency Click the more […] button to select the set currency.
Charge Currency The currency for any charges.
Reconciliation Basis The default is 2-way that is for matching Ledger items with Statement items. Can also be
set to 3-way, which requires an additional ‘Alternate’ side item for matching.
Set Basis Select the set basis for the set from the drop-down list.
The options are:
13
Maintaining Sets
Field Description
• Double Entry
• Mirror
Reconciliation Type Select the reconciliation type for the set from the drop-down list.
Financial Parameters Click the more […] button to select the financial parameters lead set ID.
Lead Set ID
Data Load Lead Set ID Click the more […] button to select the data load lead set ID.
Workflow Lead Set ID Click the more […] button to select the workflow lead set ID.
Latest Ledger Date Click the calendar button and select the latest ledger date for the set.
Latest Stmt Date Click the calendar button and select the latest statement date for the set.
Swift Address The Swift address for any Swift communications.
Email Address The email address for any email communications.
Chart of accounts For GL Recs only. Select the chart of accounts to be used for the set.
Calendar For GL Recs only. Select the fiscal calendar to be used for the set.
Currency Group For GL Recs only. Select the currency group to be used for the set.
Risk Category For GL Recs only. Select either High or Low. This is usually based on the number of
reconciliations expected on the set.
Territory Code Enter the territory code.
Legal Entity Difference Legal Entity reference for the given account.
Default Source Code Source Code to be used as the default for all items loaded on this message.
Remeasured For GL Recs only. Flag which controls if the account should be remeasured following a
balance load.
Target Set Target set used for item bulk copy. Flag which controls whether re-measurement
processing should be done as part of the loading process and is applicable only for General
Ledger sets.
Review Steps For GL Recs only. Select First for a two-step approval process, or select Final for a single-
step approval process.
Reconciler Name For GL Recs only. To assign a specific reconciler to this set, select their user ID from the
list.
First Reviewer For GL Recs only. To assign a first reviewer to this set, select their user ID from the list.
This is required only if First was selected in the Review Steps option.
Final Reviewer For GL Recs only. To assign a final reviewer to this set, select their user ID from the list.
Reporting Owner For GL Recs only. To assign a reporting owner to this set, select their user ID from the list.
Retention Archive retention period for the account.
Purpose Enter the purpose of the set.
3. Click [Save].
The new set is created.
14
Maintaining Sets
The REC Admin Set Detail Ad Hoc dashboard provides the details of all available set.
15
Maintaining Sets
Field Description
Set Basis The set basis for the set, which can be any of the following:
• Double Entry
• Mirror
Reconciliation Type The reconciliation type for the set.
Financial Param The financial parameters lead set ID for the set.
Report Param The Data Load lead set.
Blk Qry Param The Workflow lead set.
Latest Ledger Date The latest ledger date for the set.
Latest Stmt Date The latest statement date for the set.
Risk Category For GL Recs only. Either High or Low. This is usually based on the number of
reconciliations expected on the set.
Review Steps For GL Recs only. Either First for a two-step approval process, or Final for a single-
step approval process.
Territory Code The territory code.
Chart of account For GL Recs only. The chart of accounts used for the set.
Calendar Name For GL Recs only. The fiscal calendar used for the set.
Reconciler Id For GL Recs only. The user ID of the reconciler for this set, if specified.
Reconciler Long Id For GL Recs only. The user ID of the reconciler for this set, if specified.
Reviewer Id For GL Recs only. The user ID of the first reviewer for this set, if specified.
Reviewer Long Id For GL Recs only. The user ID of the first reviewer for this set, if specified.
Final Reviewer Id For GL Recs only. The user ID of the final reviewer for this set, if specified.
Final Reviewer Long For GL Recs only. The user ID of the final reviewer for this set, if specified.
Id
Reporting Owner For GL Recs only. The user ID of the reporting owner for this set, if specified.
Purpose The purpose of the set.
Currency Group The Currency group to use for GL revaluations.
16
Maintaining Sets
17
Maintaining Sets
5. When you have finished making your changes, select to save the information.
The changes are saved to the database and recorded on the audit trail.
18
Maintaining Sets
The application provides the possibility for updating sets wherever it makes sense. This section only describes the
main access points for how to update sets.
1. Select Menu > Set Administration > Set > Sets.
2. Enter your search criteria and click [Search].
3. In the resulting list right-click the required set to select Set Details.
19
Maintaining Sets
20
Maintaining Sets
The account write-off limit is the maximum amount that can be written off for a set. During processing, the lead set
for the set being processed is identified and the amount is compared to the net total of the current group.
If the difference during a match exceeds the account write off limit, a net item is created, which is equal to the
difference amount. If the difference is below the limit, the system, by default, writes it off as a charge.
21
Maintaining Sets
22
Maintaining Sets
23
Maintaining Sets
3. Click [Save].
24
Maintaining Sets
4. Access the next tab at the lower left part of this dashboard.
25
Maintaining Sets
26
Maintaining Sets
Field Description
Balancing balances, and if so, whether you want to record balances only, balances as well
as links to outstanding items, or raise exceptions for unbalanced proofs.
NAV Point In Time Balancing Determines whether point in time balancing is performed for NAV Rec
balances, and if so, whether you want to record balances only, balances as well
as links to outstanding items, or raise exceptions for unbalanced proofs.
Create GL Lifecycle Proof Select Enabled for GL sets only.
27
Maintaining Sets
1. In the Set Details grid, select the set that you want to edit using the selectors on the left.
2. Right-click and select Update Sets.
The Bulk Edit window is displayed.
Where the field values for each of the selected sets are the same, the value is populated in the field, see Status,
Category, and Reconciliation Type in the above example.
Where the field values differ, the field is populated with the text ‘(multiple values)’.
28
Maintaining Sets
29
Maintaining Sets
3. From the Group dropdown list, select the set group you want to add the sets to.
4. Click [Accept].
30
Maintaining Sets
31
Maintaining Sets
32
Maintaining Sets
If your messages have been loaded using GEMS, you should create/update message feeds with the Message Feed
Create/Update Message Feeds/New Message Feed/Update Message Feed dashboards.
If your messages have been loaded using Message Interface (MI), you should create/update message feeds with the
Message Feed Create (MI)/Update Message Feeds (MI)/New Message Feed (MI)/Update Message Feed (MI)
dashboards.
Create or update a message feed (for messages loaded with GEMS), see below
Create or update a message feed with Message Interface options (for messages loaded with MI), page 33
33
Maintaining Sets
The application provides the possibility for creating/updating message feeds wherever it makes sense. This section
only describes the main access points for how to create/update message feeds.
1. Select Menu > Set Administration > Set > Sets / Ad Hoc Message Feeds or select Menu > Ad Hoc
Searches> Set Ad Hoc Search.
2. Enter your search criteria and click [Search].
Depending on what you have selected in the first step, the dashboard displayed varies.
3. Continue with step 4 if the REC Admin Set Summary dashboard is displayed, or continue with step 5 if the
REC Admin Message Feed Ad Hoc dashboard is displayed.
34
Maintaining Sets
4. In the REC Admin Set Summary dashboard, right-click the required set to select Set Details or double-click on
the set that you want to view.
1. In the Set Details window, right-click a set to select Message Feed Create for creating a new message
feed or Message Feed Administration for creating and updating a message feed.
2. If you have selected Message Feed Administration, you must right-click a set in the resulting list to select
New Message Feeds or Update Message Feeds.
5. In the REC Admin Message Feed Ad Hoc dashboard, right-click a set to select New Message Feed/Update
Message Feed.
6. In the dashboard for creating or updating message feed, populate the following fields with the required data.
Field Description
Message Feed Type The message feed type.
Short Code Enter a short code for the feed. This field can accept value up to three characters.
Set ID Enter the internal ID.
By default, the set name for which the feed is being created is displayed.
Message Feed Enter the message feed ID. This field can accept value up to 100 characters.
Description Enter a description for the feed. This field can accept value up to 60 characters.
Latest Stmt Date Click the calendar button to select the latest statement date.
Last Input Click the calendar button to select the date when the feed was last input.
Latest Stmt No Automatically updated upon receipt of messages.
For Cash, it is the number of the last cash statement (MT940 or MT950) received.
Stmt Page Automatically updated upon receipt of messages.
For Cash, this is an actual statement page, but for Securities the statement page is
internally generated.
Latest Message No Automatically updated upon receipt of a message. This is a unique number across the
system which is automatically generated and is not restricted to a particular message.
Item Overrides Default Select the checkbox if you want to prevent the default source code overriding that on
the items in the incoming message feed.
Default Source Code Source Code to be used as the default for all items loaded on this message.
Balance Type Select the balance type from the drop-down list.
The options are:
• Currency Balances
• Dual Cash & Asset Balances
• Generic Asset Balances
• Generic Currency Balances
• No Balances
• Position Balances
• Transaction Balances
Feed Status The current status of the set/message feed. The default is
‘Active’ which allows the receipt and loading of feeds for this set.
Check Duplicate Item Select whether the system should check for duplicate items while loading, from the
drop-down list.
Proposal Triggering Select one of the following Proposal Triggering options from the drop-down menu to
specify the conditions for running auto matching when a feed is loaded:
• All Selected Input – auto matching is only invoked when all of a set’s message
feeds which have this setting configured, have received data. This option must only
be used for feeds receiving messages which generate a balance.
35
Maintaining Sets
• Always Propose – this setting must only be applied to statement messages, and
invokes auto matching when the final page of a message is received.
• Any Matching Input – auto matching is invoked provided that an ‘other side’
message of the same type has already been loaded. This option must only be used
for feeds which receive messages that generate a balance.
• Any Matching Input Regardless of Type – auto matching is invoked
provided that an ‘other side’ message of any type has already been loaded, and is
suitable for sets containing multiple types of data, for example cash and positions
items.
This option must only be used for feeds receiving messages that generate a
balance.
• Any Matching Input Since Last Proposal – auto matching is invoked
provided that a message of the same type has been loaded into the set since the last
auto proposal for the set.
• Never Propose - this setting can be applied to any message type and is
commonly used on ledger messages and used in conjunction with ‘Always
Propose’ on statements.
Important: if the message feed you are configuring is for message types such as cash
confirmations, cash requests or individual securities, the proposal triggering will always
occur regardless of the proposal triggering settings, unless ‘Never Propose’ is selected.
Load As Advisory Select whether the feed is to be loaded as advisory from the drop-down list.
Important: selecting this option overrides the feed proposal trigger setting.
Reason Free format text to input the reason for a message feed closure.
Balance Sheet Also defined as statement of financial position, it is categorised based on the major
Category components like Assets, Liabilities and Owner’s (stock holders) Equity.
Record Message Select Yes from the drop-down list if you want the system to record message balances
Balances while loading the feed.
Business Owner The person who is held accountable for the functioning of the Business.
Subledger PL Sub Ledger Profit Loss indicator where positive SL balance denotes profit.
BSLA Business Summary Level Acronym - a way of summarizing business data in each
country.
Business Code A unique code assigned to the particular Business to recognise it in the internal
communications and operations.
Estimated Low Balance Threshold to identify that the set balance should not go below the estimated balance
range.
Management Structure Management Structure reference for the message feed.
Estimated Credit Count Indicates the maximum expected credit balance. A set where the balance is out of this
range indicates that there might be some unexpected transactions in this set, and should
be highlighted to the business.
Estimated High Threshold to identify that the set balance should not go beyond the estimated balance
Balance range.
CDR Corporate Data Repository where accounting records is consolidated and maintained,
and which are used for Accounting, Reporting, Analyzing, Tax purposes.
Estimated Debit Count Indicates the maximum expected debit balance. A set where the balance is out of this
range indicates that there might be some unexpected transactions in this set, and should
be highlighted to the business.
Local Currency The currency in which business is operated in. For example, if a business is operated in
India, then INR would be the local currency.
Expected Colour Expected Color is whether balance in a set is expected to be debit or credit or any.
Opportunity Sets are reconciled by grouping into one template and while reporting each set need to
be reconciled with the number of rows in it. Hence the number of rows is equal to
number of reconciling opportunities.
Reporting Opportunity: Sets are reconciled by grouping opportunities into one template.
Reporting opportunities is the level at which business reports out its open items.
36
Maintaining Sets
Securities Value Select whether the system should check for securities value balances, from the drop-
Balances down list.
Validate Securities Select whether the system should validate the securities balances from the drop-down
Balances list.
Validate Securities Select whether the system should validate the securities sequence from the drop-down
Sequence list.
Validate Balances Select whether the system should validate balances while loading the feed, from the
drop-down list.
Validate Sequence Select whether the system should validate the feed sequence while loading, from the
drop-down list.
Value Balances Select whether the system check value balances while loading the feed, from the drop-
down list.
Value Date Select whether the system should validate the value date while loading the feed, from
Adjustments the drop-down list.
7. Click [Save].
The feed is created or updated.
37
Maintaining Sets
The application provides the possibility for creating/updating message feeds wherever it makes sense. This section
only describes the main access points for how to create/update message feeds.
1. Select Menu > Set Administration > Set > Sets / Ad Hoc Message Feeds or select Menu > Ad Hoc
Searches> Set Ad Hoc Search.
2. Enter your search criteria and click [Search].
Depending on what you have selected in the first step, the dashboard displayed varies.
38
Maintaining Sets
3. Continue with step 4 if the REC Admin Set Summary dashboard is displayed, or continue with step 5 if the
REC Admin Message Feed Ad Hoc dashboard is displayed.
4. In the REC Admin Set Summary dashboard, right-click the required set to select Set Details or double-click on
the set that you want to view.
1. In the Set Details dashboard, right-click to select Message Feed Create(MI) for creating a new MI
message feed or Message Feed Administration for creating and updating a MI message feed.
2. If you have selected Message Feed Administration, you must right-click a set in the resulting list to select
New Message Feeds(MI) or Update Message Feeds(MI).
5. In the REC Admin Message Feed Ad Hoc dashboard, right-click a set to select New Message
Feed(MI)/Update Message Feed(MI).
6. In the dashboard for creating or updating a MI message feed, populate the following fields with the required
data.
Field Description
Message Feed The message feed type.
Type
Message Feed ID Enter the message feed ID. This field can accept value up to 100 characters.
Feed Status Defines the active status of the Message Feed
Set Internal ID Enter the internal ID.
By default, the set name for which the feed is being created is displayed.
Short Code Mandatory. A three-character code. Within a set, each message feed record must have a unique
short code, although the same short code can be used by another set. Once saved, it cannot be
changed. The combination of Set ID and Short Code must be unique across all sets.
Description Enter a description for the feed. This field can accept value up to 60 characters.
Load As Advisory Select whether the feed is to be loaded as advisory from the drop-down list.
Important: selecting this option overrides the feed proposal trigger setting.
Item Overrides Select the checkbox if you want to prevent the default source
Default code overriding that on the items in the incoming message
feed.
Default Source Default Source Code for incoming data
Code
Source Set ID Set used for source aliases. Masks related to this set ID are used to enrich items with source
details during loading. They are not used for matching. The mask type involved is 'Source'. If
blank, it is assumed there is no lead set for source aliases.
Source Short Code Short code used to identify the message feed to use as the lead for source aliases.
Alias Set ID Set used for broker and financial product aliases (formerly instrument aliases).
Alias Short Code Short code used to identify the message feed to use as the lead for broker and financial product
aliases.
Mask Set ID Set used as a lead parameter to restrict the reference masks used during alias processing.
Mask Short Code Short code used to identify the message feed to restrict the reference masks used during alias
processing.
Reason Free text to input the reason for a message feed closure.
Item Ageing Switches the use of the item enrichment configuration, overrides any config if turned OFF.
Premium Balance Premium specific balance type for the Message Feed
Type • Currency
• Asset
• None
If set to none, all of the subsequent balance-related processing and validation will be ignored.
39
Maintaining Sets
Field Description
Check Duplicate Select whether the system should check for duplicate items while loading, from the drop-down
Item list.
Maintain Message A new option to control how balances are updated on load. The field controls the update of both
Bals Asset and Currency balances.
• Header Only - the closing balance on the currency/asset header is a running total of the net
of items rather than the latest messages closing balance.
• Header and Balances - apply the incoming Closing Balance to the appropriate
Currency/Asset Header and record the balance on the Currency/Asset Balance table
• None - do not store any balance information
Process Stop Allow stop cheque processing to be enabled/disabled.
Cheques
Proposal Select one of the following Proposal Triggering options from the drop-down menu to specify the
Triggering conditions for running auto matching when a feed is loaded:
• All Selected Input – auto matching is only invoked when all of a set’s message feeds
which have this setting configured, have received data. This option must only be used for
feeds receiving messages which generate a balance.
• Always Propose – this setting must only be applied to statement messages, and invokes
auto matching when the final page of a message is received.
• Any Matching Input – auto matching is invoked provided that an ‘other side’ message of
the same type has already been loaded. This option must only be used for feeds which
receive messages that generate a balance.
• Any Matching Input Regardless of Type – auto matching is invoked provided that an
‘other side’ message of any type has already been loaded, and is suitable for sets containing
multiple types of data, for example cash and positions items.
This option must only be used for feeds receiving messages that generate a balance.
• Any Matching Input Since Last Proposal – auto matching is invoked provided that a
message of the same type has been loaded into the set since the last auto proposal for the set.
• Never Propose - this setting can be applied to any message type and is commonly used on
ledger messages and used in conjunction with ‘Always Propose’ on statements.
Important: if the message feed you are configuring is for message types such as cash
confirmations, cash requests or individual securities, the proposal triggering will always occur
regardless of the proposal triggering settings, unless ‘Never Propose’ is selected.
Calc Mark to Performs the Mark to Market calculation for OTC cash items if ON.
Market
Target Message Target Message Feed used for item bulk copy.
Feed
Direct Alias Allow direct alias lookups to be enabled/disabled.
Lookup
Latest Stmt Click the calendar button to select the latest statement date.
Date
Last Input Click the calendar button to select the date when the feed was last input.
Latest Stmt No Automatically updated upon receipt of messages.
For Cash, it is the number of the last cash statement (MT940 or MT950) received.
For Securities, it is the current number of security positions statement for the safekeeping set.
Latest Message Automatically updated upon receipt of a message. This is a unique number across the system which
No is automatically generated and is not restricted to a particular message.
Latest Stmt Automatically updated upon receipt of messages.
Page For Cash, this is an actual statement page, but for Securities the statement page is internally
generated.
Last Proposal Date when an account was last proposed for auto matching due to data load using the given message
Time feed.
40
Maintaining Sets
Field Description
Page Balance Works for both Asset and Currency balances to check that Closing - Opening = net of Items (on the
message being loaded).
Balance Flow Allow the type of balance flow (the flow of Closing -> Opening balances) to be configured
Validation
Check Duplicate Check that the same stmt_date, no, page has not already been loaded
Page
Sequence – A gap is defined by the loading message not flowing on from the latest stmt_date, no, page
Reject if Page
Creates a Gap
Sequence – Rejects the message if it is not the latest message (by statement date, statement number, statement
Reject if Not page).
Latest Page
Asset Code Only lookup and set the stock_id if this is turned ON
Lookup
Value Dated Controls the creation of value-dated balances.
Balances
Load Unknowns New option to control the processing of asset codes. Currently the code is always looked up, and
if the code is not known, a system setting will dictate whether to create it as Known or Unknown.
This new option allows granular selection of the decision at the Set level.
• Create as Known
• Create as Unknown
• Reject
Create Txn From Option to create a transaction when loading position data for the difference between the previous
Position and current positions. Note that a Transactions Message Feed is required in the same Set with the
same name as the Position Message Feed for this to work. The options are:
• None - do not create a transaction
• Our Asset Transaction - Create a Ledger transaction
• Their Asset Transaction - Create a Statement transaction
Value Balances Select whether the system check value balances while loading the feed, from the drop-down list.
Value Date Select whether the system should validate the value date while loading the feed, from the drop-
Adjustments down list.
Balance Sheet Also defined as statement of financial position, it is categorised based on the major components
Category like Assets, Liabilities and Owner’s (stock holders) Equity.
Business Owner The person who is held accountable for the functioning of the Business.
BSLA Business Summary Level Acronym - a way of summarizing business data in each country.
Estimated Low Threshold to identify that the set balance should not go below the estimated balance range.
Balance
41
Maintaining Sets
Field Description
Estimated Credit Indicates the maximum expected credit balance. A set where the balance is out of this range
Count indicates that there might be some unexpected transactions in this set, and should be highlighted
to the business.
CDR Corporate Data Repository where accounting records is consolidated and maintained, and which
are used for Accounting, Reporting, Analyzing, Tax purposes.
Local Currency The currency in which business is operated in. For example, if a business is operated in India,
then INR would be the local currency.
Opportunity Sets are reconciled by grouping into one template and while reporting each set need to be
reconciled with the number of rows in it. Hence the number of rows is equal to number of
reconciling opportunities.
Reporting Opportunity: Sets are reconciled by grouping opportunities into one template.
Reporting opportunities is the level at which business reports out its open items.
Keep Only One Deletes a previous currency balance on load of most recent for a period.
Balance
Chart Of Accounts The Chart Of Account the Message Feed belongs to.
Subledger PL Sub Ledger Profit Loss indicator where positive SL balance denotes profit.
Business Code A unique code assigned to the particular Business to recognise it in the internal communications
and operations.
Management The Management Structure the message feed is part of.
Structure
Estimated High Threshold to identify that the set balance should not go beyond the estimated balance range.
Balance
Estimated Debit Indicates the maximum expected debit balance. A set where the balance is out of this range
Count indicates that there might be some unexpected transactions in this set, and should be highlighted
to the business.
Excepted Colour Whether the Message Feed is expected to be in Credit or Debit.
Functional Functional Currency that the Message Feed is calculated in.
Currency
Financial Calendar Enables the use of the fiscal calendar to age items on load.
Ageing
Revalue Reporting Calculate the reporting amount for items on load.
Amounts
Suspense Account Whether this account is a suspense account.
7. Click [Save].
The feed is created or updated.
42
Maintaining Sets
Where the field values for each of the selected sets are the same, the value is populated in the field, see Set ID, and
the estimated balances and counts in the above example.
Where the field values differ, the field is populated with the text (multiple values).
43
Maintaining Sets
1. Select Menu > Set Administration > Set > Sets / Ad Hoc Message Feeds or select Menu > Ad Hoc
Searches> Set Ad Hoc Search.
2. Enter your search criteria and click [Search].
Depending on what you have selected in the first step, the dashboard displayed varies.
3. Continue with step 4 if the REC Admin Set Summary dashboard is displayed, or continue with step 5 if the
REC Admin Set Detail Ad Hoc dashboard is displayed.
4. In the REC Admin Set Summary dashboard, right-click the required set to select Set Details or double-click on
the set that you want to view.
1. Right-click the set for which you want to edit the message feeds and select Message Feed Administration.
2. In the Message Feed Administration dashboard, select the message feeds that you want to edit using the
selectors on the left.
5. In the REC Admin Message Feed Ad Hoc window, select the message feeds that you want to edit using the
selectors on the left.
6. Right-click to select Update Message Feeds.
7. In the Bulk Edit window, edit the fields as required.
Any values changed or entered will apply to all the selected message feeds.
44
Maintaining Sets
The REC Admin Message Feed Ad Hoc dashboard provides the details of all available message feeds.
45
Maintaining Sets
The REC Admin Message Feed Ad Hoc dashboard you can delete message feeds of one or more sets.
1. Select Menu > Set Administration > Set > Sets / Ad Hoc Message Feeds or select Menu > Ad Hoc
Searches> Set Ad Hoc Search.
2. Enter your search criteria and click [Search].
Depending on what you have selected in the first step, the dashboard displayed varies.
3. Continue with step 4 if the REC Admin Set Summary dashboard is displayed, or continue with step 5 if the
REC Admin Message Feed Ad Hoc dashboard is displayed.
4. In the REC Admin Set Summary dashboard, right-click the required set to select Set Details or double-click on
the set that you want to view.
1. In the Set Details window, right-click a set to select Message Feed Administration.
2. Select the feeds that you want to delete or click the to delete all message feeds.
5. In the REC Admin Message Feed Ad Hoc dashboard, right-click a set to select the feeds that you want to delete
or click the select all button to delete all message feeds.
6. Click in the toolbar or right-click to select Delete Message Feed.
46
Maintaining Sets
47
Maintaining Sets
In the Message Feed Administration dashboard you can add interest rates to message feeds of a specific set you
have selected in the steps before.
In the REC Admin Message Feed Ad Hoc dashboard you can add interest rates to all message feeds of one set.
48
Maintaining Sets
3. Right-click the set for which you want to add an interest rate, and select Message Feed Administration.
The Message Feed Administration dashboard is displayed.
• Select Menu > Ad Hoc Searches> Set Ad Hoc Search.
• Enter your search criteria and click [Search].
The REC Admin Set Detail Ad Hoc window is displayed.
1. Select a message feed or a set to which you want to add an interest rate and do one of the following:
• If you want to add a new credit interest rate, right-click to select Create Credit Interest Rate.
• If you want to add a new debit interest rate, right-click to select Create Debit Interest Rate.
The selected dashboard is displayed.
2. Populate the From Date, Rate and Amount fields with the required information.
3. Click the [Create] button.
The interest rate is added to the message feed.
49
Maintaining Sets
50
Maintaining Sets
51
Maintaining Sets
52
Maintaining Sets
53
Maintaining Sets
1. Select Static Administration > Enrichments > Enrichments from the main menu.
A search prompt is displayed:
54
Maintaining Sets
55
Maintaining Sets
Amount From / To The amount range of outstanding items that is included in the items ageing priority
group.
56
Maintaining Sets
57
Maintaining Categories
Maintaining Categories
When defining your sets you can choose to group one or more sets by category, create a list of sets with no category,
or a mixture of both.
Categories drive the display of the treeviews in the Reconciliations-Premium dashboards. You can also add a
category to an initiation, rather than running an initiation at the set level.
You add a set to a category from the Set Details dashboard, or when you create or update a set.
58
Maintaining Categories
59
Maintaining Categories
Creating/Updating Categories
The dashboards for creating or updating categories contain exactly the same fields and options. Before you can
populate the dashboard fields, you must open the corresponding dashboard.
To Create/Update Categories
60
Maintaining Categories
Field Description
Type Type of category. Select from list:
• Custodian
• Broker
• Counterparty
• Correspondent
• Branch
Short Name Abbreviated name for category. Up to 20 characters.
Sort Code Category sort code. Up to eight characters.
Name Full name of category. Up to 60 characters.
Territory Code Code for the territory in which category is located. Up to eight characters.
Comms Mail box address. Up to 14 characters.
SWIFT Category’s SWIFT address. Up to 20 characters.
Address The address of category. Up to 40 characters on each line.
Town The town where category is located. Up to 40 characters.
Postcode Postcode for the category. Up to 10 characters.
State State or County where category is located. Up to 40 characters.
Telex The telex number of category. Up to 20 characters.
Country Country where category is located. Up to 40 characters.
Fax Fax number of category. Up to 20 characters.
Contact Contact details for category. Up to 60 characters.
Phone Telephone number of category. Up to 20 characters.
61
Maintaining Categories
Viewing Categories
You can view the details of categories in the Category Detail dashboard.
62
Maintaining Categories
Deleting a Category
You can delete categories in the Category Detail dashboard.
To Delete Categories
63
Maintaining Set Groups
When defining your sets you can choose to group one or more sets by set group. Set groups are used for controlling a
user’s access to a collection of sets.
When you have created a set group, you can then add users, sets and sources (business entities).
64
Maintaining Set Groups
• Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail window is displayed with all set groups defined in your system.
65
Maintaining Set Groups
1. If you want to create set groups, carry out step 2, if you want to create and/or update set groups, carry out step 3.
2. Select Menu > Set Administration > Set Groups > New Set Group.
The Rec Admin Group Create dashboard is displayed.
3. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
Right-click a set group to select New Group or Update Group.
The New Group or Update Group window is displayed.
4. Select a Group Type from the dropdown list.
This option is not available when updating the set group, because once the group type is set it cannot be
changed.
This option is not available when updating the set group, because once the group code is set it cannot be
changed.
66
Maintaining Set Groups
• Sets window
This window displays information such as Group Code, Set ID, Priority and Group Type on the set group
selected.
• Users window
This window displays information such as Group Code, Group User ID, Group User ID Long and Group Type
on the set group selected.
• Sources window
This window displays information such as Group Code, Source Code and Group Type on the set group
selected.
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed with all set groups available in your system and basic
information on each of these set groups.
2. Double-click or right-click a set group to select Group Details.
The Sets, Users and Sources window are displayed with the corresponding information on the selected set
group.
67
Maintaining Set Groups
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
2. Right-click the set group you want to add a set to and select Add Set.
3. In the Add Set window, select a Set ID from the dropdown list.
4. Optionally, indicate a Priority for the set.
5. Click [Add].
The set is added to the set group. Select the Set window to display it.
6. To add any additional sets right-click in the grid on the Sets window and select Add Set, then repeat steps 3 to
5.
68
Maintaining Set Groups
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
2. Double-click or right-click a set group to select Group Details.
The Sets, Users and Sources window are displayed.
3. Select the Sets window.
4. Do any of the following:
• To delete a single set, click to select the required set and click on the toolbar or right-click a set to
select Delete Set.
• To delete multiple sets, click for each set you want to remove and click on the toolbar or right-click
to select Delete Set.
• To delete all sets, click and click on the toolbar or right-click to select Delete Set.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK].
69
Maintaining Set Groups
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
2. Right-click the set group you want to add a user to and select Add User.
The Add User window is displayed.
3. Select a User ID from the dropdown list.
4. Click [Create].
The user is added to the set group. Select the Users window to display it.
5. To add any additional users right-click in the grid on the User window and select Add User, then repeat steps 3
to 5.
70
Maintaining Set Groups
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
2. Double-click or right-click a set group to select Group Details.
The Sets, Users and Sources window are displayed.
3. Select the Users window.
4. Do any of the following:
• To delete a single user, click to select the required user and click on the toolbar or right-click to
select Delete User.
• To delete multiple users, click for each user you want to select and click on the toolbar or right-click
to select Delete User.
• To delete all users, click and click on the toolbar or right-click to select Delete User.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK] to continue.
71
Maintaining Set Groups
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
2. Right-click the set group you want to add a user to and select Add Source.
The Add Source window is displayed.
5. To add any additional sources right-click in the grid on the Sources window and select Add Sources, then
repeat steps 3 to 5.
72
Maintaining Set Groups
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
2. Double-click or right-click a set group to select Group Details.
The Sets, Users and Sources window are displayed.
3. Select the Sources window.
4. Do any of the following:
• To delete a single source, click to select the required source and click on the toolbar or right-click to
select Delete Source.
• To delete multiple sources, click for each source you want to select and click on the toolbar or right-
click to select Delete Source.
• To delete all sources, click and click on the toolbar or right-click to select Delete Source.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK].
73
Maintaining Set Groups
1. Select Menu > Set Administration > Set Groups > Set Groups.
The REC Admin Group Detail dashboard is displayed.
2. Do any of the following:
• To delete a single set group, click to select the required set group and click on the toolbar or right-
click to select Delete Group.
• To delete multiple set groups, click for each set group you want to select and click on the toolbar or
right-click to select Delete Group.
• To delete all set groups, click and click on the toolbar or right-click to select Delete Group.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
3. Click [OK].
74
Maintaining Relationship Categories
Maintaining Relationship
Categories
A relationship category allows you to group similar relationship types together. This section describes how to create
and maintain relationship categories.
75
Maintaining Relationship Categories
76
Maintaining Relationship Categories
1. If you want to create relationship categories, carry out step 2, if you want to create and/or update relationship
categories, carry out step 3.
2. Select Menu > Static Administration > Relationship Types.
The REC Admin Relationship Type Summary is displayed.
• Right-click a node to select New Relationship Category.
The New Relationship Category dashboard is displayed.
3. Select Menu > Static Administration > Relationship Types.
The REC Admin Relationship Type Summary is displayed.
• Double-click or right-click a row to select New Relationship Category or Update Relationship Category.
The New Relationship Category or Update Relationship Category dashboard is displayed.
4. In the dashboard for create or update relationship category, complete the following fields. All the mandatory
fields are denoted by an asterisk.
Field Description
Name Enter a name for the new Relationship Category. This field can accept value up to 100
characters.
Lookup Enter the lookup value or click the more […] button and select a value. This field can accept
value up to 100 characters.
Description Enter an appropriate description.
77
Maintaining Relationship Categories
78
Maintaining Relationship Categories
79
Maintaining Relationship Types
A relationship type allows you to group items. Relationship types are grouped according to relationship categories.
This section describes how to create and maintain relationship types.
80
Maintaining Relationship Types
81
Maintaining Relationship Types
The application provides the possibility for creating/updating relationship types wherever it makes sense. This
section only describes the main access points for how to create/update relationship types.
1. If you want to create relationship types, carry out step 2, if you want to create and/or update relationship types,
carry out step 3.
2. Select Menu > Static Administration > Relationship Types.
The REC Admin Relationship Type Summary is displayed.
Right-click a node to select New Relationship Type.
The New Relationship Type dashboard is displayed.
3. Select Menu > Static Administration > Relationship Types.
The REC Admin Relationship Type Summary is displayed.
1. Double-click or right-click a row to select Relationship Type details.
2. In the Relationship Type Details window, right-click select New Relationship Type or Update
Relationship Type.
The New Relationship Type or Update Relationship Type dashboard is displayed.
4. Complete the following fields.
Field Description
Name Enter a name for the new relationship type. This field can accept value up to 100 characters.
Lookup Enter the lookup value or click the more […] button and select a value. This field can accept
value up to 100 characters.
Description Enter an appropriate description.
Category Name Click the more […] button and select a category name from the displayed list.
Category Lookup Enter the lookup value or click the more […] button and select a value.
By default, this field is populated according to the selected category name.
5. Click [Create].
82
Maintaining Relationship Types
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
6. Click [OK] to continue.
83
Maintaining Relationship Types
84
Maintaining Relationship Types
85
Maintaining Inboxes
Maintaining Inboxes
Inboxes are used to allocate and sub-divide work, and are associated with specific exception types and alerts.
The access rights to Inboxes are constrained by user roles to enable users to manage workloads efficiently. This also
ensures that the correct user or team works on them.
Inboxes can contain any number of exceptions or alerts, and you can move the Inbox contents from one Inbox to
another.
86
Maintaining Inboxes
87
Maintaining Inboxes
Creating/Updating Inboxes
The dashboards for creating or updating inboxes contain exactly the same fields and options.
When updating data, some of the fields are greyed out because they are not editable.
To Create/Update Inboxes
• Right-click an entry to select Update Inbox or New Inbox, or double-click a specific entry to update it.
The corresponding window is displayed.
5. Complete the following fields.
Field Description
Name Enter a name for the new Inbox. This field can accept a value up to 100 characters.
Lookup Enter the lookup value. This field can accept a value up to 100 characters.
Description Enter an appropriate description.
Contact Group Enter the name of the contact group you want to associate with this inbox or click the more […]
Name button, select a value and click [Select].
Contact Group Enter the lookup value for the required contact group or click the more […] button, select a
Lookup value and click [Select].
88
Maintaining Inboxes
89
Maintaining Inboxes
90
Maintaining Inboxes
Deleting an Inbox
You can delete specific inboxes in the Inbox Details dashboard.
You can delete one or more inboxes in the All Inboxes dashboard.
To Delete an Inbox
91
Maintaining Contact Groups
92
Maintaining Contact Groups
93
Maintaining Contact Groups
Right-click an entry to select Update Contact Group or New Contact Group, or double-click a specific entry to
update it.
The corresponding window is displayed.
5. Complete the following fields:
Field Description
Name Enter a name for the new contact group.
Lookup Enter the lookup value or click the more […] button and select a value.
Description Enter an appropriate description.
94
Maintaining Contact Groups
95
Maintaining Contact Groups
You cannot delete a contact group if there is an active contact associated with that group.
96
Maintaining Contacts
Maintaining Contacts
Contacts allow you to add users to the system to work on exceptions and alerts.
97
Maintaining Contacts
The application provides the possibility for creating contacts wherever it makes sense. This section only describes
the main access point for how to create contacts.
1. Select Menu > Static Administration > Contact Groups.
The REC Admin Contact Group Summary is displayed. The tree lists all active contact groups. Each contact
group displays all the associated contacts.
4. Click [Create].
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK] to continue.
The new contact is created.
98
Maintaining Contacts
99
Maintaining Contacts
100
Maintaining Contacts
Deleting a Contact
You can delete a contact in the All Contacts dashboard.
To Delete a Contact
• To delete multiple contacts, click for each contact you want to select and click or right-click to select
Delete Contact.
101
Maintaining Contacts
102
Maintaining Contacts
103
Maintaining Reason Categories
A reason category allows you to group similar reason types together. You can create reason categories to be attached
to exceptions.
104
Maintaining Reason Categories
105
Maintaining Reason Categories
Right-click an entry to select Update Reason Category or New Reason Category, or double-click a specific
entry to update it.
The corresponding window is displayed.
5. Complete the following fields. All the mandatory fields are denoted by an asterisk.
Field Description
Name Enter a name for the new Reason Category. This field can accept value up to 100 characters.
Lookup Enter the lookup value or click the more […] button and select a value. This field can accept
value up to 100 characters.
Description Enter an appropriate description.
6. Click [Create]/ [Update].The progress window shows the status of the changed data. In the progress window,
click [Show All Results] for additional information.
7. Click [OK] to continue.
106
Maintaining Reason Categories
107
Maintaining Reason Categories
108
Maintaining Reason Types
A reason type allows you to group items. Reason types are grouped according to reason categories.
A reason type code can be attached to an exception explaining the cause of the exception. The reason types available
are determined by the exception type, for example, the subset of reason types relevant to a Cash amount exception
differs to the relevant reason types relevant to a position break exception.
You can create reason types to be attached to exceptions.
109
Maintaining Reason Types
4. Click [Create].
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK] to continue.
The new reason type is created.
110
Maintaining Reason Types
111
Maintaining Reason Types
112
Maintaining Reason Types
113
Maintaining Reason Types
• To delete the link to a single exception type, click to select the required exception type and click or
right-click to select Delete Link.
• To delete the link to multiple exception types, click for each exception type you want to select and click
or right-click to select Delete Link.
• To delete the link to all exception types, click and then click or right-click to select Delete Link.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK] to continue.
The reason type is unlinked from the exception type.
114
Maintaining Reason Types
115
Maintaining Reason Types
• To delete the link to a single item type, click to select the required item type and click or right-click
to select Delete Link.
• To delete the link to multiple item types, click for each item type you want to select and click or
right-click to select Delete Link.
• To delete the link to all item types, click and then click or right-click to select Delete Link.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK] to continue.
The reason type is unlinked from the item type.
116
Maintaining Reason Types
117
Maintaining Reason Types
118
Maintaining Resolution Categories
Maintaining Resolution
Categories
Resolution categories allow you to group similar resolution types together. Resolution types are attached to an
investigation to indicate the course of action undertaken to close the exception.
119
Maintaining Resolution Categories
120
Maintaining Resolution Categories
121
Maintaining Resolution Categories
122
Maintaining Resolution Categories
123
Maintaining Resolution Types
A resolution type allows you to group items. You can group several resolution types according to resolution
categories. After the grouping, you can attach the resolution types to a resolution category.
Furthermore, you can attach resolution types to an investigation to indicate the course of action undertaken to close
the exception. The available resolution type codes depend on the selected reason type against the exception.
You can create the resolution types to be attached to the exception.
124
Maintaining Resolution Types
2. Right-click a node in the REC Admin Resolution Type Summary and select New Resolution Type.
The New Resolution Type dashboard is displayed.
3. Complete the following fields. All the mandatory fields are denoted by an asterisk.
Field Description
Name Enter a name for the new Resolution Type.
Lookup Enter the lookup value or click the more […] button and select a
value.
Description Enter an appropriate description.
Category Name Click the more […] button and select a category name from the
displayed list.
Category Lookup Enter the lookup value or click the more […] button and select a
value.
By default, this field is populated according to the selected category
name.
4. Click [Create].
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
125
Maintaining Resolution Types
126
Maintaining Resolution Types
127
Maintaining Resolution Types
1. Launch the Resolution Type Details dashboard. For details see page 127.
2. Do any of the following:
• Right-click a Resolution Type and select Update Resolution Type.
• Double-click a Resolution Type.
The Update Resolution Type dashboard is displayed.
The Update Resolution Type dashboard displays the REC Admin Resolution Type Update Form and the
Resolution Type - Reason Type Link section. Using the Resolution Type - Reason Type Link section, you can
create or delete a link between the Resolution Type and the Reason Type.
3. In the REC Admin Resolution Type Update Form, edit the required information.
Field Description
Name The name of the Resolution Type.
Lookup The lookup value.
Description The description for the Resolution Type.
Category Name The category to which the Resolution Type belongs.
128
Maintaining Resolution Types
129
Maintaining Resolution Types
1. Launch the Update Resolution Type dashboard. For details see page 128.
The Update Resolution Type dashboard is displayed.
2. In the Resolution Type - Reason Type Link window, enter the required information. All the mandatory fields
are denoted by an asterisk.
Field Description
Reason Type Name Click the more […] button and select the Reason Type name from the list.
Reason Type Lookup Click the more […] button and select the Reason Type lookup value from the list.
By default, this field is populated according to the selected Reason Type name.
130
Maintaining Resolution Types
1. Launch the Update Resolution Type dashboard. For details see page 128.
The Update Resolution Type dashboard is displayed
131
Maintaining Resolution Types
1. Launch the Resolution Type Details dashboard. For details see page 127.
2. Do any of the following:
• To delete a single Resolution Type, click to select the required Resolution Type and click the Delete
Resolution Type button , or right-click and select Delete Resolution Type.
• To delete multiple Resolution Types, click for each Resolution Type you want to select and click the
Delete Resolution Type button , or right-click and select Delete Resolution Type.
• To delete all Resolution Types, click and click the Delete Resolution Type button, or right-click and
select Delete Resolution Type.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
3. Click [OK] to continue.
The Resolution Type is deleted.
132
Maintaining Default Notes
While an exception is being investigated, narrative details can be attached to it in the form of notes. Notes assist in
explaining the course/stage of the investigation and record any specific details related to the next actions.
You can create predefined notes, which can then be attached to an exception during an investigation.
133
Maintaining Default Notes
2. Right-click a node in the REC Admin Note Summary and select New Note Category.
The New Note Category dashboard is displayed.
3. Complete the following fields. All the mandatory fields are denoted by an asterisk.
Field Description
Name Enter a name for the new note category. This field can accept value up to 100 characters.
Lookup Enter the lookup value. This field can accept value up to 100 characters.
4. Click [Create].
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK] to continue.
The new Note Category is created.
134
Maintaining Default Notes
2. Right-click a Note Category in the REC Admin Note Summary and select Note Category Details.
The Note Category Details dashboard is displayed.
135
Maintaining Default Notes
1. Launch the Note Category Details dashboard. For details see page 135.
2. Do any of the following:
• Right-click a row and select Update Note Category.
• Double-click a row.
The Update Note Category dashboard is displayed.
136
Maintaining Default Notes
1. Launch the Note Category Details dashboard. For details see page 135.
2. Do any of the following:
• Click to select the required Note Category and click the Delete Note Category button .
• Right-click and select Delete Note Category.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
3. Click [OK] to continue.
The note category is deleted.
137
Maintaining Default Notes
3. Complete the following fields. All the mandatory fields are denoted by an asterisk.
Field Description
Note Name Enter a name for the new note definition. This field can accept value up to
100 characters.
Note Lookup Enter a name for the new note. This field can accept value up to 100
characters.
Note Definition Enter the note.
4. Click [Create].
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
5. Click [OK] to continue.
The new note is created in the selected Note Category.
138
Maintaining Default Notes
139
Maintaining Default Notes
1. Launch the Note Definition Details dashboard. For details see page 139.
2. Do any of the following:
• Right-click a row and select Update Note Definition.
• Double-click a row.
The Update Note Definition dashboard is displayed.
The Update Note Definition dashboard displays the REC Admin Note Update Form and the Note Category
Link section. The Note Category Link section allows you to create or delete a link between the note definition
and note category definition.
3. In the REC Admin Note Update Form, edit the required information.
Field Description
Note Name The name of the new note definition
Note Lookup The name for the new note
Note Definition The note details
140
Maintaining Default Notes
2. In the Note Category Link group, enter the required information. All the mandatory fields are denoted by an
asterisk.
Field Description
Note Category Name Click the more […] button and select the note category definition name from the list.
Note Category Click the more […] button and select the note definition from the list.
Lookup By default, this field is populated according to the selected note category definition
name.
141
Maintaining Default Notes
1. Launch the Update Note Definition dashboard. For details see page 139.
The Update Note Definition dashboard is displayed.
2. In the Note Category column, which displays the linked Note Categories, do any of the following:
• To delete the link to a single Note Category, click to select the required Note Category and click the
Delete Link button , or right-click and select Delete Link.
• To delete the link to multiple Note Categories, click for each Note Category you want to select and click
the Delete Link button , or right-click and select Delete Link.
• To delete the link to all Note Categories, click and click the Delete Link button , or right-click and
select Delete Link.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
3. Click [OK] to continue.
The note is unlinked from the selected category.
142
Maintaining Default Notes
To Delete a Note
1. Launch the Note Definition Details dashboard. For details see page 135.
2. Do any of the following:
• To delete a single Note Definition, click to select the required Note Definition and click the Delete Note
Definition button , or right-click and select Delete Note Definition.
• To delete multiple Note Definitions, click for each Note Definition you want to select and click the
Delete Note Definition button , or right-click and select Delete Note Definition.
• To delete all Note Definitions, click and click the Delete Note Definition button , or right-click and
select Delete Note Definition.
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
3. Click [OK] to continue.
The note is deleted.
143
Maintaining Products and Aliases
Financial products are examples of reference data that is used by TLM Reconciliations-Premium to help identify
matching items within a group of items that are otherwise identical. The matching process cannot differentiate
between pairs of items if they have the same dates/amounts/references unless the financial product is identified as
well.
Financial products are a data enrichment feature of TLM Reconciliations that allow you to relate a code on an
incoming item with something more meaningful to your organisation such as the method of financial transaction, for
example shares, bonds, or units.
Financial products are nebulous by nature to allow you total flexibility when you configure them. It is up to you to
define your own financial products in your own 'house style’. The product is simply a device which can be used to
relate an apparently meaningless code on an item back to something in which you have an interest. For example, to
allow reports to be written for management information purposes.
The products in the system are displayed on the REC Admin Product Summary dashboard. For example:
Product aliases
A financial product alias is an alternative code that can be configured within TLM Reconciliations and is used to
identify the financial product to which it relates.
After loading messages, TLM Reconciliations-Premium examines the reference information held for each item,
looking for known aliases. If an alias is found, the item is marked with a corresponding internal ID. When items are
proposed for reconciliation, TLM Reconciliations-Premium uses the assigned internal ID to identify matching items
if the appropriate matching rules have been created by the user.
144
Maintaining Products and Aliases
145
Maintaining Products and Aliases
146
Maintaining Products and Aliases
147
Maintaining Products and Aliases
Updating a Product
You can update product details from the Update Product dashboard.
To Update a Product
148
Maintaining Products and Aliases
2. In the Product – Item Link group, enter the required information. All the mandatory fields are denoted by an
asterisk.
Field Description
Item Type Select an Item Type from the drop-down list.
Category Click the more […] button and select the required category code
from the list.
149
Maintaining Products and Aliases
150
Maintaining Products and Aliases
2. Right-click on the product for which you want to create an alias in the Summary dashboard and select New
Product Alias.
The New Product Alias dashboard is displayed.
3. Enter the required Alias, and optionally a Set ID, Short Code, and Priority.
4. Click [Create].
The new alias is associated with the product.
151
Maintaining Products and Aliases
2. Right-click the product whose alias details you want to view and select Product Alias Details.
The Product Alias Details dashboard is displayed.
152
Maintaining Products and Aliases
153
Maintaining Products and Aliases
Deleting a Product
This option allows you to delete a Product.
To Delete a Product
154
Maintaining Business Entities
To identify a customer who is responsible for a given item, our side data fed into the system must include a source
code in the reference fields. If liability for charges should arise, the correct customer can be addressed for
compensation.
You can update source codes from the REC Admin Source Summary tree, which is accessed via the main menu bar.
The sources (business entities) on this dashboard are ordered by source name. For example:
Each source or business entity belongs to a department. The source code is displayed in our side item references.
You can identify the customer responsible for any charges incurred using the Source-Department-Customer
relationships.
Source aliases
When you create a new source (business entity), TLM Reconciliations-Premium automatically creates a source alias
with the same code as the source it is aliasing. You can add further source aliases to allow for the different ways the
source might be presented in incoming messages. When a message arrives, TLM Reconciliations looks for any
source aliases that have been configured. If it finds a match on one of the alias codes, the system decodes the alias to
the parent source code.
155
Maintaining Business Entities
156
Maintaining Business Entities
2. Right-click the Source whose details you want to view and select Source Details.
The Source Details dashboard is displayed.
157
Maintaining Business Entities
Updating a Source
You can change source details, however you cannot change the source code itself. You can update the Source name
from the Update Source dashboard.
To Update a Source
158
Maintaining Business Entities
2. Right-click on the Source for which you want to create an alias in the Summary dashboard and select New
Source Alias.
The New Source Alias dashboard is displayed.
3. Enter the required Alias, and optionally a Set ID, Short Code, and Priority.
4. Click [Create].
The new alias is associated with the Source.
159
Maintaining Business Entities
2. Right-click the Source whose alias details you want to view and select Source Alias Details.
The Source Alias Details dashboard is displayed.
160
Maintaining Business Entities
161
Maintaining Business Entities
Deleting a Source
You cannot delete a source that has a source alias. You must delete source aliases before deleting the associated
source.
To Delete a Source
162
Maintaining Currencies
Maintaining Currencies
Each Cash set in TLM Reconciliations-Premium must operate under a specific currency. Securities sets can either be
currency-specific or unspecified (multi-currency). You do not need to specify a currency when you create generic
sets.
You can set up the following:
• Currency codes - the codes by which currencies are known in TLM Reconciliations
• Rates for the currencies against a base currency - to permit global reporting in the base currency
• A redenomination currency and rate
Currency codes
When you save a new currency to the database, the system creates a Currency Rate record effective from today
and with a default Rate of 1.00000
If you are likely to use Cash Sets where data can come in for more than currency with the same account number, a
different Set must be created for each currency, however you cannot re-use the incoming set name more than once
for the same side (Ledger/Statement) and message type. This way, multiple message-feeds can be set up, each one
with a different currency (appropriate to the parent set) appended to the name. GEMS’s look-up logic then
determines which to use.
For example, you could set up a set called ACC1 and subaccounts of ACC1SUBGPB, ACC1SUBEUR,
ACC1SUBJPY, then process data that has a swift tag in it point at subaccount ACC1SUB. If the incoming account
name is not found as a 'sub_acc_no' (for the correct side and message type), GEMS looks at message-feed aliases
and then terminal-IDs to try and find a link with a known message-feed. If all that fails, GEMS appends the message
currency (if there is one) onto the account name, and looks that up as a message_feed.sub_acc_no.
Currency rates
For every currency held in the database you need to set a rate that is used to convert amounts in that currency to the
system base currency.
Currency rates are only used for consolidating sets into a base currency for reporting purposes. One currency is set as
the base currency with rate set to 1.00000.
163
Maintaining Currencies
The base currency is defined as part of the system configuration when the system is first set up.
The rate for each currency is set with an effective date. Multiple rates can be set for each currency, each effective
until superseded by another rate with a later starting date. As a result, currency rate changes can be anticipated by
setting rates with effective dates in the future.
When you save a new currency to the database, TLM Reconciliations-Premium creates a Currency Rate record
effective from today and with a default Rate of 1.00000.
Redenomination
Redenomination allows items in one currency to be loaded into sets in another currency. For example, sets with the
Euro currency allow entry of amounts in the former National Currency Unit.
The TLM Reconciliations system enables you to redenominate any currency with another. However, for the
purposes of this guide only euro redenominations are considered in any detail.
Normally, items have the same currency as the message feeds that they are fed into. Setting up a redenomination
code and rate enables items in redenominated currencies, for example TRL, to load to EUR sets, and vice versa. Both
the original and the redenominated currencies and amounts are stored. The exact rules that the system applies when
accepting items are determined by the message feed configuration.
Redenomination rates are also used when converting amounts during a cash transaction enquiry, or when manually
inputting cash transactions.
164
Maintaining Currencies
165
Maintaining Currencies
Adding a Currency
To Add a New Currency
The redenomination currency must already exist in the database as a currency before it can be used as a
redenomination currency.
166
Maintaining Currencies
Updating a Currency
To Update a Currency
2. Right-click on the currency that you want to update and select Currency Update.
The Currency Update window is displayed. For example:
167
Maintaining Currencies
2. Right-click on the currency that you want to view the currency rates for and select Currency Rates.
The Currency Rates dashboard is displayed. For example:
168
Maintaining Currencies
1. From either the relevant currency row on the Rec Admin Curr Detail dashboard or anywhere on the Currency
Rates dashboard for the relevant currency, right-click select New Currency Rate.
The New Currency Rate window is displayed. For example:
2. Enter the date from which the currency rate will be effective.
3. Enter the rate.
4. Click [Create].
The currency rate is created.
169
Maintaining Currencies
170
Maintaining Currencies
Deleting a Currency
To Delete a Currency
• To delete a single currency, click to select the required currency and click the Delete button , or right-
click and select Delete.
• To delete multiple currencies, click for each currency you want to select and click the Delete button ,
or right-click and select Delete.
• To delete all currencies, click and click the Delete button , or right-click and select Delete.
The progress window shows the changed data. In the progress window, click [Show All Results] for additional
information.
3. Click [OK] to continue.
The currency is deleted.
171
Maintaining Exception Types
Exception Type dashboard allows you to add/update exception types which can then be used when creating manual
exceptions or soft configure them when creating auto exceptions.
172
Maintaining Exception Types
173
Maintaining Exception Types
174
Maintaining Exception Types
175
Maintaining Exception Types
176
Maintaining Exception Types
177
Maintaining Exception Types
178
Maintaining Alert Types
Alert Type dashboard allows you to add/update the new Alert Types to the system.
179
Maintaining Alert Types
180
Maintaining Alert Types
181
Maintaining Alert Types
182
Maintaining Assets
Maintaining Assets
The following options are available on the Static Administration menu to enable admin users to configure assets.
183
Maintaining Assets
For details on the window fields see Creating/Updating Assets, page 185
184
Maintaining Assets
Creating/Updating Assets
The dashboards for creating or updating assets contain exactly the same fields and options. They allow you to define the
required asset details.
To Create/Update an Asset
3. In the resulting list, right-click on a node in the tree to select New Asset/Update Asset.
You can also access the Update Asset via Asset Details dashboard in the following manner:
1. Double-click a node or select Asset Details.
The Asset Details dashboard is displayed.
2. Right-click a row on Asset Details dashboard and select Update Asset.
4. Complete the following fields. All the mandatory fields are denoted by an asterisk.
Field Description
Asset Code This is the asset code for the item on the message feed. If the asset is known and is not an
alias, the code is the same as the master asset code. If the asset displayed is a known alias,
the code differs from the master asset.
Asset Description The description of the asset
Asset Type The type of Asset
185
Maintaining Assets
Field Description
Territory Code Code for the territory in which category is located. Up to eight characters.
Preferred Code The preferred code for display.
5. Click [Create].
The progress window shows the status of the changed data. In the progress window, click [Show All Results] for
additional information.
6. Click [OK] to continue.
186
Maintaining Assets
187
Maintaining Assets
Deleting an Asset
To Delete an Asset
188
Maintaining Assets
5. Click Create.
A new Asset Alias is created.
189
Maintaining Assets
190
Maintaining Assets
191
Maintaining Assets
192
Maintaining Assets
193
Maintaining Assets
Unknown Assets
A known security or security alias is one which has been set up manually using the Assets option on the Admin tree
or using a stock loading program such as the STOCKS server.
Although a given master security code (stored on the STCK table) and its associated aliases (stored on the STOL
table) have different security/stock codes, they all have the same STOCK_ID which is an internally allocated
positive number.
If a message arrives bearing a stock code which the system cannot find on the STOL table, the security is considered
to be unknown and is stored on STOL with an internally allocated negative STOCK_ID.
Unknown securities can result in low match rates, so it is important to make them known as soon as possible.
194
Maintaining Assets
1. Select Menu > Static Administration > Assets > Unknown Assets.
A search prompt is displayed.
2. Select some applicable options and enter some relevant data to help narrow down your search and click
[Search].
The REC Admin Asset Alias Unknown Details window is displayed with all available assets alias unknown
details.
The following table describes the search fields available in the REC Admin Asset Alias Unknown Details
window:
Field Description
Code The asset code
Code Type The code type.
Territory Code The territory code.
Type The asset type.
Asset Code The asset code.
Asset Description The asset description.
Creation Date The asset created date
195
Maintaining Assets
1. In the Rec Admin Asset Alias Unknown Detail dashboard use the selectors on the left to select the items to be
edited.
2. Right-click and select ADM WC Asset Alias U.
The Edit dashboard is displayed.
196
Configuring Exception Messaging
Configuring Exception
Messaging
TLM Reconciliations-Premium provides exception messaging capabilities that allow the system to process inbound
and outbound messages, to assist with the exceptions investigation process.
The system currently supports incoming MT999, MT996 and MT995swift messages, as well as outbound MT999
and MT995 messages.
To configure the messaging process, you must use the administrative dashboards supplied to create the message
types and templates for outbound messages and the regular expressions required to match incoming messages to
existing exceptions.
197
Configuring Exception Messaging
The options on this dashboard’s context menu enable you to add and view message types.
Each message type that you create must have a unique name, lookup and template. You can then customise the
message type as required, for example by specifying whether the message is editable by the user, and whether it
requires second user authorization before it is sent.
You can also configure a series of next message settings for your message type, to enable you to keep track of when
messages are sent, and automatically schedule follow up messages.
The following settings are available to enable you to do this:
• Delay Offset (hrs) – this setting applies to automatically generated messages of this type, and allows you to
specify a delay in hours (after an exception is raised) before the message is sent.
• Next Message Type – this setting enables you to select a follow up message type to be sent automatically after
the original message. When the original message is sent, the follow up message type is automatically updated on
the Exception Detail dashboard. The Next Message Date is also set to the current date plus any Delay Offset that
you have specified for the follow up message.
The system checks for exceptions with a next message date in the past. If any such messages are found, they are
automatically sent, and the associated exception’s next message type and date fields are updated with the
parameters from the follow up message. This enables chains of automated messages to be created.
To stop a chain, set the Next Review Date on the exception to a date in the past, or clear the next message type
field.
• Next Review Offset (hrs) – this field is automatically updated on the exception details dashboard with the
current date time plus any configured next review offset. This assists the user in managing exceptions, and can
manually be modified from the Exception Detail dashboard.
You use the Template field of the New Message Type dashboard to create the body of the message.
198
Configuring Exception Messaging
When creating a template for a swift message, you need to define the field structure and any standard text used in the
free format fields. For email messages, you must define the contents of the email body.
You can also add special tags to your template to allow the dynamic population of exception related fields into the
outbound message at runtime. The special tags that you add to the template text are replaced at runtime with the
process context values.
The special tags can be added for exception header details, exception summary details, the linked business entity, set
and the underlying items.
The tags use the following construction:
• $process.<variable name> - to insert a variable
• $process.<entityname>.<columnname> - to insert table column references.
For example, if you wanted an outbound message to include the exception’s ID, category ID and Owner, you would
add the following combination of text and special tags to the template field:
When a user creates an outbound message and selects the message type you created with this template, the message
field, as well as the other fields you configured for that message type, is automatically populated with the data
extracted from the exception. For example:
199
Configuring Exception Messaging
Refer to Appendix I for the full list of special tags/variables that can be used in templates.
200
Configuring Exception Messaging
1. Right-click on either the Email or Swift node in the Message Type tree and select New Message Type from the
context menu.
The New Message Type dashboard is displayed.
2. Populate the message type fields as required, ensuring you have entered data into the mandatory Message Type,
Lookup and Template fields.
3. Click [Save].
The Message Type is displayed on the REC Admin Message Type Summary tree.
201
Configuring Exception Messaging
Field Description
*Message Type Enter a name for the message type.
*Lookup Enter the Lookup ID for the message type.
Description Enter a description for the message type.
Delivery Type Select one of the delivery types for the message from the drop-down list of those available:
• SWIFT – select to send a swift message
• Email – select to send an email
• Proprietary – select this to enable a third party system to send the message.
Swift Type Where required, select the type of swift message you want to use.
Sender Type Select one of the following sender types:
• Business Unit – sends the message to the Email ID or BIC code from the Business Unit
linked to the exception.
• System – sends the message to a system wide sender.
Recipient Type Select one of the following options for the intended recipient of this message type:
• Correspondent – the recipient is the address defined on the exception’s set. Valid for
email and swift message types.
• Inbox – the recipient is the address on the inbox that is linked to the exception. Valid
for email message types only.
• Business Entity – the recipient is the address on the exception’s business entity. Valid
for email message types only.
• Third party –select this option if you want users to manually select a recipient. Valid
for email and swift message types.
Editable Selected Yes or No to determine whether the user can edit messages of this type before they are
sent.
Delay Offset (hrs) Enter the offset in hours before the next message is sent.
Next Message Type Select the type of the next message to be sent.
Next Review Offset Select the offset in hours that this message is to be reviewed.
(hrs)
Requires Select Yes or No from the drop-down to specify whether messages of this type require second
Authorisation user authorization.
*Template Use this field to specify the details of the message template.
202
Configuring Exception Messaging
1. In the Message Type Detail dashboard, right-click on the message type that you want to update, and select
Message Type Update from the context menu.
2. The Message Type Update dashboard is launched, and is populated with the current message type details. For
example:
203
Configuring Exception Messaging
1. From the REC Admin Message Type Summary dashboard, right-click on the level in the tree from which you
want to delete message types, and select Message Type Detail from the context menu.
The Message Type Detail dashboard is displayed.
204
Configuring Exception Messaging
You can use this dashboard to add, edit and delete regular expressions.
205
Configuring Exception Messaging
This search for the literal “Exception ID:” followed by any number of numeric characters, and then extracts those
numeric characters from the string. In this example, “5416578” is extracted from the message. This exception ID is
then used to perform the lookup to attach the message to the associated exception.
1. Right-click on the category to which you want to add the regular expression and select New Regular
Expression. (You can also access this dashboard from the main menu by selecting Static Administration >
Regular Expressions.)
The New Regular Expression dashboard is displayed:
206
Configuring Exception Messaging
3. Click [Create].
The regular expression is created and displayed on the REC Admin Reg Ex Summary tree.
207
Configuring Exception Messaging
1. In the REC Admin Reg Ex Summary dashboard, double-click on the regular expression that you want to
update, or right-click and select Regular Expression Detail from the context menu.
The Regular Expression Detail dashboard is launched, and displays the selected regular expression.
2. Double-click on the regular expression or right-click and select Update Regular Expression.
The regular expression is launched in the Update Regular Expression dashboard.
208
Configuring Exception Messaging
1. In the REC Admin Reg Ex Summary dashboard, double-click on the regular expression or category of regular
expressions that you want to delete, or right-click and select Regular Expression Detail from the context menu.
The Regular Expression Detail dashboard is launched, and displays the selected regular expressions.
209
Data Loading
Data Loading
The data loading options allow you to work with the data files and messages that have been loaded into the system.
You can also input message manually.
210
Data Loading
You can drill down from any of the data files listed in this grid to view the messages that were written from the file.
2. If you want to view specific records, enter the required search criteria in the fields provided.
To view all the data files that have been loaded, leave the search fields blank.
3. Click [Search].
The Rec Data Load Ad-Hoc dashboard is launched and displays the records returned from the search.
1. Right-click on the required data files entry in the grid and select Messages.
The REC Message Ad-Hoc search prompt is displayed.
211
Data Loading
2. Click [Search].
Any messages that were written from the selected data file are displayed in the Messages dashboard.
212
Data Loading
Viewing Messages
You can view the messages that have been loaded into the system using either the REC Message Ad-Hoc or REC
Message Summary dashboard. The REC Message Summary dashboard also displays any errors associated with the
loaded messages.
213
Data Loading
You can drill down from any error in the Message Status Summary, to view detailed information about the message
involved in the error.
1. From the main menu, select Data Loading > Message Summary.
The REC Message Summary search prompt is displayed.
214
Data Loading
2. If required, enter search criteria in the fields provided to specify the types of error that you want to view.
Alternatively, leave the search fields blank to return all errors.
3. Click [Search].
The REC Message Summary dashboard is launched and displays the records returned from the search.
215
Data Loading
1. Right-click on the required error in the Message Status Summary and select Message.
2. The Messages dashboard is launched, displaying in-depth information about the individual messages involved
in the error. For example:
216
Data Loading
1. From the main menu, select Data Loading > Ad-Hoc Message Search.
The REC Message Ad-Hoc search prompt is displayed.
2. If required, enter search criteria in the fields provided to specify the types of messages that you want to view.
Alternatively, leave the search fields blank to return all error messages.
3. Click [Search].
The Rec Message Ad-Hoc dashboard is launched, listing the records returned from the search.
217
Data Loading
To Authorise/Reject a Message
1. From the main menu, select Data Loading > Ad- Hoc Message Search.
The REC Message Ad-Hoc search prompt is displayed.
2. If required, enter search criteria in the fields provided to specify the types of messages that you want to view.
Alternatively, leave the search fields blank to return all error messages.
3. Click [Search].
The Message Ad-Hoc dashboard is launched, listing the records returned from the search.
218
Data Loading
For messages with a status of Loaded, you can drill down to the Loaded Message Items dashboard, from which
you can access business logic tools such as Recall and Delete Item, to assist with deleting messages. For details on
Deleting messages, see page 221.
• From either the Message Items or REC Message Ad Hoc dashboard, right-click on the required message and
select Message Items. For messages with a status of loaded, right-click and select Loaded Message Items.
If the drill down is not available in the context menu, there are no items on the message.
219
Data Loading
Reloading Messages
If you are experiencing problems with a message and want to reload it, you can do so directly using the Load to
GEMS tool. Where required, you can also amend the message prior to reloading, using the Generic Message
Maintenance Input (GMMI) dashboard.
Any amendments that you make to a message might require second user authorization, depending on the SYST
settings.
You can reload any message by drilling down from either the REC Message Ad Hoc or Message Detail dashboards.
220
Data Loading
Deleting Messages
You can use the Delete tool on either the Message Details or REC Message Ad Hoc dashboard, to remove or back
out problematic messages from the system. When messages are deleted from the system, TLM Reconciliations-
Premium automatically adjusts the balance data.
Only messages with a status of Loading or Operator Intervention can be deleted. Before messages can be deleted you
must first:
• Recall the items on the message from any matches
• Delete the items
• Remove the items from any exceptions.
To Delete a Message
If the Loaded Message Items option is not displayed in the context menu, then there are no items on the
message and you can proceed to step 4 of these instructions.
3. Select the first item in the Loaded Message dashboard and do the following:
1. If the Recall tool is enabled on the business logic toolbar then the exception is involved in a match and
you must apply this tool to recall the item.
2. If the Remove Item from Exception tool is enabled on the business logic toolbar then the item is attached
to an exception, and you must apply this tool to remove the item from the exception.
3. Apply the Delete Item tool to the item.
4. If there are more items listed on this dashboard, select the next item and repeat steps 3.1 to 3.4 to delete
each additional item.
4. In either the REC Message Ad Hoc or Message Detail dashboard, select the message that you want to delete and
apply the Delete tool on the business logic toolbar. Alternatively, right-click on the required message and
select Delete.
The message is deleted or ‘backed out’ from the system.
221
Data Loading
Reinstating Messages
If you delete messages in error, you can reverse the process using the Undelete tool on either the Message Detail or
REC Message Ad Hoc dashboard. This changes the message status from Deleted to Operator Intervention.
To Undelete a Message
• Select the message that you want to undelete and click the undelete button on the business logic toolbar, or
right-click and select Undelete.
The message is re-instated and the load status is changed from Deleted to Operator Intervention.
222
Data Loading
223
Data Loading
Inputting a Message
When inputting a message using the GMI dashboard, you must first select the message category and message type
that you want to input. This determines the attributes for input that are to be written to the MESSAGE_HEADER.
You can then add one or more Item records, by item type.
If you need to delete any item rows, you can click the delete button. If they are displayed, the counts and balances
are updated to reflect the new totals.
The items that you input are loaded to the database ready to be checked, and then loaded into the database for further
processing.
If the load fails, the data remains in the window, and the cause of any errors is identified. Otherwise a confirmation
message is displayed, telling you that your data has been submitted. If validation finds any errors, the message is
submitted for Message Maintenance.
To Input a Message
1. From the menu select Data Loading > Manual Message Input.
The Generic Message Input dashboard is launched.
The Generic Message Input dashboard opens to fit the size of your browser window. However, if you resize
the browser window the Generic Message Input dashboard does not resize. For the Generic Message Input
dashboard to fit the resized browser, you must close the window and reopen it.
2. In the Message Type Selection area, select the required Message Category from the drop-down list.
3. Select the type of message that you want to input from the Message Type drop-down list.
The message header fields relevant to the message type that you have selected are displayed.
4. Enter the required message header data. Input as many of the header attributes as possible. Some attributes are
mandatory; these attributes are denoted by an asterisk (*) after the attribute name. For REC message types the
typical mandatory attributes are:
• Set ID
• Feed ID
• Statement Date
• Currency
The Items area displays the item types available for the selected Message Type. For example, for Cash Message
Category, you can input a credit, and a debit message:
224
Data Loading
5. Enter the data required in the row for each item type.
Input as many of the item attributes as possible. Some attributes are mandatory; these attributes are denoted by
an asterisk (*) in the input field.
When you start entering data, a new empty row is displayed beneath the row you are completing. This enables
you to input data for additional messages. If you do not want to add additional messages, you do not need to
delete the empty row.
For many message types, a number of running totals are displayed at the bottom of the screen as you input the
data. For example:
6. Repeat step 5 for any additional messages of the selected message type that you want to input.
225
Data Loading
If you need to delete any item rows, you can click the delete button .
7. To load the data that you have inputted, do one of the following:
• If you want to continue to input messages of a different type, click [Load and Continue].
A confirmation message is displayed, telling you that your data has been submitted to GEMS. Click [Close]
and repeat this whole procedure for the next message type that you want to input data for.
• If you have finished inputting messages, click [Load and Close].
A confirmation message is displayed, telling you that your data has been submitted to GEMS, and the
Generic Message Input window closes.
226
Running Initiations
Running Initiations
Initiations are an important part of the matching process and are defined at the Set level.
You can run initiations from the Initiation Submission dashboard, accessed via the System Administration menu,
which contains a number of fields that you can use to specify and configure the required initiation. For example:
The ability to run initiations is useful in several situations, for example, when auto matching is disabled, or when you
want to resubmit a set.
To run an initiation
227
Running Initiations
2. Click the More button […] next to the Initiation Name field, select the initiation that you want to run from the
list of those available, and click [Select].
The Initiation ID and Initiation Pass List ID fields are automatically populated.
3. Optionally enter a description of the initiation.
4. Do the following to identify the sets to add to the queue:
• For a single set, specify the Set ID by clicking the More button […] next to the Set Id field, selecting from
those available, and clicking [Select].
• For a group of sets specify the Group Code to propose all sets in that group, or a Category code to propose
all sets in that category, by clicking the More button […] next to the respective field, selecting from those
available and clicking [Select].
You must specify a value in at least one of Set ID, Group code or Category code.
5. Enter a priority between 1 and 99.
This determines the order in which sets are processed by the Workflow server. The lower the number, the higher
the priority.
6. Click [Submit].
The initiation is run.
228
Invoking TLM Control Workflow from Matching Service
In order to invoke TLM Control from Matching Service, you have to register the Control process to ensure that it is
available within Matching Studio. This is done via the workflow tool manager that is provided with Matching
Service.
Karaf command workflowtool-manager can be used to create the workflow tool.
mat:workflowtool-manager -c 'Auto Update Exception' -p 'EXR AUTO Update Exception'
-u 81200026 -i 0
Argument Value
-c The name of the workflow tool displayed within Matching Studio.
-p The actual name of the Control process to be invoked.
-u An integer value representing the Universe id.
-i An extra integer value which can be used as an additional parameter and will be passed
into the invoked Control process.
The Control process must contain two mandatory input process context variables:
Name Description
remoteIntegerValue This is the value as specified by the ‘-i’ argument while registering the Control process
entityList This will be a list of Control entities, where the entity type should map to the same
base table as the corresponding Universe.
229
Invoking TLM Control Workflow from Matching Service
"smartstream.mat.tlmcontrol.table.lookup": {
"map.ARC Rels SPACE": "TLM_BDR_RELATIONSHIP_HEADER",
"map.ARC Excs SPACE": "EXM_BDR_EXCEPTION",
"map.ARC Items SPACE": "ITEM",
"map.EXR AUTO Update Exception": "EXM_BDR_EXCEPTION",
"map.EXR AUTO Reallocate Exception": "EXM_BDR_EXCEPTION",
"map.REC AUTO Update Item Product": "ITEM",
"map.EXR AUTO Generate Alert On Item": "ITEM",
"map.EXR AUTO Generate Alert On Exception": "EXM_BDR_EXCEPTION",
"map.EXR AUTO Generate Alert On Message Feed": "MESSAGE_FEED",
"default.table": "ITEM"
}
If no base table is defined, ITEM table is used as the default base table. Control does not use SmartSchema, so
instead of passing a list of SmartSchema attribute passes a set of column representing the attributes needed. For
matching services to be able to correctly populate the entityList, it is necessary that a SmartSchema attribute is
defined for each column in the list passed from TLM Control.
Having registered the Control process, it can now be selected as a standard TLM style workflow tool within the pass
configuration.
230
Invoking TLM Control Workflow from Matching Service
Additional Parameters
Apart from passing the mandatory parameters, you can also configure additional input parameters by configuring
them on the workflow tool in Matching Studio.
The parameter name should match the input process context variables defined in the TLM Control process. The
default values are used when no values are specified against the workflow tool when selected within the pass
configuration.
231
Invoking TLM Control Workflow from Matching Service
232
Updating/Reallocating Exception Workflow
Updating/Reallocating Exception
Workflow
TLM Recs Premium provides the mechanism to update and reallocate exceptions automatically.
• Updating the exception would allow changing the exception header level attributes for example priority, reason
code, resolution code etc.
• Reallocating the exception would allow changing the exception inbox.
Both of these operations need exceptions to be identified followed by some business logic processing to be able to
update/reallocate the exception. Any changes to the exception will be audited both at the operation and attribute
level.
Below section are described with the examples, however, these can be changed by supplying the requirements to
SmartStream Professional Services who can then configure the process to fit your requirements.
This configuration process runs as follows:
1. Configuring a pass, see page 235
2. Configuring a pass list, page 236
3. Configuring an initiation, page 237
4. Submitting an initiation, page 238
233
Updating/Reallocating Exception Workflow
234
Updating/Reallocating Exception Workflow
Configuring Pass
To identify the exceptions that you want to update/reallocate, you first create a pass.
Below is the example for the Auto Update Exception Pass:
235
Updating/Reallocating Exception Workflow
236
Updating/Reallocating Exception Workflow
Configuring Initiation
Below is the example for the EXR Trigger Update Exception Initiation:
Initiations need to be defined of Type "Remote STPCA Engine" with Remote Engine parameters configured to
have predefined value.
237
Updating/Reallocating Exception Workflow
Submitting Initiation
Initiations defined can also be scheduled and if configured would be picked up the Schedule engine and would be
submitted via the WORKFLOW_QUEUE table.
Note that initiations of “Remote STPCA Engine" (Type 2) in the WORKFLOW_QUEUE table are not directly
picked up by Matching Services but instead will be read by the Control daemon process (in the EXR project) which
then submits the initiation via JMS Queue.
WORKFLOW_QUEUE initiations which need to be directly picked by Matching Services need to be of “STP
Workflow Manager" (Type 1) but can only be based on the ITEM universe.
Matching Services then processes this initiation as any other initiation and then returns the result by invoking the
configured process in the pass with the entity list populated.
The configured process then executes the necessary business logic to update /reallocate the exception.
238
Generating Alerts
Generating Alerts
Alert Service allows to generate alerts on any entity type rather than just exceptions. This is achieved by leveraging
the Matching Services capabilities to execute rules on any universe and identify underlying data on which alerts can
be created.
The standard implementation of the service allows to generate alerts on Item, Exception and Message Feed which
implies that rules can be setup on the Item, REC Exceptions and REC Message Feed Admin universe to be able to
identify and generate alerts on Item, Exceptions and Message Feeds.
Standard business logic tools are provided to generate alerts on specific underlying entities which can be used while
setting up configuration i.e. Pass. These business logic tools are standard TLM Control workflow tools which are
used to delegate to the Common Services Alert framework for creation of alerts.
Refer to Invoking TLM Control Workflow from Matching Services, page 229 for details on how Matching Services
can be used to identify data sets on non Item universe and invoke TLM Control Workflows.
In general, the configuration for identification of underlying data on which alert need to be generated is no different
than standard matching configuration except for invoking some predefined workflow tools which result in creation
of alerts.
The alerts are generated in the system, which are flagged up in the user interface i.e. WebConnect on the navigation
bar, refer Recs Premium User Guide, section Viewing Alerts for details.
239
Generating Alerts
Configuring Pass
To identify the underlying items on which you need to generate an alert, you first create a pass.
Below is the example for Auto Generate Item Alert Pass:
AlertInboxLookup is an optional attribute which if populated will allocate the alert in the appropriate Inbox else
will default to 'Unallocated'.
AlertTypeLookup is a mandatory attribute which defines the Alert Type of the alert. The alert types can soft
configured using the static administration option.
240
Generating Alerts
241
Generating Alerts
Configuring Initiation
Below is the example for the EXR Trigger Alert On Item is shown below:
Initiations need to be defined of Type "Remote STPCA Engine" with Remote Engine parameters configured to
have predefined value of 'ALERT'.
242
Generating Alerts
Submitting Initiation
Initiations defined can also be scheduled and if configured would be picked up the Schedule engine and would be
submitted via the WORKFLOW_QUEUE table.
Please note that initiations of Type 2 i.e. "Remote STPCA Engine" in the WORKFLOW_QUEUE table are not
directly picked up by Matching Services but instead will be read by the Control daemon process (in the EXR project)
which then submits the initiation via JMS Queue.
WORKFLOW_QUEUE initiations which need to be directly picked by Matching Services need to be of Type 1
"STP Workflow Manager" but can only be based on the ITEM universe.
Matching Services then processes this initiation as any other initiation and then returns the result by invoking the
configured process in the pass with the entity list populated.
The configured process then executes the necessary business logic to generate an alert on the underlying entity list.
243
Generating Alerts
244
Configuring Archiving
Configuring Archiving
245
Configuring Archiving
246
Configuring Archiving
247
Configuring Archiving
248
Configuring Archiving
Retention Days
The retention date value is stored in the SOLUTION_PROPERTIES table, and by default is 30 days.
You can set the retention days to a different value by running the following SQL command:
UPDATE SOLUTION_PROPERTIES SET VALUE = ‘<new retention days>’
WHERE NAME = ‘RECS_HISTORY_RETENTION_DAYS’;
COMMIT;
The new retention days value is applied only to records that are loaded or matched after the value is changed. The
archive date is not changed for records that have already been loaded and assigned a date based on the previous
retention days value.
After changing the retention period, you must restart the loading service (GEMS) and the application server to
avoid caching issues.
249
Configuring Archiving
250
Configuring Archiving
251
Configuring Archiving
Additional Partitions
When partitioning is set up for the database, the administrator is required to specify the partitions that they want to
create according to specified date limits. The administrator must subsequently ensure that that further partitions are
created before the expected archival date set on incoming records exceeds the date limit of the last partition.
Otherwise, if records are loaded for which the archive date falls after the existing partitions' date limits, the database
will throw an error and the records will not be loaded.
252
Configuring Archiving
253
Configuring Archiving
254
Configuring Archiving
Items
Items are identified and archived from the ITEM table and related tables. Links to other elements are preserved.
Data attributes on the ITEM table are stored and will be accessible as needed.
Archived data is stored in a new format and contain notes added to the item as well as audit details associated with
the item in addition to the ITEM table:
This data is embedded within the item archive structure and will be available when displaying it. Links to other data
elements are also embedded within the item archive structure, and thus provide access to relationships, exceptions
and attachments.
When archived, these elements are stored in different, dedicated data structures. It is possible to navigate from the
links to the underlying detail in these other structures through the Archive user interface.
You can search archived items by using the following standard attributes:
• Set ID
• Item Set Internal ID
• Statement Date
• Item Type
• Feed ID
• Category Code
• Item Id
• Item Status
• Item Exception Status
• Value Date
• Reference 1
• Amount or Value
• Currency 2
• Item Asset Code
• Quantity
By configuring appropriate properties in SmartSchema, additional attributes can be made available to be included in
the XML structure or for searching.
For more information on configuration, see page 258.
Attributes included in the archived xml-file can be customized using SmartSchema. This is true for all types of
Archive, not just items.
255
Configuring Archiving
Exceptions
Exceptions are identified and archived from the EXM_BDR_EXCEPTION table and related tables. Links to other
elements are preserved. Data attributes on the EXM_BDR_EXCEPTION table are stored and will be accessible as
needed.
Data extracted to the archive is stored in a new format and contain exception summary, notes added to the exception
and audit associated to the exception in addition to the EXM_BDR_EXCEPTION table:
This data is embedded within the exception archive structure and will be available when displaying it. Links to other
data elements are also embedded within the exception archive structure and provide access to items, messages and
attachments.
When archived, these elements are stored in different, dedicated data structures for items and attachments
respectively. It is possible to drilldown from the links to the underlying detail in these other structures through the
Archive user interface.
You can search the archived exceptions by the following standard attributes:
• Exception ID
• Priority
• Status
• Exception Key
• Owner
• Created
• Reference
• Reason Type Name
• Resolution Type Name
• Exception Type Name
• Exception Category Name
• Inbox Name
• Set
• Exception Business Entity Name
• Their Reference
• Exception Set Internal Id
By configuring appropriate properties in SmartSchema, additional attributes can be made available to be included in
the XML structure or for searching.
For more information on configuration, see page 258.
Attributes included in the archived xml-file can be customized using SmartSchema. This is true for all types of
Archive, not just exceptions.
256
Configuring Archiving
Relationships
Relationships are identified and archived from the TLM_BDR_RELATIONSHIP_HEADER table and related tables.
Links to other elements are preserved. All data attributes on the TLM_BDR_RELATIONSHIP_HEADER table are
stored and will be accessible as needed.
Data extracted to the archive is stored in a new format and contains audit details associated with the relationship in
addition to the TLM_BDR_RELATIONSHIP_HEADER table.
This data is embedded within the relationship archive structure and will be available when displaying it. Links to
other data elements are also embedded within the relationship archive structure and provide access to items involved
with the match relationship.
When archived, these elements are stored in the dedicated data structure for items. It is possible to navigate from the
links to the underlying detail in the archived items through the Archive user interface.
You can search archived relationships by using the following standard attributes:
• Rel Hdr Relationship ID
• Rel Hdr Overall Status
• Rel Hdr Creation Type
• Relationship Type Name
• Relationship Category Name
• Set ID
• Category Code
• Rel Hdr Principal Date
• Rel Hdr Principal Amount
• Rel Hdr Set Internal ID
By configuring appropriate properties in SmartSchema, additional attributes can be made available to be included in
the XML structure or for searching.
For more information on configuration, see page 258.
Attributes included in the archived xml-file can be customized using SmartSchema. This is true for all types of
Archive, not just relationships.
257
Configuring Archiving
Instead of using a stand-alone framework for configuring archiving tasks, Matching Services is used to identify the
data to be archived. This offers flexibility in terms of configuring identification rules.
There are multiple reasons for requiring a two stage process for archiving and deleting. Prior implementations (e.g.
Advance Archive Solution) show that these have different impacts on the system performance. It is therefore
desirable to be able to schedule them at different times.
It is also a very common business practice to verify archived data before deleting it from the live system.
258
Configuring Archiving
Phase 1: Identifying
The identification process is as follows:
1. A matching run is triggered to identify the data you want to archive. It defines the type and the relevant
properties.
2. Matching Services performs the matching run which identifies the data sets to be archived.
3. For every data set identified, Matching Service invokes the Archive workflow tool (i.e. TLM Control process)
which internally creates Archive jobs and triggers the actual Archive process.
Creating an Archive job involves populating the job table with entity unique identifiers.
Triggering the archiving process involves writing the Archive properties to the file system.
The Archive properties file path can be configured using the property named
'RECS_ARCHIVE_PROPERTIES_FILE_PATH' in the SOLUTION_PROPERTIES table.
Below are the tables created for storing the Archive job details.
RECS_ARCHIVE_JOB - The archive job indicates the entity type being archived along with the lifecycle
status.
Column Description
JOB_ID Unique Identifier.
ENTITY_TYPE Entity Type of the archive job.
STATUS Status within the life-cycle of the job.
STATUS_ITEMS Status within the life-cycle of interdependent jobs viz. Relationship archive.
RECS_ARCHIVE_JOB_LINK - The archive job link table provides the list of entity ids which are ready to be
archived.
Column Description
JOB_LINK_ID Unique Identifier.
JOB_ID ID of the archive job.
LINKED_ENTITY_KEY Unique Identifier of the entity to archive.
STATUS Status within the life-cycle of the entity within the archive job.
The following Archive lifecycle statuses are available:
1. READY_FOR_ARCHIVE
2. ARCHIVING
3. ARCHIVED
4. CANCELLED
For details on how to setup archive matching configuration, see page 261.
259
Configuring Archiving
Phase 2: Archiving
Each triggered archiving process goes through a series of steps and updates the Archive job status to 'ARCHIVED'
upon completion.
In case of the Relationships, an additional archiving process is initiated for Items using the same job reference.
1. The archive updates the job status to ARCHIVING and builds a complete list of IDs to be archived. In the
simplest case those IDs are taken from the RECS_ARCHIVE_JOB_LINK table for the corresponding job.
Depending on the entity type, additional information could be joined to the entity specific tables
Example:
The item archive checks the entity type of the archiving job. When the entity type is ITEM (8018), it obtains the
list of IDs from the RECS_ARCHIVE_JOB_LINK table. When the entity type is RELATIONSHIP (8021), it
uses a join between the RECS_ARCHIVE_JOB_LINK table and the TLM_BDR_RELATIONSHIP_LINK
table. This allows for items to be archived independently of relationships if necessary.
2. The archive extracts the data for the IDs and generates the XML. The contents of the XML are configurable in a
sense that entity level and filter level attributes can be included/excluded by attribute properties in the schema.
Schema attribute properties have been introduced to provide this flexibility:
Attribute Property 'Archive' with ID 221.
Attribute Property 'Archive Filter' with ID 222.
3. The well-formed XML is then passed back to TLM which uses the message type group (MTG) configuration to
process and persist.
4. When the archiving process is completed successfully, the archive updates the job status to ARCHIVED.
Interdependent archives will update the job entity specific status.
Example:
When the archiving process is completed successfully, the item archiver will update the
RECS_ARCHIVE_JOB#STATUS_ITEMS column so that the relationship archiver can be triggered
accordingly. In case an error occurs in the archiving process, the archiver updates the job status to
CANCELLED.
260
Configuring Archiving
261
Configuring Archiving
Configuring Pass
To identify the data you want to archive, you must first create a pass. A pass defines the type of data that you want to
archive, and the relevant properties of the data (e.g. status).
Scopes
Data sets for all archive types are restricted by the corresponding set. If archive types are not based on the item
universe, the default scope functionality has to be used.
Default scope is configured using the object property Default scope attributes for universe (97) in SmartSchema.
It is necessary to define a scope when using the item universe. If a pass is defined on the item universe with no
scope, then Matching Services will use the default scope which includes only outstanding items for the given set.
This may lead to items that should not be archived being removed from the database.
Populations
By default, pass quality rules are not applied on data sets for archiving.
262
Configuring Archiving
263
Configuring Archiving
264
Configuring Archiving
Configuring Initiation
An initiation specifies a pass list. This pass list is executed when the corresponding initiation is triggered.
4. Enter one of the following values for the corresponding purpose in the Integer Value field.
Value Purpose
8021 Used for relationships
8018 Used for items.
1001 Used for exception.
265
Maintaining and Loading General Ledger Static Data
The following options are available on the Set Administration menu to enable admin users to configure GL
reconciliations processing:
• Fiscal Calendars – enables maintenance of fiscal calendars that represent key reconciliation period dates. The
dates are used to control workflow, state changes, and scorecard criteria. Calendar Period entries relate to a
named Fiscal Calendar. Each GL set must be associated with a fiscal calendar.
• Chart of Accounts – enables users to define how the full AFF code is broken into sections, which allows the
dynamic display of any AFF without the need to extract all of the data during the load process. The data stored
will also be used during the Auto Assignment processing, which assigns unknown items to existing sets of
creates new sets.
The following option is also available on the Static Administration menu for GL recs:
• Currency Groups - enables maintenance of groups of Currency and Exchange Rates that are available for use
with Sets. A set links to a group, which gives all items on the set access to the rates in that group. This enables
the exchange rates to be direct currency to currency rates, rather than via the base currency of a set.
Users with the Admin Role have access to all of these options.
This section describes how to create and maintain each of these items manually using the UI, and also how load this
information automatically using static data feeds.
266
Maintaining and Loading General Ledger Static Data
267
Maintaining and Loading General Ledger Static Data
Creating a Calendar
To Create a New Calendar
1. Select Menu > Set Administration > Fiscal Calendars > New Fiscal Calendar.
The Rec Admin Fiscal Calendar Create dialog is displayed. For example:
268
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Fiscal Calendars > Fiscal Calendars.
A search prompt is displayed.
2. Enter the required calendar name, or leave the field blank to return all calendars, and click [Search]
The Rec Admin Fiscal Calendar Detail dashboard is displayed.
3. Right-click on the calendar that you want to create a fiscal period for and select New Fiscal Period.
The New Fiscal Period dashboard is displayed.
269
Maintaining and Loading General Ledger Static Data
270
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Fiscal Calendars > Fiscal Calendars.
A search prompt is displayed.
2. Enter the required calendar name, or leave the field blank to return all calendars, and click [Search].
3. Right-click on the calendar that you want to edit a fiscal period for and select Fiscal Period Details.
The fiscal periods for the selected calendar are displayed. For example:
4. Right-click on the period that you want to update and select Update Fiscal Period.
The Fiscal Period Update window is displayed.
271
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Fiscal Calendars > Fiscal Calendars.
A search prompt is displayed.
2. Enter the required calendar name, or leave the field blank to return all calendars, and click [Search].
3. Right-click on the calendar that you want to delete a fiscal period for and select Fiscal Period Details.
The fiscal periods for the selected calendar are displayed.
4. Select the fiscal period that you want to delete using the selectors on the left and click the delete button
on the toolbar, or right-click and select Delete Fiscal Period.
The fiscal period is deleted.
272
Maintaining and Loading General Ledger Static Data
Updating a Calendar
You can edit the name or description of a calendar.
To Update a Calendar
1. Select Menu > Set Administration > Fiscal Calendars > Fiscal Calendars.
A search prompt is displayed.
2. Enter the required calendar name, or leave the field blank to return all calendars, and click [Search].
The calendars are displayed.
3. Right-click on the calendar that you want to update and select Update Calendar.
The Update Fiscal Calendar window is displayed.
273
Maintaining and Loading General Ledger Static Data
Deleting a Calendar
Ensure that the fiscal period is not the current period before you attempt to delete it.
To Delete a Calendar
1. Select Menu > Set Administration > Fiscal Calendars > Fiscal Calendars.
A search prompt is displayed.
2. Enter the required calendar name, or leave the field blank to return all calendars, and click [Search].
3. Select the calendar that you want to delete using the selectors on the left and click the delete button on
the toolbar, or right-click and select Delete Fiscal Calendar.
The calendar is deleted.
274
Maintaining and Loading General Ledger Static Data
275
Maintaining and Loading General Ledger Static Data
276
Maintaining and Loading General Ledger Static Data
1. Select Menu > Static Administration > Currency Groups > New Currency Group.
The Rec Admin Currency Group Create dialog is displayed.
277
Maintaining and Loading General Ledger Static Data
1. Select Menu > Static Administration > Currency Groups > Currency Groups.
A search prompt is displayed.
2. Enter the required currency group name, or leave the field blank to return all groups, and click [Search]
The Rec Admin Currency Group Detail dashboard is displayed.
3. Right-click on the currency group that you want to add a currency rate to and select New Currency Rate.
The New Currency Rate dialog is displayed.
278
Maintaining and Loading General Ledger Static Data
1. Select Menu > Static Administration > Currency Groups > Currency Groups.
A search prompt is displayed.
2. Enter the required currency group name, or leave the field blank to return all groups, and click [Search]
The Rec Admin Currency Group Detail dashboard is displayed.
3. Right-click on the currency group that you want to update a currency rate for and select Currency Detail.
The Currency Rate Detail dialog is displayed.
4. Right-click on the currency rate that you want to update and select Update Currency Rate.
The Update Currency Rate dialog is displayed.
279
Maintaining and Loading General Ledger Static Data
1. Select Menu > Static Administration > Currency Groups > Currency Groups.
A search prompt is displayed.
2. Enter the required currency group name, or leave the field blank to return all groups, and click [Search]
The Rec Admin Currency Group Detail dashboard is displayed.
3. Right-click on the currency group that you want to delete a currency rate from and select Currency Detail.
The Currency Rate Detail dialog is displayed.
4. Select the currency rate that you want to delete using the selectors on the left and click the delete button
on the toolbar, or right-click and select Delete Currency Rate.
The currency rate is deleted.
280
Maintaining and Loading General Ledger Static Data
1. Select Menu > Static Administration > Currency Groups > Currency Groups.
A search prompt is displayed.
2. Enter the required currency group name, or leave the field blank to return all groups, and click [Search]
The Rec Admin Currency Group Detail dashboard is displayed.
3. Right-click on the currency group that you want to update and select Update Currency Group.
The Update Currency Group dashboard is displayed.
4. Click [Create].
281
Maintaining and Loading General Ledger Static Data
1. Select Menu > Static Administration > Currency Groups > Currency Groups.
A search prompt is displayed.
2. Enter the required currency group name, or leave the field blank to return all groups, and click [Search]
The Rec Admin Currency Group Detail dashboard is displayed.
3. Select the currency group that you want to delete using the selectors on the left and click the delete button
on the toolbar, or right-click and select Delete Currency Group.
The currency group is deleted.
282
Maintaining and Loading General Ledger Static Data
283
Maintaining and Loading General Ledger Static Data
Some sample Drools files and Control processes are supplied that should be configured to your specific
requirements. You should also configure the File Reader to specify the location of the directory that will contain the
message feed files, the file names to look for (for example '*.txt') and the polling interval.
You must configure the chart of account segments to capture the data correctly from the messages.
284
Maintaining and Loading General Ledger Static Data
285
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Chart of Accounts > New Chart of Accounts.
The Rec Admin Chart of Account Create dialog is displayed.
286
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Chart of Accounts > Chart of Accounts.
The REC Admin Chart of Account Detail dashboard is displayed.
2. Right-click on the CoA that you want to add a segment to and select New Chart of Account Segment.
The New Chart of Account Segment dialog is displayed.
287
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Chart of Accounts > Chart of Accounts.
The Rec Admin Chart of Account Detail dashboard is displayed.
2. Right-click on the CoA that you want to update a segment for and select Chart of Account Segments.
The Chart of Account Segments dashboard is displayed.
3. Right-click on the segment that you want to update and select Update Chart of Account Segment.
The Update Chart of Account Segment dialog is displayed.
288
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Chart of Accounts > Chart of Accounts.
The Rec Admin Chart of Account Detail dashboard is displayed.
2. Right-click on the CoA that you want to update a segment for and select Chart of Account Segments.
The Chart of Account Segments dashboard is displayed.
3. Right-click on the segment that you want to add a lookup to and select New Chart of Account Lookup.
The New Chart of Account Lookup dialog is displayed.
4. In the Code field, enter the lookup text that you expect to be present in the specific segment on the message
feed.
5. In the Description field, enter the text for the decode.
6. Click [Create].
7. Repeat steps 3 to 6 to add any additional lookup values for the segment.
289
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Chart of Accounts > Chart of Accounts.
The Rec Admin Chart of Account Detail dashboard is displayed.
2. Right-click on the CoA that you want to delete a segment for and select Chart of Account Segments.
The Chart of Account Segments dashboard is displayed.
3. Select the segment that you want to delete using the selectors on the left and click the delete button on
the toolbar, or right-click and select Delete Chart of Account Segment.
The segment is deleted.
290
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Chart of Accounts > Chart of Accounts.
The REC Admin Chart of Account Detail dashboard is displayed.
2. Right-click on the CoA that you want to update and select Update Chart of Account.
The Update Chart of Account dialog is displayed.
291
Maintaining and Loading General Ledger Static Data
1. Select Menu > Set Administration > Chart of Accounts > Chart of Accounts.
The REC Admin Chart of Account Detail dashboard is displayed.
2. Select the CoA that you want to delete using the selectors on the left and click the delete button on the
toolbar, or right-click and select Delete Chart of Account.
The chart of account is deleted.
292
Maintaining and Loading General Ledger Static Data
293
Maintaining and Loading General Ledger Static Data
1. From the Menu select Menu > Static Administration > Drools > Drools.
A search dialog is displayed.
2. Enter any relevant details to narrow down the search, or leave the fields blank to return all drools files, and click
Search.
The REC Drools Attachment dashboard is displayed.
3. Right-click on the file that you want to download for editing and select Download.
A dialog is displayed offering you the option to Open or Save the file.
• Open – opens the file for editing. You will need to save the file before you can upload it back to the
application server.
• Save – saves the file to your local machine, from where you can open it for editing.
294
Maintaining and Loading General Ledger Static Data
1. From the Menu select Menu > Static Administration > Drools > Drools.
A search dialog is displayed.
295
Maintaining and Loading General Ledger Static Data
1. From the Menu, select Set Administration > Set > Incomplete Set Details.
A search prompt is displayed.
2. Select or enter any required text to narrow down the search, or leave the fields blank to return all the incomplete
sets, and click [Search].
The REC Admin Incomplete Set Summary is displayed, showing only those categories that contain incomplete
sets.
3. Double-click on the category that you want to work with.
The Incomplete Set Detail grid is displayed, which is very similar to the Set Detail dashboard.
For details see chapter Maintaining Sets > Viewing Set Details.
4. Enter the missing set details inline or using the Update Sets form.
For details on entering the missing set details inline, see chapter Maintaining Sets > Updating set details inline.
For details on updating sets, see chapter Maintaining Sets > Configuring all set details.
5. Save your changes.
1. From the Menu, select Set Administration > Set > Incomplete Message Feed Details.
A search prompt is displayed.
2. Select or enter any required text to narrow down the search, or leave the fields blank to return all the incomplete
message feeds, and click [Search].
The REC Admin Incomplete Message Feed Summary is displayed, showing only those sets that contain
incomplete message feeds.
3. Double-click on the message feed that you want to work with.
The Incomplete Message Feed Detail grid is displayed, which is very similar to the Message Feed Detail
dashboard.
For details on Message Feed Detail dashboard, see chapter Maintaining Sets > Configuring message
feeds > Viewing message feed details.
4. Enter the missing message feed details using the Update Message Feed form.
For details on Update Feed Detail form, see chapter Maintaining Sets > Configuring message feeds > Updating
message feed details.
5. Save your changes.
296
Maintaining and Loading General Ledger Static Data
297
Maintaining and Loading General Ledger Static Data
1. The static data queue for the feeds must be created. For details of how to configure JMS queues, see the
Configuring queues and topics section of the TLM Control Implementation Guide for your application server.
2. Using Process Designer, ensure that the File Reader points to the location of the directory where the static data
files will be placed.
The first line is mandatory and must be the indicator, which is one of the following.
• FISCALPERIOD
• CURRENCYRATE
• CHARTACCOUNT
The second line must be the header.
Each row must be defined in new line after the header line.
All the attributes must be separated by the ‘|’ delimiter.
298
Maintaining and Loading General Ledger Static Data
Fiscal Periods
When a Fiscal period load is performed:
• If a fiscal period does not already exist, it will be created under the existing Fiscal Calendar. Existing periods are
identified using the period name field on the data.
• If the fiscal calendar does not exist, a new calendar will be created, and the new fiscal period will be created
within that calendar. The new calendar will be created using the calendar name field on the data.
FISCALPERIOD
CALENDARNAME|PERIODNAME|PERIODDESCRIPTION|PERIODSTARTDATE|PERIODENDDATE|RECSSTARTDATE|
RECSENDDATE|OVERDUEDATE|CRITICALDATE
TESTING1234|JUNE11|TESTING CALENDER JUNE|2011-06-06|2011-07-03|2011-07-04|2011-08-
08|2011-08-13|2011-08-14
299
Maintaining and Loading General Ledger Static Data
CURRENCYRATE
CURRGROUPNAME|FROMCURR|TOCURR|RATE|ACTIVE_FROM
INCCYGROUP|GBP|INR|70|2011-06-25
INCCYGROUP|GBP|USD|1.6|2011-06-25
300
Maintaining and Loading General Ledger Static Data
Chart of Account
To load a Chart Of Account segment, the segment ID is mandatory, which means that the CoA segment must already
be defined using the dashboards.
Before you load the CoA feeds, they must be edited to contain the segment ID as defined in WebConnect.
CHARTACCOUNT
SEGMENT_ID|CODE|DESCRIPTION
18|001|Bristol
18|002|London
19|003|New York
301
Maintaining and Loading General Ledger Static Data
3. Select the message feed that you want to move using the selectors on the left.
Click the Regroup Message Feed tool on the toolbar, or right-click and select Regroup Message Feed.
4. Select the Set ID that you want to move the message feed to from the list, and click [OK].
Any approved proofs affected by this move are reset, and any opportunities are recalculated.
302
Loading Messages
Loading Messages
SWIFT-format messages first have to be converted into a common flat file format before being loaded into TLM
Reconciliations-Premium via Gems using the RecSol.ffswift.KB. This kb file can be found in the
[Artifacts]\RecsPremium\flattener directory, and must be copied to the cfg directory where the SmartData and Recon
servers are installed, for example, $TLM_HOME/Server/cfg on UNIX, or %TLM_HOME%\Cfg on Windows.
The conversion program that you use to convert message to this format is called 'recswft' which can be found in the
[Artifacts]\RecsPremium\flattener directory, and must be copied to the bin directory where the SmartData and Recon
servers are installed.
The SWIFT flattener Recswft has been designed to behave as much like a simple reformatter as possible, but there
might be occasions when you need to give it addition parameters, such as a different KB location or file name.
Therefore it is recommended that you create a simple batch script to run it that accepts the input and output
filenames, but also allows you to specify other parameters as required. You then quote the script name in the
stlfetch.config file instead of the program name itself. A sample stlfetch file called stlfetch.example can be found in
the [Artifacts]\RecsPremium\flattener; this file must be edited as required for your environment, and saved to the
$TLM_HOME/Server/cfg directory on UNIX, or %TLM_HOME%\Cfg directory on Windows.
The command format for running recswft is as follows:
recswft inputfilename outputfilename {-d debuglevel) (-s KBname}
where 'debuglevel' is a number in the range 0 to 100, 0 being 'no debugs' and 100 being 'full debugs', and KBname is
the full path and name of the KB file to be used by the program. Either or both parameters can be specified. The
batch script should therefore contain something like this
recswft $1 $2 -d 1 -s /pathtokbfile/RecSol.ffswift.KB"
Where the input files contain Ledger and Statement messages, these are written to different files with a suffix
indicating which flatfile KB to be used for them. For example, flattened Cash messages are written into the
$2.OURCASH file for ledger messages, and the statement messages into the $2.THEIRCASH. The $2 file is created
but empty.
To convert MT940s and MT950s, use the mapmt900.kb file. MT571 and MT572 require the Mapoldsec.kb file,
while MT535 and MT536 require the Mapisosec.kb file. These files can be found in the directory where you
installed the SmartData and Recon servers, for example, $TLM_HOME/cfg on UNIX, or %TLM_HOME%\Cfg
directory on Windows.
For example:
recswft TEST_CASH.txt -s TEST_CASH "C:\Program Files\Smartstream Technologies\TLM
Server\RP2.2\Cfg\mapmt900_test.kb"
TLM Reconciliations-Premium only supports a subset of the SWIFT messages supported by TLM. Recswft accepts
all SWIFT messages supported by TLM, but ignores those not supported by TLM Reconciliations -Premium.
303
Loading Messages
Managing KBs
When you upgrade the SmartData and Recon servers, a new set of KBs, updated to the latest SWIFT version at the
time of release, are provided in the $TLM_HOME/cfg.latest directory on UNIX, or %TLM_HOME%\Cfg.Original
directory on Windows, so that any KB files that you have configured are not overwritten by the new versions. If you
want to use the latest KBs you must copy them to the Cfg directory and configure them as required.
One of these standard KBs is the primary KB; the other standard KBs are linked to the primary KB.
Any KBs that you generate using SmartSchema must also be linked to the primary KB. For example:
You can link several KBs together (known as chaining) so that they act as a single combined KB. You must do this if
you need to include a new message KB but still need to use the default KBs to load the standard messages.
As part of the linking process, you must also revise the options section in the primary KB to reflect the options
sections of the KBs that you want to link.
The following fields are reserved in KB mappings: string_4, agent_code, string_6, and string_8.
For Windows only Gems require an extra parameter that defines the path to the main KB file. This must be
specified in the Options field when you create the GEMS server using Server Manager. For example: -s
"C:\Program Files\Smartstream Technologies\TLM Server\RP2.2\Cfg\master.kb". If the path to the KB contains
spaces, as in this example, it must be enclosed within double quotes.
304
Loading Messages
305
Loading Messages
tag ":SIDE:"
mandatory
category C_GENERAL
split into
msghdr.side as "%[^\0]" using Gms_DecodeSide
.
.
2. Revise the options section of the primary KB to reflect the contents of the new KBs:
Option Set value to...
MaxFeeds The sum of the values specified in the included KBs and the value in the primary KB
MaxCategories The largest value specified in the included KBs
MaxBlocks The sum of the values specified in the included KBs and the value in the primary KB
MaxMessageTypes The sum of the values specified in the included KBs and the value in the primary KB
MaxFields The sum of the values specified in the included KBs and the value in the primary KB
MaxItems The largest value specified in the included KBs
MaxNesting The largest value specified in the included KBs
MaxASCIIFields The largest value specified in the included KBs
MaxErrors The largest value specified in the included KBs
MaxWarnings The largest value specified in the included KBs
MaxFieldSplits The sum of the values specified in the included KBs and the value in the primary KB
MaxMessageTypesInFeed The sum of the values specified in the included KBs and the value in the primary KB
MaxFieldsInBlock The sum of the values specified in the included KBs and the value in the primary KB
MaxBlocksInMessage The sum of the values specified in the included KBs and the value in the primary KB
MaxCategoriesInMessage The largest value specified in the included KBs
IgnoreFlatFileNulls One of the following options:
1 - Gems loads messages that do not contain any transactions
0 - Gems puts messages that do not contain any transactions into Operator Intervention.
For example:
3. From each of the KBs that you are linking (not including the primary KB), remove the lines from the options
section to the end of the block BSSRFlds section).
306
Loading Messages
The first line of the linked KBs should begin with feed information.
307
Loading Messages
• Edit the primary KB, by adding the path of the new KB at the end of the file, for example:
include
"/ssrrel/oracle/TLM/server/cfg/KB/master.FFM10008"
• For chaining, link the primary KB to the first KB and then link the first KB to the next KB, and so on.
For example, in the primary KB add the following line at the end of the file:
include
"/tlmrel/oracle/TLM/server/cfg/KB/master.FFM10008"
In the file /tlmrel/oracle/TLM/server/cfg/KB/master.FFM10008, add the following line:
include
"/tlmrel/oracle/TLM/server/cfg/KB/master.FFM10009"
Continue in this fashion, chaining the KBs together.
308
Loading Messages
• Edit the primary KB, by adding the path of the new KB at the end of the file, for example:
include
"C:\Program Files\Smartstream Technologies \TLM_Server\RP2.2\CFG\master.FFM10008"
• For chaining, link the primary KB to the first KB and then link the first KB to the next KB, and so on.
For example, in the primary KB add the following line at the end of the file:
include
"C:\Program Files\Smartstream Technologies TLM_Server\RP2.2\CFG\master.FFM10008"
In the file %TLM_HOME%\cfg\master.FFM10008, add the following line:
include
"C:\Program Files\Smartstream Technologies TLM_Server\RP2.2\CFG\master.FFM10009"
Continue in this fashion, chaining the KBs together.
309
Loading Messages
Customising KBs
You can customise message KBs to match the particular structure of your incoming messages. To do this, you must
add a new section to the message KB. For example, to load MT900, MT910 and MT940 from an internal source with
custom offsets, add the following section to the mapmt900 KB:
feed FD_INTERNAL_MT900
description "Internal Feed for 900, 910, 940"
header 40
mtype 12
dest 0
term 15
eom "-}"
eod "$"
eoh ""
sof ":"
messages M_900, M_910, M_940
where the parameters are as follows:
Parameter Meaning
feed The name of the feed that you are creating.
description A description of this feed.
header The number of characters to read for the header (when Gems reads the header line, it scans this many
characters and then the rest of the line containing the final character).
mtype The character position within the header that defines the mtype.
dest The character position within the header that defines the destination.
term The character position within the header that defines the term.
eom The character(s) that mark the end of the message.
eod The character(s) that mark the end of the data.
Note that Recswft automatically converts control-C characters in the incoming data to the dollar sign ‘$’, and
so the ‘eod’ character defined in the KB used by Recswft for messages ending with a control-C should be
‘$’.
eoh The character(s) that mark the end of the header.
sof The character(s) that mark the start of the feed.
messages The message types that are valid for this message description (These must be defined in the rest of the KB).
The following fields are reserved in KB mappings: string_4, agent_code, string_6, and string_8.
310
Loading Messages
311
Loading Messages
Upgrading KBs
When a new KB is delivered as part of a patch, the following procedure should be used.
To Upgrade a New KB
312
Creating Custom Reports
Custom reports are created using the BIRT report designer, either as a plugin to Eclipse or as a separate application.
You can build a report from scratch, or use the RP_BIRT_TEMPLATE.
The BIRT engine is installed on your application server as part of the TLM Control install.
The steps involved include:
• Creating a Data Set
• Creating a Join Data Set (if multiple data sources are used)
• Creating a report output file template using the graphical editor included in BIRT Designer
• Formatting the report output.
313
Creating Custom Reports
314
Creating Custom Reports
This report provides daily write offs report for Cash Settlements. The report takes ‘DATE’ input parameter to
define a specified date.
• Daily Write Off Report - Securities Transactions
This report provides daily write offs report for Securities Transactions. The report takes ‘DATE’ input
parameter to define a specified date.
• Securities Account Proof Report
This report provides proof summary of Securities Transactions for the current day. The report takes
‘CATEGORY’ and ‘LOCAL_ACC_NO’ parameters to define a specified set of accounts/categories.
• Daily Exception Report
This report provides an overview of daily exceptions on two separate tables Cash Settlements and Securities
Positions.
• File Processing Activity Report
This report provides a daily file processing activity analysis. The report records the files loaded by gems in a
single day and the resulting report shows a list of all files in time order loaded, together with the time they
started and finished loading.
Please note that there are two fields for adding your company name and logo to the reports. If these fields are not
updated or indicated as ‘null’ you will find an error in all the BIRT reports at the top of the page.
select VALUE
from SOLUTION_PROPERTIES
where NAME = 'TD_BIRT_CP_NAME'
select VALUE
from SOLUTION_PROPERTIES
where NAME = 'TD_BIRT_CP_IMAGE'
update them with the following or just enter a space or null into the fields if you do not want a logo or company
name.
update SOLUTION_PROPERTIES set value = 'INSERT FILENAME AND FULL PATH OF COMPANY
LOGO.jpg'
where name = 'TD_BIRT_CP_IMAGE'
315
Creating Custom Reports
In addition to the standard types, input parameters can also be configured to have specific behaviour, such as the
WebConnect Chooser.
For example, below is the ‘Security Transactions Account Proof Report’ which has input parameters configured to
allow selection of parameters using a Chooser (highlighted in RED).
Configuration Details:
In order to get the BIRT Report UI to render choosers against the input parameters, the
RECS_REF_REPORT_PARAM table should be populated with the details of the chooser.
Below is the configuration done to get choosers against the input parameters CATEGORY and LOCAL_ACC_NO
for the ‘Security Transactions Account Proof Report’ (shown above).
Column Details:
316
Creating Custom Reports
The above chooser specification is simply a select and will return all the categories available.
LOCAL_ACC_NO chooser specification:
The above chooser specification is filtered select and will return sets under specific category.
For more details on how to configure chooser specifications refer the choosers.doc.
317
Creating Custom Reports
Building a Report
BIRT is used to create templates for TLM Reconciliations-Premium reports. The report templates that you create are
used as the basis for TLM Control Template Steps.
318
Creating Custom Reports
319
Creating Custom Reports
Pre-configuration tasks
The pre-configuration tasks required depend on whether you are creating reports using Eclipse with BIRT or the
BIRT designer application.
320
Creating Custom Reports
The report datasource must be configured with the connection parameters of your local database server to enable
you to test data sets and preview the results of SQL queries in BIRT Designer.
1. Click on the Data Explorer area and select the <Data Source>.
2. Right-click and select New Data Source or edit an existing data source.
3. Select the Create from data source type in the list that is displayed.
4. Select JDBC Data Source and type in a data source name.
5. Click [Next].
6. Ensure that the driver class is selected. If not, install the required driver class as follows:
1. Click the [Manage Drivers] button.
2. Click [Add].
3. Add <ORACLE_INSTALL_DIR>\product\10.2.0\db_1\jdbc\lib\ojdbc14.jar.
7. Enter the connection parameters of your configuration in the Database URL, User Name, Password and JNDI
URL fields.
8. Click [Test Connection].
If the connection fails you must correct the information in these fields and retest.
9. Click [Finish].
321
Creating Custom Reports
1. In the Data Explorer area, right-click on the Data Source node and select Edit.
2. Select the Property Binding node.
The Property Binding window is displayed.
3. Populate the connection fields with the required details.
When you enter a password, it is encoded for security purposes.
4. Click [OK].
322
Creating Custom Reports
To Configure a Dataset
1. In the Data Explorer area, right-click on the Data Sets node and select New Data Set.
2. Specify a name, a data source and a type to form the SQL Select query.
3. Click [Next].
4. Enter the SQL query. For example:
Select LOCAL_ACC_NO, AGENT_CODE, CURRENCY from BANK
5. Click [Next].
6. Select the Preview Results mode to view the output from the query.
7. Select the Output Columns node to display the list of columns.
Ensure that you don’t remove the default parameters user, td_birt_url, td_birt_user and td_birt_password as
these are used to invoke BIRT by TLM Recs.
3. In the Data Explorer area, right-click on the Data Set and select Edit.
4. Create a parameter in the Parameters tree view entry and link to a report parameter.
5. Select a default value for the parameter to enable you to preview the result of the data set.
323
Creating Custom Reports
Example
1. Right-click on an empty place in the report design view and select <Insert>, then <Table>.
2. Choose 3 columns, 1 detail.
3. As a Data Set, choose the Account Data Set you just have created.
4. On the Detail Row, Right-click on each of the 3 cells and choose <Insert>, then <Data>.
5. Click <Cancel> button in the next New Data Item dialog box, because we will create the data binding with the
Data Set later.
6. On the Detail Row, right-click again on each of the 3 cells and choose <Change Data Column>. A Select Data
Binding dialog box appears.
7. In Data Set control, leave Container's Data Set.
8. In the list of Data Bindings, activate the check box of LOCAL_ACC_NO for the first cell, AGENT_CODE for the
second cell and CURRENCY for the third cell.
9. On the Header Row, to add a label on each column, Right-click on each of the 3 cells and choose <Insert>, then
<Label>.
10. Enter a label, for example, "Account name" for the first cell, "Agent Code" for the second cell and "Currency"
for the third cell.
The report will look similar to the following:
324
Creating Custom Reports
1. Click File > Menu > View Report as HTML or click the View Report as HTML button in the toolbar.
2. The report parameter entry box is displayed. Fill them with the appropriate values.
3. Click [OK].
The report is displayed in the BIRT Report Viewer.
325
Creating Custom Reports
326
Creating Custom Reports
This must be followed by the name of the report as imported into Control. An example of this, as configured in
the ‘User Activity MIS Report’, is shown below:
Allocate roles to the Selected Roles section to provide access to the dashboard. An example of this is shown
below:
327
Creating Custom Reports
328
Creating Custom Reports
There is no functionality behind the form other than to allow web update of the fields provided in the form for
reporting purposes.
If you want to enable this dashboard in the UI
1. Open SmartStudio.
2. Click Tools > Menu Editor to open the Menu Editor.
3. Change the filter in the Artifacts pane to display dashboards.
4. Locate the Rec Admin Account Update Additional dashboard in the Artifacts pane and drag and drop it into
the relevant folder in the menu structure.
5. Use the up and down arrows, or drag the dashboard, to move the dashboard to the appropriate place within the
folder you have dragged it into.
6. If required, edit the caption for the dashboard. This is used as the title for the dashboard when opening.
7. Assign the appropriate roles to the dashboard.
8. Save the changes.
The next time that a user with the relevant roles logs into the UI, the Rec Admin Account Update Additional
dashboard will be available on the main menu in the location you have added it.
329
Configuring the Auto Matching Workflow
There are a number of workflows supplied with TLM Reconciliations-Premium that can be used for automatic
matching. However, if you do not want to use the supplied workflows, you can configure your own workflows for
both matching and exceptions.
This section specifically describes how to configure the workflow required for the TLM Reconciliations-Premium
automatic matching functionality, using the Recon Admin client.
You can find detailed information on the general creation of elements and workflow processes in the Business
Processing Guide.
330
Configuring the Auto Matching Workflow
331
Configuring the Auto Matching Workflow
Pass lists
Pass lists are the means by which you specify the passes that you want to call when the automatic matching process
is triggered.
Passes
Passes are used to define how items are grouped and tested. The conditions of a pass are specified using the
following rules:
• Scope rules – restrict the items selected for a pass.
• Population rules – define how data from different messages is mapped into the match reference array, including
the item attributes that are used for matching, and any tolerances on amount and date items.
• Pass Quality rules – define the conditions for testing groups of items in the match reference array. If a group of
items meets all the conditions of a pass quality rule, the group qualifies as a good match and is sent to the TLM
Control engine via a workflow tool.
Workflow tools
Workflow tools are created using event lists, and are used to send the groups of items, exceptions and relationship
types formed by passes, to the TLM Control engine. You must add a workflow tool to each pass quality step in a
pass.
Event lists
Event lists are required to build workflow tools, and consist of individual events or combinations of events. They are
used to specify the exceptions and relationships that you want to process in each pass quality step.
Initiation events
Initiation events are used to call exception and relationship type initiations. As such, each of these types of initiation
requires the configuration of one initiation event.
Initiations
Initiations are used to trigger workflow. The automatic matching process requires three types of initiation:
• Relationship initiations – to form the required relationships types.
• Exception initiations – to form the required exception types.
• STP Workflow Initiation – one STP Workflow initiation is required to automatically trigger the auto matching
process when data is loaded into a set.
332
Configuring the Auto Matching Workflow
1. Create the initiations that you require to form the matching relationships. These initiations must be configured
with the following settings:
• Type: Remote STPCA Engine
• Attach Items to Workflow Queue: this option must be enabled.
• Name - should reflect the name of the associated pass that you will create in step 6 of these instructions.
• Remote Engine Parameters: enter AUTOPERFECT or AUTOSUGGESTED depending on the type of
matches that you want the pass to create.
• Remote Engine Integer Value - enter the integer value that represents the type of match relationship that
you want to create.
You can locate this value by launching the Rec Admin Relationship Type Summary dashboard from the
Administration menu in TLM Reconciliations-Premium. This dashboard displays a list of the relationship
types available, from which you can drill down to the Relationship Type Details dashboard to view the
relationship type integer value. This value is displayed within the ID column.
2. Create the initiations that you require to form exception types. These initiations must be configured with the
following settings:
• Type - Remote STPCA Engine
• Name - should reflect the name of the associated pass that you will create in step 6 of these instructions.
• Attach Items to Workflow Queue - this option must be enabled.
• Remote Engine Parameters - enter EXCCREATE
• Remote Engine Integer Value - enter the integer value of the required exception type ID.
• Remote Engine Integer Value - enter one of the following integer values for the required exception type ID:
Exception ID Exception Type
80,001 Outstanding Ledger
80,002 Amount Break
80,003 Outstanding Statement
80,004 Position Break
80,005 Unknown Security
80,011 Value Date Break
80,012 Amount/Value Date Break
80,013 Outstanding Ledger
80,014 Quantity Break
80,015 Outstanding Statement
80,016 Aged Item Cash
80,017 Aged Item Securities
80,021 Transaction Break
80,022 No Item Exception
89,001 Converted SSR OS Cash
89,002 Converted SSR Cash Match
333
Configuring the Auto Matching Workflow
You can also view this list of exception type IDs by running the following query on your database:
SELECT exception_type_id, name FROM exm_ref_exception_type
SSR exception types are only available for TLM Reconciliations-Premium configurations that have been
converted from SSR.
3. Create an initiation event at the REC Items level, for each initiation that you created in steps 1 and 2.
4. Create event lists at the REC Items level, which contain the required combination of relationship and / or
exception initiation events. For example:
• a pass used to raise exceptions will require an event list containing an exception initiation event.
• a pass used to form relationships will require an event list containing a relationship type initiation event.
• a pass used to form a relationship and an exception will require an event list containing both relationship
and exception type initiation events.
For consistency, give the event list a name that corresponds to the initiation events it contains.
5. Create a new workflow tool for each event list that you have created, with the following configuration settings:
• Name –for consistency, give the workflow tool the same name as the pass that you will create in step 6 of
these instructions.
• Add a step to the tool’s workflow.
• Add the event list you created and a commit workflow control to the step. For example:
6. Create the required match passes at the REC Items level, with the scope, population and pass quality rules
needed to determine the items, item data and conditions used to form groups from the loaded data.
334
Configuring the Auto Matching Workflow
For each Pass Quality step, configure the associated pass quality rule properties to use the WorkFlow Tool
processing option. In the Workflow Tool Name drop-down menu, select the workflow tool that you created for
the pass, in the previous step. For example:
7. Create a new pass list, to which you must add the matching passes that you have created.
8. Configure an initiation to call the workflow engine, with the following settings:
• Initiation Type: STP Workflow Engine
• Attach Items to Workflow Queue: Disabled
• Pass List: select the pass list that you created in the previous step.
• Data Load Level: REC Items
• Data Load Set ID: specify the lead Set ID so that when data is loaded into this set, the workflow that you
have configured is automatically triggered.
335
Workflow Customization
Workflow Customization
336
Workflow Customization
337
Workflow Customization
Post Recon
From the 2.4 release onwards, a new custom hook has been added to the Lifecycle Update processing that executes
on completing auto matching that will allow direct execution of the custom logic. In the 'REC AUTO Process
Workflow for Lifecycle SPACE' process in the Reconciliation Project, a new sub process call is made to 'CUS Post
Lifecycle Move To Reconciled' - a process in the Custom Project.
To migrate the processing all that is required is to call the final process originally created, and this must happen
inside the 'CUS Post Lifecycle Move To Reconciled' process. This can be done either by changing the original to
receive input parameters rather than a SmartMessage, or to write a message to the existing JMS queue if desired.
The same migration steps are required to move existing configuration defined by the 'POSTMATCH_PROCESS'
SYST record. The process must now be called via the Custom 'CUS Post Auto Match' process hook, which is
triggered on completion of any match initiation.
338
Configuring Drools
Configuring Drools
Drools are spreadsheets containing rules used by TLM Control to make complex decisions based on user provided
data. They can be seen as an alternative to using traditional database tables with dashboards. The disadvantage of
using drools is that they have to be edited on a Windows system; then uploaded to the application server on which
TLM Control is running, and then the application server must be restarted.
Part of the installation configuration for TLM Control is to specify the location of the drools files in the value of the
name/value pair on the properties table for name "rulesengine.ruleResource.home". The installer for version 2.0 or
later automatically populates this based on your input during the install process.
The following drools are currently used in TLM Reconciliations-Premium:
Name Description
AlertAllocationRules.xls Routes alerts to inboxes based on exception type, exception value, etc.
The ItemsAging drools spreadsheet is retired in 2.0 and replaced by the Admin->Enrichment options in the UI.
Pre-2.0 spreadsheets can be converted using a supplied convertor, drools2sql.exe. See the TLM Reconciliations-
Premium Installation Guide for details of the conversion process.
The columns in the spreadsheets are either blue, which denotes that they are for input parameters, or yellow, which
denotes the output, for example the resultant inbox. Blank columns indicate a "wild card", for example, you could
allocate exceptions to inboxes on the basis of the exception type alone, for cash or securities, without specifying the
account.
All rules are tied into TLM Control processes in the TLM Reconciliations-Premium configuration. You cannot add
arbitrary rules without code changes. You can however add as many rows in these spreadsheets as required.
339
Configuring Drools
InboxAllocationRules
Exception routing allows the system to route exceptions to inboxes based on account, category, exception type or
category, amount and business entity.
The following table describes the columns in the InboxAllocationRules.xls spreadsheet:
ExceptionType The lookup value of the exception type from exm_ref_exception_type. Input
340
Configuring Drools
AlertAllocationRules
Alert routing offers a powerful routing capability by exception type and value, with options to override the default
inbox contacts, and to suppress emails. Up to 3 inboxes can be defined, allowing multiple routing.
The following table describes the columns in the AlertAllocationRules.xls spreadsheet:
ExceptionType The lookup value of the exception type from exm_ref_exception_type. Input
Exception Value If set, the value on the exception has to exceed this value to pass the rule. Input
AlertExceptionInbox "N" or "Y" - whether to send the alert to the exception’s inbox. Output
NotifyExceptionInbox "N" or "Y" - whether to send the email notification to the exception’s inbox Output
owner.
Inbox1 The lookup value of the first inbox for alert routing. Output
OverrideContact1 Override inbox1’s owner with this contact (lookup value). Output
Inbox2 The lookup value of the 2nd inbox for alert routing. Output
OverrideContact2 Override inbox2’s owner with this contact (lookup value). Output
Inbox3 The lookup value of the 3rd inbox for alert routing. Output
OverrideContact3 Override inbox1’s owner with this contact (lookup value). Output
341
Appendix I – Attributes for generating outbound messages
This section provides a list of all available elements that can be used in creating a message template in
Reconciliation Premium.
Quick Link
• Exception, page 343
• Bank, page 344
• Business Unit, page 347
• Items, page 348
• Business Entity, page 353
• Lead Item, page 353
342
Appendix I – Attributes for generating outbound messages
343
Appendix I – Attributes for generating outbound messages
344
Appendix I – Attributes for generating outbound messages
345
Appendix I – Attributes for generating outbound messages
346
Appendix I – Attributes for generating outbound messages
347
Appendix I – Attributes for generating outbound messages
CorrAccNo $item.CorrAccNo
Gin $item.Gin
AccruedDays $item.AccruedDays
AgentCode $item.AgentCode
ReasonTypeId $item.ReasonTypeId
ResolutionTypeId $item.ResolutionTypeId
AuditId $item.AuditId
Alias1 $item.Alias1
Alias2 $item.Alias2
Alias3 $item.Alias3
Alias4 $item.Alias4
Amount $item.Amount
Amount10 $item.Amount10
Amount11 $item.Amount11
Amount12 $item.Amount12
Amount13 $item.Amount13
Amount14 $item.Amount14
Amount15 $item.Amount15
Amount16 $item.Amount16
Amount17 $item.Amount17
Amount18 $item.Amount18
Amount19 $item.Amount19
Amount2 $item.Amount2
Amount20 $item.Amount20
Amount21 $item.Amount21
Amount22 $item.Amount22
Amount23 $item.Amount23
Amount24 $item.Amount24
Amount25 $item.Amount25
Amount26 $item.Amount26
Amount27 $item.Amount27
Amount3 $item.Amount3
Amount4 $item.Amount4
Amount5 $item.Amount5
348
Appendix I – Attributes for generating outbound messages
349
Appendix I – Attributes for generating outbound messages
350
Appendix I – Attributes for generating outbound messages
351
Appendix I – Attributes for generating outbound messages
352
Appendix I – Attributes for generating outbound messages
353
Appendix I – Attributes for generating outbound messages
354
Appendix I – Attributes for generating outbound messages
355
Appendix I – Attributes for generating outbound messages
356
Appendix I – Attributes for generating outbound messages
357
Appendix I – Attributes for generating outbound messages
358
Software Support
Software Support
All information relating to SmartStream Technologies’ products can basically be found in the documentation
supplied with the product. If you are nevertheless unable to find the answer to your question in any of these
resources, contact SmartStream Technologies Support. Details are given below.
All STL products SmartStream Technologies Tel: +44 (0) 1454 888485
except Corona and 1690 Park Ave Fax: +44 (0) 1454 888503
Corona Web Aztec West E-mail: stl-support@smartstream-stp.com
Almondsbury
Bristol, BS32 4RA
UK
North and All STL products SmartStream Technologies Ltd Tel: +1 212 763 6500
South America 61 Broadway Tel (US internal):
Suite 710 877 215 8227
New York Fax: +1 212 763 6501
NY 10006 E-mail: stl-support@smartstream-stp.com
USA
Australia and All STL products SmartStream Technologies Ltd Tel: +65 6224 7689
Asia 70 Anson Road Fax: +65 6222 4039
26-01, Apex Tower E-mail: stl-support@smartstream-stp.com
Singapore
079905
Additional information
Additional SmartStream Technologies company information can be found at: www.smartstream-stp.com. In some
situations, you can find answers to your questions without calling STL Support, particularly if your issue relates to a
known product bug. By checking information sources such as the support customer zone at www.smartstream-
stp.com/customerzone, or customer support newsletters, you may find that there is already a suggested workaround
or a product update available to download and install.
Customers requiring a user ID/password for the customer zone, please contact the European Support Centre at
corona.support@smartstream-stp.com.
359
Software Support
Before you call, you should consult the checklist given below, to ensure that you have all relevant information at
hand.
For STL products that have a MDP (Minimum Defect Packaging) document defined, you need to provide and collate
all the supporting information outlined above. Failure to provide the complete information package will mean
investigation cannot commence and a support call will not be opened. These product MDP documents will be
supplied to you via email and updated periodically.
360