TP 820803
TP 820803
TP 820803
Document History
Copyright protection is claimed for each revision listed in the document history, as of the date indicated.
Any trademarks, service marks, product names or company names not owned by Diebold that appear in this
document are used for informational purposes only and Diebold claims no rights thereto, nor does such use indicate
any affiliation with or any endorsement of Diebold or Diebold products by the owners thereof.
This document contains proprietary information. If the document pages state the information is confidential
(or words of similar import), then this document is intended solely for the use of the copyright owner’s
employees or other personnel expressly authorized in writing by the copyright owner. Other uses of this
information without the express written consent of the copyright owner are prohibited. This document should
be treated as confidential material for security reasons. Any unauthorized disclosure or use of confidential
material may violate Section 1832 of Title 18 of the United States Code as well as other laws, and may be
punishable by fine and imprisonment.
The information contained in this document is subject to change without notice. When using the document for system
implementation, please call your authorized sales or service representative for any applicable changes.
This document and the information contained herein are provided AS IS AND WITHOUT WARRANTY. In
no event shall the copyright owner or its suppliers be liable for any special, indirect, or consequential damages
of any nature resulting from the use of information in this manual.
No part of this document may be reproduced, stored in a retrieval system, or transmitted, in any form or by any
means: electronic, mechanical, photocopying, recording, or otherwise, without prior written permission from the
copyright owner.
Your use of this document and/or any of the inform ation contained herein constitutes your agreement to all of the
terms stated on this page.
ii
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Contents
iii
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Contents
Appendix F Required Agilis 91x System Settings for Agilis NDx . . . . . . . . . . . . . . . . . . . . . . F-1
Figures
Figure 4-1 Agilis 91x NDx Configurator for Diebold ix and Foreign Terminals . . . . . . . . . . . . . . 4-2
Figure 4-2 Agilis 91x NDx Configurator for Opteva Terminals . . . . . . . . . . . . . . . . . . . . . . 4-3
Figure 4-3 Agilis NDx Configuration Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Figure 4-4 Clear Static Data Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Figure 4-5 Agilis NDx General Settings Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Figure 4-6 NDC Host Component Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Figure 4-7 Diebold Write Command III Component Screen . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Figure 4-8 Local Control Component Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Figure 4-9 Transaction Request Component Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
Figure 4-10 Function Command Component Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Figure 4-11 Operation Command Component Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Figure 4-12 Default Touch Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
Figure 4-13 Doc Enable Code Mapping Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33
iv
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Tables
v
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Section 1
Purpose and Scope
This manual describes the Agilis NDx™ Configuration Guide and gives
instructions for installing and configuring the application. Refer to Section 2 for
an overview of the Agilis NDx Configuration application. Refer to Section 3
for setup and installation procedures, and refer to Section 4 for configuration
instructions.
The Agilis NDx™ product requires the following software and hardware for
different Windows operating systems, as follows:
For an overview and for more information on the Agilis NDx™ application
product, refer to Agilis NDx™ Product Description (TP-820802-001B).
1-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Section 2
Overview
Terminal Hardware/Software
The Agilis NDx product can be installed on different operating systems, as
well as hardware, as follows.
The Agilis NDx product coexists with the Agilis 91x terminal software and can
be enabled by the terminal Administrator.
Overview
The Agilis NDx application, enables the terminal in an NCR Direct Connect or
NCR Director Connect+ (NDC or NDC+) network. The Agilis NDx application
allows the Diebold, NCR, or foreign vendor terminal to work in the NDC or
NDC+ network with no modifications to the host terminal driver application.
Product Attributes
The Agilis NDx product consists of the following attributes:
• Communicates with the Agilis 91x system terminal and the NDC/NDC+ host
driver. Refer to Appendix A for information on these transaction messages.
The Agilis NDx Configuration application operates with the following minimum
hardware for the Agilis 91x software package and must coexist with the following
standard ATM hardware devices. Listed are those hardware components
supported and not supported for the Agilis NDx Configuration application.
2-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The following table displays the full scope of functional devices for the Agilis
NDx product that may or may not be supported.
2-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
2-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
• Lead Thru programming color capability Sensors (Red, Yellow, and Green
notification sensors)
• Writable CD-ROM
Any ATM hardware device not listed above is assumed not supported with
the Agilis NDx application.
NOTE
• Chinese
• Polish
• Russian
• Turkish
The Agilis NDx application does not support the following ATM hardware
devices:
2-4
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Agilis NDx application requires the following software products for proper
operation of this product.
2-5
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
NOTE
Mayfair Software
The Mayfair software consists of foreign vendor required applications. Contact
your Diebold Service Representative to request more information on these
applications.
NOTE
2-6
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
2.3 Terminology
The following table defines the terms, acronyms, and abbreviations used in
this document.
Term Definition
91x A true 911 or 912 network infrastructure
ABC Agilis Base Communications (Subsystem)
Agilis A Diebold software environment for Diebold and foreign vendor ATMs
AMI Acronym for Diebold’s Agilis Module Interface; name of components that form the lowest level
device software interface on the Opteva Terminal product family
ATM Automated Teller Machine
CSS Communication Subsystem
DIT Device Initialization Table
EDC The Electronic Data Capture application allows the terminal to store information which is
traditionally sent to the Journal Printer. This data can include transaction data, terminal statuses,
printer diagnostics, and cassette counters.
EMS A User Exit that sends copies of ATM status and event messages directly from an ATM to the
Diebold EMS (Event Management System) Server.
iq CRM Iq Customer Relationship Management
iq ESD Iq Electronic Software Distribution
LSC The LSC (Local Screen Changes) is a User Exit application that can save network download data,
load the terminal from the saved network download data, and load additional custom configuration
data. This essentially allows screen overrides and states. Therefore, the LSC (Local Screen
Change) application is used to locally load customized screens.
MAC Message Authentication Code (MAC 2.0.0) is a terminal application that prevents unauthorized
tampering with messages between an automated teller machine (ATM) and a network. MAC 2.0.0
is a terminal applet and does not require SXA to run.
2-7
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Term Definition
Mayfair Mayfair is a suite of applications that extend the functionality of the Agilis 91x system and NDx
Software software and its components.
2-8
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
2.4 Documentation
2-9
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Section 3
Setup and Installation
The following paragraphs describe the required setup and installation files and
procedures necessary for correct operation of the Agilis NDx application.
Setup files for the Agilis NDx application reside on a CD-ROM and can be used
at any time after the installation of the Agilis 91x terminal software package.
Set up files for the Agilis NDx application reside on the Agilis NDx Application
Suite CD-ROM. Agilis NDx Application Suite can be installed at any time after
the installation of the following software packages:
Set up files for the Agilis NDx application reside on a CD-ROM and can be used
at any time after the installation of the Agilis 91x terminal software package.
After the Setup installation, a log file is created to keep track of main operations
and installation errors. This file is called AgilisNDx.log and is located in the
C:\Diebold\ACO2 directory.
3-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The following files reside in their designated directories after setup completes.
Directory C:\Diebold\ACO2
ACO2PData.exe
AgilisNDx.log
readme.txt
Directory C:\Diebold\ACO2\data
ACO2CFG.xml
ACO2CFG.xsd
CardCash.xml
CardCash.xsd
FuncID.xml
FuncID.xsd
IDMDEC.xml
IDMDEC.xsd
KeyCodes.xml
KeyCodes.xsd
Logo.xml
Logo.xsd
NDCStat.xml
NDCStat.xsd
Picture.xml
Picture.xsd
PrintDat.xml
PrintDat,xsd
ReservedScrnNumList.xml
ReservedScrnNumList.xsd
RRCTrans.xml
RRCTrans.xsd
ScreenNum.xml
ScreenNum.xsd
ScrnSq.xml
ScrnSq.xsl
tch_def.xml
tch_def.xsd
TimerNum.xml
TimerNum.xsd
TimerVal.xml
TimerVal.xsd
Voice.xml
Voice.xsd
Directory C:\Diebold\ACO2\dll
ACO2Trns.dll
ACO2UEJ.dll
ACO2Util.dll
LangCode.dll
Directory C:\Diebold\ACO2\Logs
This directory will remain empty until an
application log file is created.
Directory C:\Diebold\TCS\App
ScrnCtrl.adt
ScrnCtrl.dll
ScrnRef.adt
ScrnRef.dll
3-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
StXlate.adt
StXlate.dll
Directory C:\Diebold\Web\Scripts
ACO2.pm
ACO2Config.pl
To uninstall the NDx application, you must use the system registry and delete the
designated keys. You can then remove the application from the Windows NT or
Windows XPe operating system. Refer to Appendix E for a complete listing
of the configuration registry and the keys and files which must be deleted to
remove the Agilis NDx application.
You can NOT use the Windows Control Panel to uninstall the Agilis
NDx application.
3-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Section 4
Manual Configuration
The following sections provide required manual configuration information for the
Agilis NDx application through the Windows NT or the Windows XPe (Agilis
91x) terminal application desktop, after you have installed the NDx application.
The Agilis NDx application is part of the Agilis 91x software package, but is
installed separately from the Agilis 91x terminal software system.
Because the Agilis 91x software package and the Agilis NDx application
requires that necessary parameters be set in order for the Agilis NDx application
to run properly, the following sections offer instructions on these required and
user-configurable settings, as follows:
The Agilis NDx Configurator provides configuration access for the Agilis
NDx application using a web-based interface. The following sections provide
instructions for activating and configuring the Agilis NDx application on the
Agilis 91x terminal system.
The following sections list the required Agilis settings necessary before the
Agilis NDx application can run successfully.
Before using the Agilis NDx Configurator correctly, it is necessary that Internet
Explorer’s settings be changed in the following steps.
2. From the General tab, click the Settings option. (You can also access
these settings by launching Internet Explorer, selecting the Tools option
and then clicking on the Internet Options selection.)
4. Select OK.
4-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The following sections cover accessing the NDx Configurator for the following
ATM terminals:
2. Select the Agilis 91x NDx option and then select the Agilis 91x NDx
Configurator, as shown in Figure 4-1.
G5371_004
Figure 4-1 Agilis 91x NDx Configurator for Diebold ix and Foreign Terminals
Refer to Figure 4-3 for the resulting screen that appears after following these
steps.
To access the NDx Configurator on Diebold Opteva terminals, follow these steps.
4-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_004A
G5371_004B
Refer to Figure 4-3 for the resulting screen that appears after following these
steps.
4-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Agilis 91x required settings are either automatically set by default parameters
when the Agilis NDx application is enabled, or can be user-configured, as
listed in the following paragraphs. For more information, refer to Appendix F
of this manual.
• Presenter action after customer timeout feature should be set to the Retain
and do not report status (default). However, this is only applicable when
the No Retract feature under the Local Control option (General
Settings) is turned OFF.
NOTE
4-4
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
User-configurable Settings
The following lists the settings and options the user can configure for the Agilis
NDx application :
• Ability to choose NCR’s default background and foreground color for screen
display as an alternate selection. This configuration applies to VGA Plus
(high and low resolution) video emulation mode only.
NOTE
The configuration of the Agilis NDx application is available only through the use
of the Agilis NDx Configurator, shown in Figure 4-3.
NOTE
4-5
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_005
There are 6 groups that comprise the Agilis NDx application configuration,
as follows:
4-6
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Clear Static Data selection clears ALL static data being used by the Agilis
NDx application being saved between power fails. Refer to Figure 4-4.
G5371_001
It is necessary that the Agilis NDx application store the following entries and
persist them through powerfails in order to emulate entries persisted by NCR
terminals.
However, the following static data items, taken from the above listing, are read
again from the main Agilis NDx configuration whenever a powerfail message
is received by the Agilis NDx application . The value of these items can then
be modified by the network load.
4-7
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The remaining static data items, listed below, are persisted by the Agilis NDx
application through powerfails. To reconfigure these values and to clear the entire
list of persistent data items, select the OK button on the Clear Static Data screen.
Figure 4-5 displays the Agilis NDx application General Settings configuration
screen, consisting of 8 configurable components, briefly detailed in the following
subsections:
• NDC Host
• Write Command III
• Local Control
• Transaction Request
• Function Command
• Operational Command
• IDM Settings
• Tracing
4-8
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_002
4-9
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
• The Description field describes the Agilis NDx setting for a particular
parameter.
• The Current Value field represents the default or changed value for that
setting.
• The New Value field contains a drop-down menu box or a blank user-entry
box (end-user can insert alternative information) of values that can replace
the current value.
The end user can select the type of host emulation type that will be used,
as follows:
• NDC
• NDC+
G5371_002A
The Diebold Write Command III screen contains various settings for the Diebold
Write Command III message translation being sent to the Agilis system.
Possible selections display in the drop-down boxes. Table 4-1, Table 4-2, and
Table 4-3 details default and optional selections for each message translation,
as shown in the following screen.
4-10
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_002B
4-11
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Yes or No
4-12
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Local Control screen contains configurable values that can affect the
behavior of the emulated NDC terminal.
G5371_002D1
NOTE
The @ represents an
unmapped cassette.
4-13
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Transaction Request screen contains the following setting for the Transaction
Request message translation that is sent to the NDC host. If this parameter is
turned on, the last transaction status data will be appended to every outgoing
NDC+ transaction request message sent to the Host.
G5371_002E
The Function Command screen contains various settings for the Function
Command message translation that is sent to the Agilis 91x system.
4-14
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_002F
The Operational Command screen contains various settings for the Operational
Command message translation that is sent to Agilis 91x system.
G5371_002G
4-15
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
These parameters provide additional out of service screens that can be displayed
instead of the default Out-Of-Service screen. These are only used when a
Shutdown command is received containing an additional command modifier.
The IDM Settings screen, as shown below, contains various settings for the IDM
device translation that is sent to the Agilis 91x system.
G5371_002H
The following settings for this screen are explained in the following paragraphs.
Pocket Destination
The Pocket Destination parameter specifies where to deposit the document
currently present, into the IDM device. This parameter is used when the host
requires depositing the document being processed by the IDM, to the locally
configured bin.
The Pocket Destination parameter ranges can be from the character values of ’0’
through ’3’. The values for these ranges are, as follows:
4-16
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Lift Image
The Lift Image parameter is used when the Host lifts the rear image for archive
and/or display. The IDM device is able to capture only the front image.
Therefore, this parameter allows the Agilis NDx application to change the
request ‘lift rear image’ to ‘lift front image’, otherwise the message is rejected.
The Lift Image parameter ranges can be from the character values of ’0’ through
’3’. The default value is ’1’. The values for these ranges are, as follows:
For more information on the LSC application, refer to the Local Screen Changes
(LSC) Version 2.0.0 Operating Guide (TP-820594-001A).
4.4.2.8 Tracing
Turning the Tracing feature on produces additional Agilis NDx trace files
that are stored in the \Diebold\aco2\logs folder. This feature also allows for
addition troubleshooting.
• Product Class
• Card Reader
• Cash Handler
• Depository
• Receipt Printer
• Journal Printer
• Night Safe Depository
• Encryptor
• Security Camera
• Door Access
4-17
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
• Flex Disk
• Tamper Indicating Bins
• Cardholder Keyboard
• Operator Keyboard
• Cardholder Display
• Statement Printer
• Signage Display
• Coin Dispenser
• System Display
• Media Entry Indicators
• Envelope Dispenser
• Document Processing Module
• CDM Tamper Indication
• DPM Tamper Indication
• Digital Audio Service
The following 3 screens are all part of one Hardware Configuration screen.
4-18
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
g5371_024
4-19
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
g5371_024a
4-20
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
g5371_024b
The following table lists every device, defining if the configuration is overridden
by the Agilis 91x system message (Programmatic), or taken from this file
(Configuration).
4-21
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Tamper Configuration -
Indicating Bins
Cardholder Configuration -
Keyboard
Operator Configuration -
Keyboard
Cardholder Programmatic BIT 2 - Voice not supported
Display / Voice BIT 2 1 - Voice supported if digital audio
present
BIT 3 0 - Standard FDKs
BIT 3 1 - Touch screen
Statement Programmatic 00 Not configured
Printer 01 Configured
Signage Display Configuration -
4-22
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Sensors Status selection displays initial device sensors information for all
SST devices. This configuration is used for initial sensors status configuration of
the terminal. Agilis NDx automatically updates these values when it receives
status information from Agilis 91x system indicating changes in sensor statuses
for these devices. A sample screen follows.
G5371_025
New Value options available can be Active or Inactive, and In or Out which
determines the initial state of the device.
4-23
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Supplies Status selection displays initial supplies status information for all
SST devices. This configuration is used for initial supplies status configuration
of the terminal. Agilis NDx automatically updates these values when it receives
supplies status information for Agilis 91x system indicating changes in the
supplies statuses for these devices.
G5371_026
• 0 - Not Configured
• 1 - Good State
• 2 - Media Low
• 3 - Media Out
• 4 - Overfill
4.4.6 Translations
4-24
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
NOTE
Although some screens may vary, there are three optional buttons available for
most of the Translations screens, as follows.
Add
Allows for additional user-entry parameters and values.
Delete
Eliminates currently selected parameters or values from the current screen.
Modify
Changes currently selected parameters or values.
The Card Before Cash Screens example screen selection, as shown below, is
normally empty by default. The screen displays the association between an
NDC Card Before Cash screen number to Diebold Card Before Cash screens. If
this selection is not being used, the file can be left empty. All information is used
while converting the screen number in an NCR Transaction Message Reply to
screen numbers in the Diebold Function command message.
A single NDC+ Card Before Cash screen, containing overlays, can be mapped
to two separate Diebold screens, which are used in the translated function
command sent to Agilis 91x system.
G5371_006
To create values for this function, select the Add button. An example Add
screen follows.
4-25
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_006A
NOTE
NCR has a default touch template that it associates with screens that do not
have an explicitly defined touch template. This file specifies the layout of this
default touch template. The Default Touch Template selection allows you to
define as many touch areas as needed. Each touch area is defined by the X and Y
coordinates of its opposite corners and the associate Key code. A default NCR
touch template definition already exists in this file. This layout should be
defined in Diebold format.
G5371_007
NOTE
Add Values
After selecting the Add button in Figure 4-12, the following screen appears.
4-26
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_007A
New values can be inserted into each Value field. Select OK to accept values
and return to the previous screen. Select Cancel to return to the previous screen
without adding any values.
Delete Values
After selecting the first parameter line (A) of information and then selecting
the Delete button in Figure 4-12, the first line (A) is removed. A new screen
appears with the remaining values.
G5371_007C
Modify Values
After selecting the A parameter and then the Modify button in Figure 4-12, the
following screen appears.
G5371_007D
All values in the screen can be changed or modified. To keep new changes, select
the OK button. To cancel changes and return to the previous screen, select
the Cancel button.
4-27
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Diebold Reserved Screens file contains the list of Diebold screen numbers,
the content of which does not have to be translated. A valid screen number in
this file would be 3 characters long and can range from 000 to 999 and A00 to
AZZ. All Diebold screen numbers which do not need to be translated, must
be included in this file. Refer to the Agilis NDx Reserved Screen Numbers
main screen below.
G5371_008
The following screen displays the Add option display selected from the Reserved
Screen Numbers screen.
G5371_008A
Selecting the OK button accepts the user’s value field entry. Selecting the Cancel
button cancels the entry and returns the user to the previous screen.
Table 4-8 displays available Diebold Reserved Screen Numbers and their
definitions.
NOTE
4-28
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
4-29
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Error Status selection converts Diebold device fault status messages to an
equivalent NDC form. The file associated with this screen contains records
consisting of the MDS Status string, or a portion of it, that is received as part
of the Diebold device fault status message, equivalent NDC device ID, NDC
M-Status and M-Data translations, and other information used to translate the
status message. Refer to the Error Status Mapping main screen below.
The only parameter/value fields on the Error Status Mapping screen that can be
modified or changed are as follows:
• M-Status
• M-Data
• Suppress in Maintenance Mode
• Dump Cash
G5371_009
• Device ID
• MDS Status
• Host Type
• Transaction Status
• Device Status
• Severity
• Event Handlers
The M-Status and M-Data portion of each entry can be modified using the Modify
option and are used to construct the associated portions of the NDC device fault
status message translation. Refer to the Error Status Mapping main screen below.
4-30
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_009A
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
4.4.6.5 Function ID
4-31
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_010E
The following screen displays the Add option screen selected from the Main
Function ID Mapping screen.
G5371_010A
The following screen displays the Modify option screen selected from the
Main Function ID Mapping screen.
G5371_010B
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
4-32
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Selecting the IDM Document Enable Code option displays a list of the
configured NDC Doc Enable Codes and their corresponding Diebold values for
the IDM device, as shown in the following screen.
G5371_010C
The NDC Document Enable Codes are contained in the NDC downloaded ‘Q’
state. All NDC Document Enable Codes received into the downloaded ‘Q’ State,
must be configured in this screen selection.
From the Main IDM Document Enable Code Mapping selection, you can select
one of the Document Enable Codes listed, or select the Add button to access the
following screen, as shown below.
G5371_010F
4-33
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The options for the IDM Document Enable Code selection, are as follows:
• NDC Document Enable Code - The NDC value is downloaded into the ’Q’
State field. Format can be 5 numeric digits.
• MICR Read Zone - Indicates which Read Zone data Agilis NDx should be
used to insert the MICR data. Format can be a number from 1 to 10.
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
From the 912 Windows selection, you can select one of the 912 Windows listed,
or select the Add button to access the following screen, as shown below.
G5371_010D
The windows position (sequence) maps the read zone sequence to be inserted into
the transaction request message. From this screen, you can select each parameter
setting. You can use the numeric format from 1 to 999.
Select OK to accept the new values and return to the previous screen. Select
Cancel to return to the previous screen without adding or changing any new
values.
4-34
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The values configured into the 912 type, 912 index, and 912
window(s) must have corresponding entries in the ics.cfg
(IDM device configuration file).
For instance, configure the parameters shown in Figure 4-13 with the following
values:
- 912 type=1
- 912 index=1
- 912 windows=1
• US Check E13B MICR Line - referred to the IDM Doc Enable Codes
parameters values:
- 912 type=1
- 912 index=1
- 912 windows=2
The Agilis NDx application will fill in the NDC Transaction Request Message,
inserting the "US Personal and Commercial Check Courtesy Amount" data
into the "Read Zone 1" field and "US Check E13B MICR Line" data into the
"Read Zone 2" field.
The Logo number contains mapping between NDC logos and Diebold icon
numbers. A valid NDC logo number is 2 characters long with a range of 00
to 99. A valid Diebold icon number is 3 characters long and must be numeric
with a range of 000 to 999. The NDC Logo Number to Diebold Icon Number
screen is empty by default.
NOTE
Use this translation with the host-sent ESC ’P’ ’1’ Parameter
ESC ’\’ screen control sequence for picture control.
4-35
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_012
The following screen appears after selecting the Add option from the Logo
Number Reference main screen.
G5371_012A
The following screen appears after selecting the Modify option from the Logo
Number Reference main screen.
G5371_012B
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Picture Number translation file contains mapping between NDC picture
and Diebold icon numbers. A valid NDC picture number is 1 to 3 characters
long with numbers ranging from 000 to 999. A valid Diebold icon number is 3
characters long and must be numeric with a range of 000 to 999.
NOTE
Use this translation with the host-sent ESC ’P’ ’2’ Parameter
ESC ’\’ screen control sequence for picture control.
4-36
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_013
The following screen appears after selecting the Add option from the Picture
Number Reference main screen.
G5371_013A
The following screen appears after selecting the Modify option from the Picture
Number Reference main screen.
G5371_013B
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Print Data Translation file contains information for the conversion of the
NDC Printer Data Control Sequences to Diebold Printer Data Control Sequences.
Each entry consists of the character set, NDC Print Data and Diebold Print Data.
If the specified NDC Print Sequence in the specified character set is found in
the print data in a Transaction Reply, it is replaced with the equivalent Diebold
print data in the Function Command.
4-37
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
NOTE
G5371_014
The following screen appears after selecting the Add option from the Print
Data Mapping main screen.
G5371_014A
The following screen appears after selecting the Modify option from the Print
Data Mapping main screen.
G5371_014B
4-38
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The following screen appears after selecting the Add option from the Print
Data Mapping Modify screen.
G5371_014C
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Reject Reason Codes are used as translations between NDC and Diebold.
The codes are transmitted to the network as part of a Solicited Status message.
These codes indicate why a message from the network was rejected by the ATM.
This file is used to convert Diebold Reject Reasons Codes to corresponding
NDC reject reason codes.
G5371_015
The following screen appears after selecting the Modify option from the Reject
Reasons Codes main screen.
G5371_015A
4-39
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Screen Control Sequence file contains the following three functions.
Setting the data appropriately in the Screen Control Sequence screens allows
the Agilis NDx application software to convert an NDC/NDC+ Screen Data
Sequence to a Diebold Screen Data sequence. All characters must be entered,
using their hexadecimal value. There are no maximum sequence lengths.
G5371_017
The following screen appears after selecting the Add option from the Screen
Control main screen.
G5371_017A
4-40
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The following screen appears after selecting the Modify option from the Screen
Control main screen.
G5371_017B
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
Wildcard Characters
The Screen Control Sequence file accepts wildcard characters, such as the
following:
• ’7F’ - behaves like ’*’, which replaces any number of contiguous characters
• ’07’ - behaves like ’?’, which replaces one character in the screen data
sequence
If it is necessary that the NDC+ control sequence, "EscP 2 050 Esc \" be mapped
to a Diebold escape sequence, "Esc O 050 EscP 050 0", the following control
sequence mapping using wildcard characters, as shown below, can be used. In
the following scenario, wild card characters can be used to convert the above
NCR escape sequence to a Diebold escape sequence, for all occurrences of
parameters for NDC+ picture control.
The function Key Row section in this file is reserved for cursor position data,
which translates function key rows. If set, the NDC Function Key Row causes
the NDC Function Key Row to be mapped to the Diebold function Key Row
when a set cursor position is sent in the Screen Data. For more information,
refer to Appendix D.
Therefore, NDC Function Key Row #1 translates to Diebold function Key Row 2
and/or NDC Function Key Row #2 translates to Diebold function Key Row 1.
4-41
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Left Sequence
Most loads use either an ICON or a series of characters to point to a function key.
This defines the sequence that points to a left-side key. When converting screen
data, if this sequence is found, then the screen row will be left-justified.
Right Sequence
This defines the sequence that points to a right-side key. When converting screen
data, if this sequence is found, then the screen row will be right-justified.
The following screen appears after selecting the Modify option from the Screen
Control main screen.
G5371003
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Screen Number Reference Mapping file contains mapping between NDC
and Diebold screen numbers. A valid NDC screen number is 3 characters long.
All three can be digits between 0 and 9, the digits can consist of one alpha
character followed by two digits, such as A00 or A01. A valid Diebold screen
number is also 3 characters long, can be numeric and alphanumeric and range
from 000-999 and A00 to AZZ. For more information on Diebold Reserved
Screens, refer to Section 4.4.6.3 and Table 3-7.
The following screen displays the Screen Number Reference Mapping main
screen.
G5371_016
4-42
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
By default, all NDC Reserved screen numbers are mapped to valid Diebold
screens. If the user wants to map an NDC Reserved Screen to a Diebold Reserved
Screen, they would use this file to map the screen. An example of screen control
mapping, which would go in the screen control sequence translation file with
an NDC Value of C00, "want more time" Reserved Screen (C00) to a Diebold
Reserved Screen (AY0). An example ADD screen control mapping follows.
G5371_016A
The following screen displays the Modify option for the Screen Number
Reference mapping screen.
G5371_016B
New values can be inserted into each user-entry Value field. Select Ok to
accept the new values and return to the previous screen. Select Cancel to return
to the previous screen without adding or changing any new values. To delete
an entry, select the Delete button.
The Timer Number file contains information for converting NDC Timer Numbers
to Diebold Timer Numbers. The information is used while converting an NDC
Configuration Parameters Load or NDC Enhanced Configuration Parameters
Load to a Diebold Write III Command.
The following screen is the Timer Number Reference Mapping main screen.
4-43
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_018
The following screen appears after selecting the Add option from the Screen
Control main screen.
G5371_018A
The following screen appears after selecting the Modify option from the Screen
Control main screen.
G5371_018B
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Diebold default timer values file specifies default values for the Diebold
Timers. If a timer value is not specified in an NDC Configuration Parameters
Load or an NDC Enhanced Configuration Parameters Load, then the default
values are used.
The following screen is the Diebold Timer Value Mapping main screen.
4-44
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_019
The following screen appears after selecting the Modify option from the Diebold
Timer Value Mapping main screen.
G5371_019A
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Touch Screen key codes mapping file contains information that converts
an NDC key code to a Diebold key code in Touch Template data. The file
contains some default entries and does not need to be modified if you are
not using a Touch Screen.
The following screen is the Touch Screen Key Code main screen.
G5371_011
The following screen appears after selecting the Add option from the Touch
Screen Key Code main screen.
4-45
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_011A
The following screen appears after selecting the Modify option from the Touch
Screen Key Code main screen.
G5371_011B
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
The Voice Number translation file contains mapping between NDC voice
numbers and Diebold voice control file numbers. A valid NDC voice message
number is 2 to 3 characters long and are numbers ranging from 00 to 999.
A valid Diebold voice control file number is 3 characters long that must be
numeric, ranging from 000 to 999.
G5371_020
The following screen appears after selecting the Add option from the Voice
Number Reference main screen.
4-46
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
G5371_020A
The following screen appears after selecting the Modify option from the Voice
Number Reference main screen.
G5371_020B
New values can be inserted into each user-entry Value field. Select OK to accept
the new values and return to the previous screen. Select Cancel to return to the
previous screen without adding or changing any new values.
For more information on how Voice Control Files operate, refer to the Voice
Prompting Using Control Files section, in the guide, Agilis 91x™ Terminal
Programming Manual (TP-820740-001B).
NOTE
4-47
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Appendix A
NDC+ Transaction Messages
The NDC+ transaction request is very similar to the Diebold CREQ, so Agilis
NDx typically does not modify it. However, the NDC+ transaction request may
have the previous transaction data appended to it. In order to append the previous
transaction, an enhanced configuration parameters customization data message
feature is turned on in NDC+. If this feature is turned on, Agilis NDx also
appends the previous transaction data to the end of the transaction request.
The Agilis NDx application supports NDC messages. Table A-1 displays the
Diebold TABS 9000 series messages that equate to the NDC SST messages.
A-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The NDC+ function command, like the Diebold 911 function command, contains
one function identifier. This function identifier will do the multiple task functions
such as deliver and print, deposit and print, and so on. Diebold 912 function
commands contain multiple function identifiers. Agilis NDx converts the NDC+
function identifier into 912 function identifiers. The NDC+ function identifiers
and their Diebold conversions are shown in Table A-2. There are default entries
in the file which can be modified, if necessary.
A-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The Agilis NDx application also converts screen data in the NDC/NDC+
function command from the 32x16 character NDC+ screen into the Diebold
40x20 character screen. For more information on the Agilis NDx Screen Control
Translation, refer to Section 4.4.6.11.
The Agilis NDx application, with the help of its Screen Control Translation file,
can perform translations such as the following:
• Converts the NDC+ select normal primary character set control sequence
to the Diebold default character set. If any other character set control
sequences are used, they must be converted in the Agilis NDx screen
control sequence file.
The Agilis NDx application converts the NDC+ printer data into Diebold format.
Although most printer data commands are the same and convert directly, some of
the printer character sets are different. Agilis NDx application includes a print
data conversion file to convert special print data. For more information on the
Print Data Translation file, refer to Section 4.4.6.9.
The Agilis NDx application also converts the special screens used by NDC+
as headers on printed receipts. Refer to Section 4.4.6.12 Screen Number
Translations, for more information.
A-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
The NDC+ deposit printer can print 80 columns of print data, while the Diebold
can only print 55. Agilis NDx converts the deposit print data for the Diebold
terminals so that the most pertinent information is included. The transaction
serial number is printed twice for the 8-character amount buffer, but only once
for the 12-character amount buffer. Agilis NDx converts 20 bytes of Track 2 card
data instead of 30, and Agilis NDx does not convert the machine number. The
Diebold print data includes all other NDC+ print data.
The NDC+ interactive transaction reply is similar to the Diebold Open Account
Relationship (OAR) Write V command. This command writes OAR screen
configuration data to the terminal during a transaction. The OAR command
enables specific function keys, and Agilis NDx will convert the NDC+ left-hand
keys of F, G, H, and I into the corresponding Diebold left-hand keys of I, H,
G, and F. Agilis NDx will modify the 32x16 cursor position within the OAR
screen data by centering the data on the 40x20 screen. If the screen row is a
function key row with a key that is enabled, Agilis NDx converts the cursor
position as follows:
• If both keys are enabled, eight spaces will be inserted at the center of
the screen.
A-4
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Appendix B
NDC+ Terminal Commands
The Agilis NDx application translates the NDC+ Send Configuration ID message
and Send Configuration Information message into a Diebold Configuration
Information Request message. The solicited status that is received is used to
create the NDC+ solicited status. The hardware status, sensor status, and supplies
status that are part of the NDC+ configuration information response are stored by
the Agilis NDx application in its persistent layer. The NDC+ release number
and software ID are retrieved from the Agilis NDx Configuration file and
sent in the solicited status.
The NDC+ Send Supply Counters message is translated into the Diebold
Retrieve Enhanced Supply Counts Message. The accumulated transaction
count, last transaction notes dispensed, and last transaction serial number are
stored by the Agilis NDx application.
The NDC+ send tally information and error log information are not currently
supported by the Agilis NDx application. If the Agilis NDx application receives
these messages, a fixed solicited status message is sent to the host.
The NDC+ Send Date and Time information causes Agilis NDx to send an
enhanced Operational Command message to the Agilis 91x system and send the
response in a solicited status message to the host.
B-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
• Flex Disk
• Tamper Indicating Bins
• Cardholder Keyboard
• Operator Keyboard
• Cardholder Display/Voice
The Agilis NDx application returns status information concerning the following
devices:
• Cash Handler
• Depository
• Receipt Printer
• Night Safe Depository
• Encryptor
• Security Camera
• Door Access
• Magnetic Card Read/Writer
• Cassette type 1
• Cassette type 2
• Cassette type 3
• Cassette type 4
• Time of Day Clock (Agilis NDx does not change)
• High Order Communications (Agilis NDx does not change)
• System Disk (Agilis NDx does not change)
• Flex Disk (Agilis NDx does not change)
• No error
• Routine errors have occurred
• Warning conditions have occurred, investigation required
• Suspend (not used by Agilis NDx)
• Fatal error condition exists
The Agilis NDx application returns supply status information for the following
devices and supplies:
The supply status for each of the devices or supplies can be as follows:
• Not Configured
• Good State
• Media Low
• Media Out
• Overfill
B-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
An example Supply Status screen, where all statuses are determined, displays
below.
G5371_021
B-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Appendix C
Agilis NDx Error Processing
The Agilis NDx application executes internal error functions or event handlers.
These internal functions do such things such as update supplies and sensor
statuses, convert unsolicited statuses into solicited statuses, and sends a function
command to the Agilis 91x system. Additional unsolicited statuses can be
sent to the host.
The Agilis NDx application has an error translation table that it uses for the
translation of Diebold MDS status messages into an NDC+ error messages.
When Agilis NDx receives a solicited or unsolicited status, it looks up the MDS
status in the error translation table, and then uses the information to send the
translated message to the host. If there is no match in the status translation table,
the error is logged in the Agilis NDx main error log file and discarded.
• Transaction status that tells the host what happened to the transaction
in process when the error occurred. The transaction status is used for a
solicited status message.
• A device status that tells the host what happened to the transaction in
process when the error occurred. The device status is used for an unsolicited
status message.
• A severity code that tells the host whether the error was fatal or a warning
• A supplies status that gives the state of the media bin. The Agilis NDx
application updates and sends the supplies status in both solicited and
unsolicited status messages.
• M-status which shows the precise error that occurred at the terminal
C-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
While constructing the error message for the host, the Agilis NDx application
also executes other functions depending on the configuration of the translation
tables. The Agilis NDx application performs the following functions during
error processing:
• If the dump cash during next function command is set in the status
translation table, then the Agilis NDx application will place a dump function
identifier at the beginning of the next function command that it receives.
NOTE
EXAMPLE
PR01 :2D
:2D "SUPPRESS" "4828000"
END PR01
The first parameter is the MDS status to be filtered. In this example, any MDS
status beginning with :2D will be filtered using this entry in the file.
The second parameter is the 9000-style solicited status value to send to the
network. SUPPRESS is a reserved keyword that indicates no status will be sent.
The third parameter is the 9000-style unsolicited status value to send to the
network. In this example, 4828000 will be sent to the network.
The table for PR01 (Thermal consumer printer) shows that paper low is
suppressed in TRANSTBL.TXT.
C-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
For more information about the TRANSTBL.TXT file, refer to the Agilis 91x™
Status Reference Manual (TP-820741-001B).
C-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Appendix D
Translation File Descriptions
D-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Appendix E
Configuration Registry
The following listing displays the Configuration Registry file entries for the NDx
application installation. These are the keys and files that are installed after Setup
is selected from the CD-ROM and the installation is complete. To uninstall the
Agilis NDx application, these registry files must be manually deleted. To do this,
select the STARTbutton on the Windows NT or Windows XPe desktop. Select
the Run option. Type Regedit to open the registry.
NOTE
[HKEY_LOCAL_MACHINE\SOFTWARE\Diebold]
[HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\Configuration menu]
E-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
E-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{GUID}]"UninstallString"="RunDll32
C:\\PROGRA~1\\COMMON~1\\INSTAL~1\\engine\\6\\INTEL3~1\\Ctor.dll,LaunchSetup \"C:\\Program Files\\InstallShield
Installation Information\\{ GUID}\\Setup.exe\" -l0x9 " "DisplayName"="Agilis NDX" "LogFile"="C:\\Program Files\\InstallShield
Installation Information\\{GUID}\\setup.ilg"
E-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Appendix F
Required Agilis 91x System Settings for Agilis NDx
The following table lists the required Agilis 91x system settings for either the
system registry or system files, that are necessary for the Agilis NDx application
software to function properly.
All the following settings must be manually configured by setting the appropriate
bits in the registry. The weight values correspond to the weight values in the
MDS Maintenance manual to select an appropriate option value, while the hex
value indicates the actual setting in the registry.
EXAMPLE
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19? .
Combination of Options
To use a combination of options, review the following example.
EXAMPLE
In System Control 2 Device Properties, Option 2 settings, add the values of the
desired options and use the sum for the setting of Option 2. For example,
a value of 024 defines a terminal that accepts and performs print-immediate
Function Commands while it is in the Maintenance mode (option value 008)
and rejects any Write Command messages received while it is in an In-service
mode (option value 016). Next, calculate the corresponding hex value of the sum
and enter that value in the registry.
NOTE
Table F-1 Required Agilis 91x System Settings for Agilis NDx
1
Status Always send MDS status
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\system3]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,53,59,30,33,01,ff,ff,00,00,50,00,01,\
00,00,00,02,5a,00,da,bc,f6,77
DIT Option System Control 3 DIT->Option 1: Offset 16 – Bit 2 (hex: 04) (Weight 004)
F-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Table F-1 Required Agilis 91x System Settings for Agilis NDx (continued)
2
Status Send Supervisory status at Logon
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\high side comm]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,48,43,30,31,01,00,00,30,64,00,ff,ff,\
ff,cc,f0,00,00,00,40,40,40,40
DIT Option High-Side Comm DIT->Option 1: Offset 16 – (hex: 31) (Weight 049) [Send status
at logon]
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\system2]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,53,59,30,32,01,ff,ff,00,00,00,00,00,\
00,00,00,02,5a,00,da,bc,f6,77
DIT Option SYSTEM Control 2 DIT->Option 2: Offset 17 – Bit 2 (hex: 04) (Weight 004)
3
Status Send Supervisory status at Logoff
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\system2]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,53,59,30,32,01,ff,ff,00,00,00,00,00,\
00,00,00,02,5a,00,da,bc,f6,77
DIT Option SYSTEM Control 2 DIT->Option 2: Offset 17- Bit 7 (hex: 80) (Weight 128)
4
Status Terminal rejects any Write Command messages received while it is in an in-service
mode
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\system2]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,53,59,30,32,01,ff,ff,00,00,00,00,00,\
00,00,00,02,5a,00,da,bc,f6,77
DIT Option SYSTEM Control 2 DIT->Option 2: Offset 17- Bit 4 (hex: 10) (Weight 16)
5
Status Send Unsolicited Status during Maintenance
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\system2]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,53,59,30,32,01,ff,ff,00,00,00,00,00,\
00,00,00,02,5a,00,da,bc,f6,77
DIT Option SYSTEM Control 2 DIT->Option 5: Offset 20 – Bit 5 (hex: 20) (Weight 032)
6
Status Cassette Tamper enabled must be set to "On"
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\cash dispenser]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,10,00,44,49,30,31,01,46,31,01,00,00,00,00,\
00,08,32,32,07,9c,00,00,00,00
DIT Option Cash Dispenser DIT->Option 1: Offset 16 – Bit 1 (hex: 02) (Weight 002)
7
Status English Language translation of fault statuses should be set to "Send to journal printer"
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\system2]
Setting "ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,53,59,30,32,01,ff,ff,00,00,00,00,00,\
00,00,00,02,5a,00,da,bc,f6,77
DIT Option SYSTEM Control 2 DIT->Option 2: Offset 17 – Bit 6 (hex: 40) (Weight 064)
8
F-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Table F-1 Required Agilis 91x System Settings for Agilis NDx (continued)
F-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Table F-1 Required Agilis 91x System Settings for Agilis NDx (continued)
Registry [HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\consumer
Setting keyboard]
"ditparam"=hex:4f,44,5f,44,49,54,00,0d,00,4b,45,30,31,01,38,31,01,00,ff,ff,ff,\
ff,08,32,32,5a,00,da,bc,f6,77
# The ditparam data type is based on the following:
# byte 14 is the device enabled flag. The dit data follows the option number
# information in the Maintenance Manual. The two bytes before ff are the
# reserved crc data.
"Product Type"="telephone layout, 16 key, decimal point"
# reserved
"Product Description"="Telephone layout, 16 key, decimal point"
# reserved
"Image Name"="TEL01.jpg"
# reserved
"invert_keys"="off"
# reserved
"Keyboard Template"="epp\\epptel01.dat"
# reserved
"Keyboard DEA Template"="epp\\epptel02.dat"
# reserved
DIT Option Set "invert_keys"="on"
14
Status Relocation of Agilis NDx default Reserved Screens
Registry Import newreserved.reg file into the registry with the following command from
Setting or File c:\Diebold\web\scripts\
DIT Option Notify Host After Successful Local Load => "Yes"
NOTE: This setting is automatically set by the installation procedure.
16
Status SXA Settings
Registry 1. In SXA.ini file:
Setting or File Section [Configurables]
Enabled = Yes
91xMessage = No
2. In UserExit.lst file, add the following line in the User Exit list section:
[ User Exit List ]
ACO="C:\diebold\ACO2\Dll\ACO2UEJ.dll"
F-4
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Table F-1 Required Agilis 91x System Settings for Agilis NDx (continued)
"vid1"="consumer"
# reserved
"vid2"="system"
# reserved
"Service Monitor"="Color"
# reserved
"browser_timeout"="15"
# reserved
"background"="0"
# reserved
"foreground"="7"
# reserved
DIT Option Change foreground and background parameters accordingly:
OR Parameter White - Black (0 fore 7 back)
Change White - Red (4 fore 7 back)
Yellow - Blue (14 fore 1 back)
F-5
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Appendix G
Native NDC+ and Agilis NDx DPM Differences
The differences between native NDC+ document processing and Agilis NDx
document processing is detailed in the following paragraphs.
Agilis NDx will not send the detail of the DPM cassettes supplies and fitness
status. The Agilis 91x IDM cassette errors do not detail which cassette generates
the error. Therefore, Agilis NDx will always set the first cassette supply and
fitness (pocket A).
The following tables describes the contents of the DPM Device Fault Status
message.
G-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
Device fault messages will not report the following status fields in NDx:
However, in Agilis NDx, the Sensor Device Fault Status message, the DPM
sensor character (19) will always be set to 1 (DPM pockets closed).
• Document Already Present Next State Exit in the ’Q’ extension, State 3
• Exception Type 1 Next State Exit field in the ’Q’ extension, State 3
• Device fault message will not report Transaction/Device status sub fields
related to candidate document
G-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)
PRELIMINARY - DRAFT COPY
Tue Apr 08 15:32:44 2003
• Does not insert the Read Zone Data Identifier into the Transaction Request
Message
• Processes the check retain error recovery action without showing the DPM
Document Captured screen during Close State processing.
• If the value in the Lift Front/Rear Image field in the NDC+ ’Q’ state
is anything other than a zero (0) or 1 (supported) value, the NDx
application reads the value of the related configuration parameter from the
main configuration file. This state is included in the Agilis NDx state
flow. However, if the value indicated in the configuration file is 2 or 3
(unsupported NDx values), the resulting state is invalid and will be rejected.
G-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820803 (Ed. B)