Kofax Communication Server 10.3.0 Technical Manual

Category
Database software
Type
Technical Manual
Kofax Communication Server
Message Broadcasting Server Processes Technical Manual
Version: 10.3.0
Date: 2019-12-13
©
2019 Kofax. All rights reserved.
Kofax is a trademark of Kofax, Inc., registered in the U.S. and/or other countries. All other trademarks
are the property of their respective owners. No part of this publication may be reproduced, stored, or
transmitted in any form without the prior written permission of Kofax.
Table of Contents
Chapter 1: Preface...................................................................................................................................... 5
Chapter 2: Structure of the Product......................................................................................................... 6
Queues................................................................................................................................................6
RESOLVE Queue.................................................................................................................... 7
INTERCEPT Queue.................................................................................................................7
OCRMF Queue........................................................................................................................ 7
NOTIF Queue.......................................................................................................................... 7
ROUTE Queue.........................................................................................................................7
Broadcasting Message Flow.............................................................................................................. 7
Job Request via Email.......................................................................................................... 10
Job Request via Fax (DTMF)................................................................................................11
Job Request via Fax (OCR Cover Sheet)............................................................................ 12
Job Request via Plain Fax.................................................................................................... 14
Error Handling via Error Notification..................................................................................... 16
Error Handling via Intercepting..............................................................................................17
Chapter 3: Functionality........................................................................................................................... 19
Restrictions....................................................................................................................................... 19
System Address Book Distribution Lists Not Supported....................................................... 19
Maximum Number of Recipients per Job..............................................................................19
UTF-8 TCOSS Restrictions (TCRESMF, TCNOTIF, TCOCRMF)..........................................19
Common Functionality for All Modes............................................................................................... 20
TCRESMF (Resolve Mode)..............................................................................................................21
Queues...................................................................................................................................21
Validation................................................................................................................................21
Address Syntax Validation.....................................................................................................22
Originator Lookup.................................................................................................................. 24
Distribution List Resolution.................................................................................................... 26
Broadcast PIN........................................................................................................................26
Send Options......................................................................................................................... 27
Job Posting............................................................................................................................ 28
Reference to Original Job Request.......................................................................................28
Option: Specify Job Recipients in CSV Attachment..............................................................29
Error Handling........................................................................................................................30
Performance...........................................................................................................................30
3
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
Notes...................................................................................................................................... 30
Special Registry Keys for TCRESMF................................................................................... 31
TCOCRMF (OCR Mode).................................................................................................................. 31
Queues...................................................................................................................................32
Address Recognition via OCR.............................................................................................. 32
Message Posting................................................................................................................... 33
Scalability............................................................................................................................... 33
Prerequisites.......................................................................................................................... 33
OCR Software........................................................................................................................34
OCR Recognition Error Notification Message.......................................................................34
Special Registry Keys for OCRMF Mode............................................................................. 34
TCNOTIF (Notify Mode)................................................................................................................... 35
Queues...................................................................................................................................35
Notifications (= Reports)........................................................................................................35
Logging Jobs to Short Term Archive.....................................................................................41
Resending of Failed Jobs......................................................................................................41
Cleanup.................................................................................................................................. 42
Supporting Additional Languages..........................................................................................43
Special Registry Keys for NOTIF.......................................................................................... 43
TCROUTE (Routing Mode).............................................................................................................. 43
Layout of the Routing Database........................................................................................... 43
Maintaining the Routing Database........................................................................................ 44
Routing Emails Between Instances of TC/LINK-SM............................................................. 46
Special Registry Keys for TCROUTE................................................................................... 49
Chapter 4: Prerequisites...........................................................................................................................50
Chapter 5: Installation.............................................................................................................................. 51
KCS Setup........................................................................................................................................ 51
Required TCOSS Configuration....................................................................................................... 57
Fax Channel Configuration....................................................................................................57
Message Broadcasting User Profiles.................................................................................... 59
Normal User Profiles (Sonera: CStream / FaxPlus)..............................................................61
Additional Setup for OCR Software................................................................................................. 61
TC/LINK-SM Configuration for Routing............................................................................................61
Special Settings for Large Distribution Lists.................................................................................... 62
TCRESMF and TCNOTIF......................................................................................................62
TCOSS................................................................................................................................... 63
TCREPORT Fetch Agent...................................................................................................... 64
KCS Archive...........................................................................................................................64
4
Chapter 1
Preface
This manual holds information about all new server processes needed for the message broadcasting
features (original name: SO #263 Sonera MultiFax Migration).
The main tasks of the Message Broadcasting Server processes are:
Creating broadcast jobs
Finding distribution list information in message broadcasting cover sheets
Creating notifications for broadcast jobs (job start, job end, job error)
Triggering send retries
Distributing emails received via TC/LINK-SM
Maintaining a lookup table used to find the TCOSS home servers for message broadcasting users
Important The Kofax Communication Server and its components formerly used the name
TOPCALL. Some screen shots and texts in this manual may still use the former name.
5
Chapter 2
Structure of the Product
All message broadcasting server processes consist of a common executable file TCRESOLVE.EXE and a
configurable DLL.
TCRESOLVE.EXE polls a TCOSS queue for send orders. Every send order is handed over to the DLL
(configurable in registry) for processing. Afterwards, TCRESOLVE.EXE terminates the original send order,
or sets it to status “at next node”. This means that the functionality of the process depends on the DLL.
At the moment, the specific DLL used for message processing can be one of the following:
TCRESMF.DLL (creating broadcast jobs)
TCOCRMF.DLL (evaluating broadcast cover sheets)
TCNOTIF.DLL (creating broadcast notifications and send retries)
TCROUTE.DLL (routing email messages, maintaining lookup table)
In this document, the name of the DLL is used as the name of the server process (TCRESMF, TCOCRMF,
TCNOTIF, TCROUTE).
Queues
The Message Broadcasting Server processes use the following TCOSS queues:
6
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
RESOLVE Queue
All message broadcasting job requests (received via fax, email or via any other link type) are routed to this
queue. This may be done via special link map files, rr99, an operator in TCFW or by TCOCRMF.
The RESOLVE queue is polled by TCRESMF.
Every TCOSS instance that may receive job requests must have a RESOLVE queue that is polled by an
instance of TCRESMF.
INTERCEPT Queue
This queue holds job requests that must be processed by an operator.
Several server modules may post messages to this queue: Job requests needing manual correction are
posted by TCRESMF and TCOCRMF, job resend requests are posted by TCNOTIF.
The INTERCEPT queue is polled by TCFW (Intercept window), the messages must be processed by an
operator.
OCRMF Queue
This queue is needed for job requests via message broadcasting cover sheets. Incoming faxes without
DTMF information are routed to this queue via rr99 and channel configuration.
The OCRMF queue is polled by TCOCRMF.
NOTIF Queue
This queue is written by TCOSS event handling (job start, job end, job cancel) and by TCRESMF (error
events).
The NOTIF queue is polled by TCNOTIF.
ROUTE Queue
This queue is only needed if messages received via TC/LINK-SM must be distributed to several TCOSS
instances.
A central instance of TC/LINK-SM forwards incoming emails to this queue. The queue is polled by
TCROUTE.
Broadcasting Message Flow
General Message Flow
A job is triggered by a job request (incoming fax or email). The job request is evaluated and validated.
This may involve several applications and intermediate messages, especially if OCR cover sheet
7
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
detection or manual correction (Intercept workplace) is needed. It may be necessary to forward the job
request to another TCOSS instance, if the local TCOSS instance does not hold the user profile of the job
request originator.
Finally, the real job (mass send order) is created and the message is sent to its real recipients. The job
send orders can be monitored in the TCFW Job Monitoring window.
When all job send orders have been terminated, a job end notification is returned to the originator. If
the job included unsuccessful send orders that were not cancelled by an operator, their recipients are
collected into a temporary distribution list, and a job retry request referencing this distribution list is sent to
the Intercept queue. This means that jobs are retried until all recipients have been reached or until the job
is cancelled by an operator. For every job retry, a job start and job end notification is created.
This resend feature can be disabled by a flag in the Message Broadcasting user’s profile.
For simplicity, the message flow diagrams below do not contain job retries and forwarding to remote
TCOSS instances.
Job request
The original send order triggering the job is kept at state “at next node” until the job is either completely
over (including job retries) or is cancelled by an operator. All intermediate messages and all job send
orders contain a reference to the job request (TS_CORREL_1: TS_TC_MSG_ID, TS_CORREL_2:
INT_CIF_ID + INT_CIF_NR). Thus, the job request can be viewed from the Job Monitoring folder.
The job request send order is terminated by TCNOTIF.
Message in Intercept queue
The Intercept queue contains job requests that must be controlled by an operator. These may be new job
requests with invalid or missing parameters, or job retries. Messages are posted to the Intercept queue by
several server applications (TCRESMF, TCOCRMF, TCNOTIF). Although the message syntax is the same
as a job request, the message is an intermediate message, not the original job request.
Message content:
Originator = NOTIF queue
Originator freetext: real originator of the job request (full name, service, number)
Recipient = INTERCEPT queue + destination address including user ID and distribution list numbers
(SMTP or DTMF syntax)
Recipient TS_CORREL_1: TS_TC_MSG_ID of original job request
Recipient TS_CORREL_2: INT_CIF_ID, INT_CIF_NR (2 * 8 hex digits) of original job request
Recipient TS_CORREL_3: name of temporary DL (for resend)
TS_CORREL_2 – originator of the job request (set by TCRESMF or TCOCRMF). When the job has been
submitted via FAX, then it contains the fax number of the caller.
TS_LAST_MDA_ACTION: Contains the reason why the request is sent to the Intercept queue
(e.g. “Job Retry”, “Duplicate sending suspected”, “Invalid address”, …)
8
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
Additional content for job retries:
TS_ENV_NAME_POSTED: For job retries, this field contains the job id of the original job. Otherwise, it is
“-----”.
First text block:
The first element in the message body is a text block listing the send orders that failed in the previous
send attempt. This information can be used to look up and correct addresses in the temporary distribution
list (and also in the real DL). There is 1 line per recipient, containing the destination address and the error
reason.
The operator must remove this text block before posting the job to the Resolve queue.
Distribution lists:
With job retries, the recipient address refers to a temporary distribution list (INT_STATUS =
TEMPORARY_DL, distribution list id starts with ‘T’).
Correcting a job request:
When correcting a job request, the operator can modify the destination address and the content of the
request.
The destination address must use the RESOLVE queue instead of the INTERCEPT queue. The rest of the
address must be in SMTP or DTMF syntax, specifying at least the user id and 1 distribution list.
The operator can correct end recipient addresses in the distribution lists.
Canceling a job request:
The operator can cancel the job request in the Intercept queue. As the message originator is the NOTIF
queue, a non-delivery notification event is created for the NOTIF user. This event message is picked up by
TCNOTIF and is used to terminate the original job request and any temporary distribution list involved in
the job.
Job send order
The real job send orders are visible in the TCFW Job Monitoring folder. They contain the following
references:
Recipient TS_CORREL_1: TS_TC_MSG_ID of original job request
Recipient TS_CORREL_2: INT_CIF_ID, INT_CIF_NR of original job request
TS_ENV_NAME_POSTED: Job id of original job (for job retries only)
9
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
Job Request via Email
1. Customer posts a job via email.
2. The email is routed to the RESOLVE queue (R ) via a custom TC/LINK map file.
3. TCRESMF picks up the email from the RESOLVE queue. Validation and distribution list resolution is
done.
4. TCRESMF creates the job send orders (to multiple fax numbers) and sets the original email message
to status AT NEXT NODE.
5. The fax module processes the individual send orders of the job.
6. TCOSS creates a job start event. According to the user profile settings, the job start event is sent to
the NOTIF queue (N ).
7. TCNOTIF picks up the event message, and creates the real job start notification (including statistic
data).
8. TCNOTIF posts the job start notification to TCOSS and terminates the job start event.
9. The job start notification is sent out via TC/LINK.
10. When all job send orders have been terminated, TCOSS creates a job end event. The job end event
is sent to the NOTIF queue (N ).
10
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
11. TCNOTIF picks up the event message and creates the real job end notification (including statistic
data).
12. TCNOTIF posts the job end notification to TCOSS and terminates the job end event. The original job
request is terminated also.
13. The job end notification is sent out via TC/LINK.
Job Request via Fax (DTMF)
1. Customer posts a job via fax, specifying recipient DLs via DTMF input.
2. The fax is routed to the RESOLVE queue (R ) via fax channel configuration.
3. TCRESMF picks up the email from the RESOLVE queue. Validation and distribution list resolution is
done.
4. TCRESMF creates the job send orders (to multiple fax numbers) and sets the original fax message
to status AT NEXT NODE.
5. The fax module processes the individual send orders of the job.
6. TCOSS creates a job start event. According to the user profile settings, the job start event is sent to
the NOTIF queue (N ).
7. TCNOTIF picks up the event message, and creates the real job start notification (including statistic
data).
11
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
8. TCNOTIF posts the job start notification to TCOSS and terminates the job start event.
9. The job start notification is sent out, e.g. via fax.
10. When all job send orders have been terminated, TCOSS creates a job end event. The job end event
is sent to the NOTIF queue (N ).
11. TCNOTIF picks up the event message and creates the real job end notification (including statistic
data).
12. TCNOTIF posts the job end notification to TCOSS and terminates the job end event. The original job
request (fax message) is terminated also.
13. The job end notification is sent out, e.g. via fax.
Job Request via Fax (OCR Cover Sheet)
1. Customer posts a job via fax, specifying recipient DLs on cover sheet.
2. The fax is routed to the OCRMF queue (R ) via fax channel configuration or rr99.
3. TCOCRMF picks up the message from the OCRMF queue (O ). A third party OCR system is used to
recognize the cover sheet data.
4. TCOCRMF creates fax with error notification when OCR recognition fails
5. TCOCRMF forwards the message (including data from OCR recognition) to the RESOLVE queue, -
and sets the original fax message to status AT NEXT NODE.
12
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
6. TCRESMF picks up the message from the RESOLVE queue (R ).
7. TCRESMF performs validation and distribution list resolution.
8. TCRESMF creates the job send orders (to multiple fax numbers) and terminates the original email
message.
9. The fax module processes the individual send orders of the job.
10. TCOSS creates a job start event. According to the user profile settings, the job start event is sent to
the NOTIF queue (N ).
11. TCNOTIF picks up the event message, and creates the real job start notification (including statistic
data).
12. TCNOTIF posts the job start notification to TCOSS and terminates the job start event.
13. The job start notification is sent out, e.g. via fax.
14. When all job send orders have been terminated, TCOSS creates a job end event. The job end event
is sent to the NOTIF queue (N ).
15. TCNOTIF picks up the event message and creates the real job end notification (including statistic
data).
16. TCNOTIF posts the job end notification to TCOSS and terminates the job end event. The original fax
message is terminated also.
17. The job end notification is sent out, e.g. via fax.
13
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
Job Request via Plain Fax
1. Customer posts a job via fax (no cover sheet, no DTMF input)
2. The fax is routed to the OCRMF queue (O ) via fax channel configuration or rr99.
3. TCOCRMF picks up the message from the OCRMF queue (O ). A third party OCR system is used to
recognize the cover sheet data.
4. As no cover sheet information can be retrieved, TCOCRMF forwards the message to the
INTERCEPT queue, - and sets the original fax message to status AT NEXT NODE. If configured,
TCOCRMF creates a Fax with error notification.
5. An operator using the TCFW Job Status window opens the message.
6. The operator corrects the job (inserts user ID, DL numbers etc).
7. The operator forwards the corrected message to the RESOLVE queue, the intermediate message in
the INTERCEPT queue is terminated.
8. TCRESMF picks up the message from the RESOLVE queue (R ).
9. TCRESMF performs validation and distribution list resolution.
14
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
10. TCRESMF creates the job send orders (to multiple fax numbers), the intermediate message in the
RESOLVE queue is terminated.
11. The fax module processes the individual send orders of the job.
12. TCOSS creates a job start event. According to the user profile settings, the job start event is sent to
the NOTIF queue (N ).
13. TCNOTIF picks up the event message, and creates the real job start notification (including statistic
data).
14. TCNOTIF posts the job start notification to TCOSS and terminates the job start event.
15. The job start notification is sent out, e.g. via fax.
16. When all job send orders have been terminated, TCOSS creates a job end event. The job end event
is sent to the NOTIF queue (N ).
17. TCNOTIF picks up the event message and creates the real job end notification (including statistic
data).
18. TCNOTIF posts the job end notification to TCOSS and terminates the job end event. The original fax
message is terminated also.
19. The job end notification is sent out, e.g. via fax.
15
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
Error Handling via Error Notification
1. Customer posts a job via fax, specifying recipient DLs via DTMF input.
2. The fax is routed to the RESOLVE queue (R ) via fax channel configuration.
3. TCRESMF picks up the email from the RESOLVE queue. Validation and distribution list resolution is
done. Validation fails, e.g. wrong distribution list numbers specified.
4. TCRESMF sends a message to the NOTIF queue and sets the original fax message to status AT
NEXT NODE.
5. TCNOTIF picks up the message,
6. creates the real job error notification.
7. TCNOTIF posts the job error notification to TCOSS and terminates the message in the NOTIF
queue. The original fax message is terminated also.
8. The job error notification is sent out, e.g. via fax.
16
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
Error Handling via Intercepting
1. Customer posts a job via fax, specifying recipient DLs via DTMF input.
2. The fax is routed to the RESOLVE queue (R ) via fax channel configuration.
3. TCRESMF picks up the email from the RESOLVE queue. Validation and distribution list resolution is
done. Validation fails, e.g. wrong distribution list numbers.
4. TCRESMF forwards the message to the INTERCEPT queue and sets the message in the RESOLVE
queue to status AT NEXT NODE.
5. An operator picks up the message from the INTERCEPT queue.
6. The operator corrects the job request.
7. The operator posts the corrected job request to the RESOLVE queue, the message in the
INTERCEPT queue is terminated negatively.
8. TCRESMF picks up message from RESOLVE queue.
9. Validation and distribution list resolution succeeds.
17
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
10. TCRESMF creates the job send orders (to multiple fax numbers) and terminates the original fax
message.
11. The fax module processes the individual send orders of the job.
12. TCOSS creates a job start event. According to the user profile settings, the job start event is sent to
the NOTIF queue (N ).
13. TCNOTIF picks up the event message, and creates the real job start notification (including statistic
data).
14. TCNOTIF posts the job start notification to TCOSS and terminates the job start event.
15. The job start notification is sent out, e.g. via fax.
16. When all job send orders have been terminated, TCOSS creates a job end event. The job end event
is sent to the NOTIF queue (N ).
17. TCNOTIF picks up the event message and creates the real job end notification (including statistic
data).
18. TCNOTIF posts the job end notification to TCOSS and terminates the job end event. The original fax
message is terminated also.
19. The job end notification is sent out, e.g. via fax.
18
Chapter 3
Functionality
This section describes the functionality of TC/Broadcast.
Restrictions
This section describes the restrictions of TC/Broadcast.
System Address Book Distribution Lists Not Supported
Distribution lists stored in the system address book cannot be used with TC/Broadcast. Therefore, the TC/
Broadcast properties in the TCfW and TC/Web are disabled and info will be displayed.
Maximum Number of Recipients per Job
TC/Broadcast supports a maximum of 30000 recipients per job.
The server applications TCRESMF and TCNOTIF (see below) can only handle 30000 job recipients at
a single time. As these applications can be connected to several TCOSS instances at the same time,
this limit can be reached also with smaller jobs, if the number of recipients per job is higher than 30000 /
<number of TCOSS instances polled>.
For ASP installations with big distribution lists, it is therefore recommended to use dedicated TCRESMF
and TCNOTIF instances for every TCOSS instance.
UTF-8 TCOSS Restrictions (TCRESMF, TCNOTIF, TCOCRMF)
TC/Broadcast does not support UTF-8 based TCOSS instances without legacy code page.
UTF-8 based TCOSS instances with a legacy code page are supported with the following restrictions:
The product can only handle texts that are part of the local PC code page (as configured in registry value
General\CodePage).
Users with IDs that cannot displayed in the local PC code page should never be given Broadcast
permissions. TCRESMF is not able to lookup these users in the TCOSS recipient store, and therefore
discards all job requests sent by them.
Distribution lists IDs and recipient IDs must also match the local PC code page, otherwise the send orders
will fail and show up in the Problems folder (if configured).
19
Kofax Communication Server Message Broadcasting Server Processes Technical Manual
Common Functionality for All Modes
Queue polling on multiple TCOSS instances
TCRESOLVE.EXE can work with multiple TCOSS instances. The registry subkeys Server1, Server2,
Server3, etc. below the main process subkey hold information how to access the individual TCOSS
instances: server name, path, user id, password, name of queue to poll.
TCRESOLVE.EXE creates a thread for every TCOSS instance. The thread polls the configured TCOSS
queue for new send orders (1 send order at a time).The “open for sending” mechanism is used, so that a
message processed by 1 instance of the program is invisible for all other instances.
Every send order is passed to the configured DLL (function ProcessMessage). The DLL processes the
message, which means basically that 1 or more other send orders are created. After message processing,
the original send order’s state is changed (either terminated or AT NEXT NODE).
Scalability
TCRESOLVE.EXE can be installed multiple times (fault tolerance) on multiple machines (scalability). It is
supported on any Windows Server 2008 – 2012 compatible hardware including Storage, Link and Media
server.
Common Configuration Settings
The name of the main registry subkey depends on the run mode. Default registry keys:
Process Registry key
TCRESMF HKLM\Software\TOPCALL\TCRESMF
TCOCRMF HKLM\Software\TOPCALL\TCOCRMF
TCNOTIF HKLM\Software\TOPCALL\TCNOTIF
TCROUTE HKLM\Software\TOPCALL\TCROUTE
TCRESOLVE.EXE expects the name of the registry subkey as a command line parameter. The DLL name
is stored in the registry.
Registry key Type Default Description
TraceLevel DWORD 0 Bit field
0: trace errors only
Bit 0x80 set: trace function calls
Bit 0x100 set: trace TCSI messages
CommandLine SZ command line for TCSRV
LogonType SZ Batch
MaxTraceFiles DWORD 2 maximum number of trace files
MaxTraceFileSize DWORD 0x3e8 maximum trace file size
General\CodePage DWORD 1252 PC code page
General\Dll SZ DLL name
20
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65

Kofax Communication Server 10.3.0 Technical Manual

Category
Database software
Type
Technical Manual

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI