APTRA™ Advance NDC

Overview

B006‐6597‐K000
Issue 1
May 2019

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.
Copyright and Trademark Information

The product described in this book is a licensed product of NCR Corporation.

APTRA, Personas and SelfServ are trademarks of NCR Corporation.

Adobe and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States
and/or other countries. 
Diebold Nixdorf is registered trademark of Diebold Nixdorf International in the United States and/or other countries.
IBM and Operating System/2 are registered trademarks of International Business Machines Corporation in the United
States and/or other countries.
Intel, Celeron, Core and Pentium are trademarks or registered trademarks of Intel Corporation in the United States
and/or other countries.
Microsoft, ActiveX, Internet Explorer, Visual Studio and Windows are registered trademarks or trademarks of Microsoft
Corporation in the United States and/or other countries.
Nuance is a trademark and/or registered trademark of Nuance Communications, Inc. and/or its subsidiaries in the
United States and/or other countries.
Solidcore is a registered trademark or trademark of McAfee, Inc. and/or its affiliates in the United States and/or other
countries.
Sound Blaster is a trademark or registered trademark of Creative Technology Ltd in the United States and/or other
countries.
All other trademarks are the property of their respective owners.

Disclaimer:

It is the policy of NCR Corporation to improve products as new technology, components, software and firmware become
available. NCR therefore reserves the right to change specifications without prior notice.

All features, functions and operations described herein may not be marketed by NCR in all parts of the world. In some
instances, photographs are of equipment prototypes. Therefore, before using this document, consult with your NCR
representative or NCR office for information that is applicable and current.

To maintain the quality of our publications, we need your comments on the accuracy, clarity, organisation and value of
this book.

Address correspondence to:

NCR Financial Solutions Group Ltd

Product Management Feedback
Discovery Centre
3 Fulton Road
Dundee, Scotland
DD2 4SW

© 2007–2019
By NCR Corporation
Atlanta, Georgia, USA
All Rights Reserved

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.
 Federal Communications
Commission (FCC) Radio Frequency
Interference Statement

Note: This equipment has been tested and found to comply with
the limits for a Class A digital device, pursuant to Part 15 of the
FCC Rules. These limits are designed to provide reasonable
protection against harmful interference when the equipment is
operated in a commercial environment. This equipment
generates, uses, and can radiate radio frequency energy and, if not
installed and used in accordance with the instruction manual,
may cause harmful interference to radio communications.
Operation of this equipment in a residential area is likely to cause
harmful interference in which case the user will be required to
correct the interference at his own expense.

This digital apparatus does not exceed the Class A limits for radio
Canadian Class A Device noise emissions from digital apparatus set out in the Radio
Declaration Interference Regulations of the Canadian Department of
Communications.
Le présent appareil numérique n’émet pas de bruits
radioélectriques dépassant les limites applicables aux appareils
numériques de la classe A prescrites dans le Réglement sur le
brouillage radioélectrique édicté par le ministère des
Communications du Canada.

This equipment must be installed and used in strict accordance with

Information to User the manufacturer’s instructions. However, there is no guarantee
that interference to radio communications will not occur in a
particular commercial installation. If this equipment does cause
interference, which can be determined by turning the equipment off
and on, the user is encouraged to consult an NCR service
representative immediately.

Caution NCR Corporation is not responsible for any radio or television

interference caused by unauthorised modifications of this
equipment or the substitution or attachment of connecting cables
and equipment other than those specified by NCR. Such
unauthorised modifications, substitutions, or attachments may void
the user’s authority to operate the equipment. The correction of
interference caused by such unauthorised modifications,
substitutions, or attachments will be the responsibility of the user.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview iii

 Confidential and proprietary information of NCR.
Unauthorised use, reproduction and/or distribution is strictly prohibited.

iv APTRA Advance NDC, Overview

 Revision Record

Revision Record

Date Page Description of Change

May New revision for Advance NDC 05.01.00

2019

1‐7 Added information about a new state: Card

Eject State with time‐out option.

1‐7 Added information about a GBXX device

with non‐configured cassettes.

1‐7 Added information about fixed cassette

mapping for a BRM device.

1‐7 Added information about disable Clear key

in PIN entry state.

1‐7 Added information about capturing bunch

note images on a BRM device during
dispense and deposit transactions.

1‐7 Added information about updating the

GBXX cassette configuration sets from the
supervisor option.

1‐8 Information added to describe that Advance

NDC doesn’t support Local Cash Dispense
State by default.

1‐8 Added information about configuring

Advance NDC to provide Uninterruptible
Power Supply (UPS).

1‐8 Added information about journaling

location information of notes along with
the serial number in both deposit and
dispense (only in a BRM device)
transactions.
1‐8 Added information about file name format
of the captured SNR image, journaling the
information in the EJ and also archiving and
deletion of the SNR Image files.

1‐8 Added information about the e‐receipt.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview v

Revision Record

Date Page Description of Change

1‐8 Addedinformation about loading the

application
even if the EPP is not detected at the start of
day and also either stops or allows further
transactions through a registry setting when
the EPP is not detected or goes fatal.

1‐8 Added a new section to provide information

about a new API, which is used to exit from
A‐Card Read or T‐Card Read‐PIN Entry
Initiation states.

1‐8 Added information about configuring reject

and/or retract bins for depositing notes
during bin overflow.

1‐8 Information added about mapping the

entire touch area on the screen to FDK D for
cardless transactions.

1‐9 Added information about logging the serial

number of the deposited notes to the
ECB6Log database.

1‐9 Added information about journaling the

rejected counts before clearing the counters.

1‐9 Added information about journaling the

count of notes that pass through the bill
validator in case of a deposit transaction
with hardware error.

1‐9 Added information about journaling the

summary of presented and retracted notes.

1‐9 Added information about reporting count of

notes in unknown location in case of a
hardware error in a dispense transaction.

1‐9 Added information about retaining

destination for the notes in Escrow during
close state.

1‐9 Added information about enhancement of

fault display for the Cheque Processing
Module.

1‐10 Added information about

reporting cumulative count of notes per
operation.

1‐10 Added information about logging count of

notes per operation in the ECB6 messages.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

vi APTRA Advance NDC, Overview

 Revision Record

Date Page Description of Change

1‐10 Added information about handling

incorrect denomination and short dispense.

1‐10 Added information about restricting the

card entry retires if a card is misread in the
Card Insert state (z008).

1‐10 Added information about journaling

supervisor mode change status in the EJ
during a transaction.

1‐10 Added information about journaling

security trace message for a cash‐in cassette
movement along with the tamper and
sensor status reporting.

1‐11 Added information about journaling and

printing refund reply data irrespective of
notes are taken or not in a deposit
transaction.

1‐10 Added information about configuring

device mode to interact with the contactless
card.

1‐11 Added information about reporting the

reject bin count when an invalid note is
moved to the reject bin.

1‐11 Added information about journaling the

count of notes that are attempted to present
before a power failure occurs in a dispense
transaction.

1‐11 Information added about default network

connection based on the operating system of
SSTs.

1‐11 Added a new topic about voicing out last

entered key cumulatively.

1‐12 Removed information regarding NDC+

from the list of knowledge and experiences
before using Advance NDC on a
development system.
Added the NCRU course detail for the
training of NCR partners.

1‐13 Mentioned SDM/SDM2 related course is

available on the NCR University web site.

1‐15 Revised the minimum specification of

motherboard and processor for NCR SSTs:
Runtime System Hardware.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview vii

Revision Record

Date Page Description of Change

1‐17 Updated the Development System and

Runtime System software requirements
with the applicable APTRA XFS versions.

1‐18 Notes added related to the Visual Studio

2015 installation.

1‐19 Updated table ‘Operating Environments for

Development
PC and NCR SSTs’ to mention that
Windows 7 Professional 64‐bit is supported
for the APTRA XFS simulator.

1‐19 Revised information about compliant of

service providers with CEN XFS.

1‐19 Removed information about supporting

64‐bit Windows 10 operating environment
on other vendors’ SSTs as 64‐bit Windows
10 is not supported on other vendors’ SSTs.

1‐19 & Updated the version number of

1‐20 ‘EMV/CAM2 Exits for Advance NDC’.

1‐20 Added a note related to dial up

communication that describes 64‐bit
systems (Windows 7 or Windows 10)
does not support dial up.

2‐3 Revised the Microsoft Visual Studio 2005 to

the Microsoft Visual Studio 2015.
Revised the path where C‐Exits must be
installed and run from for 32‐bit and 64‐bit
operating system.

4‐8 Information added about .NET CxM

Content Deployer Service and .NET
CxMEReceipt Service.

4‐15 Added a note to describe that bitlocker is not

a recommended solution for the disk
encryption.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

viii APTRA Advance NDC, Overview

 Table of Contents

Contents

Preface

About This Publication ........................................................................xvii

Audience .........................................................................................xvii
Contents of the Publication ..........................................................xvii
Conventions Used in This Publication ..................................... xviii
How to Use This Publication ...............................................................xix
Navigating the Publication............................................................ xix
Support Information ............................................................................. xxi

Chapter 1
Introducing Advance NDC

Overview ................................................................................................1‐1
The Advance NDC Product .................................................................1‐2
What is Advance NDC? .................................................................1‐2
Multi‐Vendor Environment...........................................................1‐2
Advance NDC Applications..........................................................1‐3
SST Operation..................................................................................1‐3
Host Application.............................................................................1‐4
Benefits of Advance NDC ....................................................................1‐5
Direct Benefits of Advance NDC..................................................1‐5
Benefits for NDC+ Users ................................................................1‐6
New Features and Changes in Advance NDC..................................1‐7
New Features...................................................................................1‐7
Updated Features............................................................................1‐8
Prerequisite Knowledge and Training .............................................1‐12
Development Environment .........................................................1‐12
SST Installation and Configuration ............................................1‐12
Training ..........................................................................................1‐12
Hardware and Software Requirements............................................1‐14
Hardware Requirements..............................................................1‐14
Software Requirements ................................................................1‐16
Operating Environment ...............................................................1‐19

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview ix

Table of Contents

Advance NDC Architecture...............................................................1‐21

Creating an Advance NDC System ..................................................1‐24
Modifying Advance NDC ..................................................................1‐25
Customising Advance NDC........................................................1‐25
Enhancing Advance NDC ...........................................................1‐25
Extending an Advance NDC Application.................................1‐26

Chapter 2
Upgrading from Earlier Releases of Advance NDC

Overview ................................................................................................2‐1
Compatibility with Single‐Vendor Releases of Advance NDC ......2‐2
Configuration Options ...................................................................2‐2
Device Access ..................................................................................2‐2
Fault Display....................................................................................2‐2
State Tables ......................................................................................2‐2
Upgrading Your Application...............................................................2‐3
Modified Applications ...................................................................2‐3
Promote Campaigns .......................................................................2‐4

Chapter 3
Migrating from NDC+ to Advance NDC

Overview ................................................................................................3‐1
Reasons for Migrating to Advance NDC ...........................................3‐2
Comparing Advance NDC with NDC+ .............................................3‐3
Operating Environments ...............................................................3‐3
Features in NDC+ and Advance NDC.........................................3‐4
Migrating to Advance NDC.................................................................3‐9

Chapter 4
The Advance NDC Package

Overview ................................................................................................4‐1
Advance NDC Package Contents .......................................................4‐2
Advance NDC Installation ............................................................4‐2
Building a Custom Aggregate.......................................................4‐4
Component Overviews.........................................................................4‐5
.NET 2.x Runtime............................................................................4‐5
.NET 4.x Runtime............................................................................4‐5
.NET Activate Core Service ..........................................................4‐5

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

x APTRA Advance NDC, Overview

 Table of Contents

.NET Assemblies for Advance NDC............................................4‐5

3rd Party Runtime...........................................................................4‐8
ActiveXFS Controls.........................................................................4‐8
Advance NDC .................................................................................4‐9
Advance NDC Tools.......................................................................4‐9
Aggregate Builder...........................................................................4‐9
Business Services Interfaces ........................................................4‐10
CCM PCCM ...................................................................................4‐10
CCM VISA2 ...................................................................................4‐10
Component Builder ......................................................................4‐10
Data Manipulation........................................................................4‐10
Dialogs............................................................................................4‐11
Disk Imaging for APTRA XFS.....................................................4‐11
Display Manager (for HTML) .....................................................4‐11
ECB6 Database Support ...............................................................4‐11
Exception Handling......................................................................4‐12
HICS Interface ...............................................................................4‐12
HICOMMS .....................................................................................4‐12
Problem Determination................................................................4‐13
Resource Manager ........................................................................4‐13
Visual C++ 2005 Runtime .............................................................4‐14
Visual C++ 2010 Runtime .............................................................4‐14
Visual C++ 2015 Runtime .............................................................4‐14
Optional Aggregates and Components............................................4‐15
Security for APTRA Aggregate...................................................4‐15
Advance NDC Runtime Component .........................................4‐15
Secure Hard Disk Encryption .....................................................4‐15

Appendix A
Related Documentation

Overview ...............................................................................................A‐1
Advance NDC Documentation ..........................................................A‐2
APTRA Author Documentation.........................................................A‐3
Additional Authoring Documentation .......................................A‐4
NDC+ Documentation .........................................................................A‐5
Other NCR Documentation ................................................................A‐6
CEN‐XFS Documentation ...................................................................A‐7

Glossary
Glossary .................................................................................... Glossary‐1

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview xi

Table of Contents

Index
Index ................................................................................................Index‐1

User Feedback Form

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

xii APTRA Advance NDC, Overview

 List of Figures

List of Figures

Chapter 1
Introducing Advance NDC

Figure 1‐1 Advance NDC Application Architecture .................1‐22

Chapter 3
Migrating from NDC+ to Advance NDC

Figure 3‐1 Advance NDC and NDC+ Environments ..................3‐3

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview xiii

List of Figures

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

xiv APTRA Advance NDC, Overview

 List of Tables

List of Tables

Preface

Table Pref‐1 Contents of the Publication..........................................xvii

Table Pref‐2 Abbreviations Used in the Publications .................. xviii
Table Pref‐3 Navigation Elements ..................................................... xix

Chapter 1
Introducing Advance NDC

Table 1‐1 Development System Hardware 

(32‐Bit or 64‐Bit Windows 7) ....................................1‐14
Table 1‐2 Development System Hardware 
(64 ‐Bit Windows 10) .................................................1‐15
Table 1‐3 NCR SSTs: Runtime System Hardware 
(with Cash Acceptor).................................................1‐15
Table 1‐4 NCR SSTs: Runtime System Hardware 
(no Cash Acceptor) ....................................................1‐16
Table 1‐5 Development System Software Requirements ........1‐17
Table 1‐6 Runtime System: Software Requirements ................1‐18
Table 1‐7 Operating Environments for Development PC and
NCR SSTs ....................................................................1‐19
Table 1‐8 Authored Applications for Advance NDC ..............1‐21

Chapter 3
Migrating from NDC+ to Advance NDC

Table 3‐1 Comparison of NDC+ and Advance NDC Features .3‐4

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview xv

List of Tables

Chapter 4
The Advance NDC Package

Table 4‐1 Installation Types ...........................................................4‐2

Table 4‐2 Advance NDC Aggregate Components .....................4‐3
Table 4‐3 Optional Aggregate/Component .................................4‐4

Appendix A
Related Documentation

Table A‐1 Advance NDC Documentation ...................................A‐2

Table A‐2 Authoring Environment Documentation ..................A‐3
Table A‐3 Additional Authoring Documentation ......................A‐4
Table A‐4 NDC+ Documentation ..................................................A‐5
Table A‐5 Other NCR Documentation .........................................A‐6
Table A‐6 CEN‐XFS Documentation ............................................A‐7

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

xvi APTRA Advance NDC, Overview

 Preface
About This Publication

About This Publication

This publication gives an introduction to Advance NDC and its

functionality, particularly the new features in this release. It also
discusses upgrading from previous releases of Advance NDC,
migrating from NCR Direct Connect Plus (NDC+) and the contents
of the Advance NDC Package.

This publication is intended for the following:

Audience
 Anyone looking for an introduction to Advance NDC and its
benefits
 Advance NDC users who are planning to upgrade from earlier
versions
 NDC+ users who are planning to migrate to Advance NDC.
For details of experience required and training available, see
“Prerequisite Knowledge and Training” on page 1‐12.

This publication consists of the following chapters and appendices:

Contents of the Publication
Table Pref-1
Contents of the Publication

Title Description

Chapter 1, “Introducing Advance NDC” Provides information on the following:

 Advance NDC functionality, including new features and
changes in this release
 Architecture and benefits of Advance NDC
 Prerequisite knowledge, and available training
 Hardware and software requirements
 Options for enhancing Advance NDC

Chapter 2, “Upgrading from Earlier Releases of Provides information on compatibility with previous
Advance NDC” releases of Advance NDC and what changes may be
required, depending on how much you have changed or
enhanced your existing application

Chapter 3, “Migrating from NDC+ to Advance Provides information on migrating from

NDC” NDC+ to Advance NDC, with reasons for migrating and a
comparison of Advance NDC with NDC+

Chapter 4, “The Advance NDC Package” Describes what is provided in the Advance NDC release

Appendix A, “Related Documentation” Provides details of the documentation available for Advance
NDC and where the different publications can be obtained

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview xvii

Preface
About This Publication

New information provided in the text for the features and functions
Conventions Used in This added to the Advance NDC software for this release is highlighted
Publication with a pale‐green background.
The following abbreviated forms are used throughout the manual.
For a complete list of abbreviations and short forms, see the
Glossary.

Table Pref-2 Abbreviated Form Full Form/Description

Abbreviations Used in the Publications
Advance NDC APTRA Advance NDC

Author APTRA Author

Host Application on host or switch

Windows 7 Microsoft Windows 7 (32‐bit and 64‐bit)

Professional

Windows 10 Microsoft 64‐ bit Windows 10

Professional

POSReady 7 Windows Embedded POSReady 7

Windows Any of the Windows operating systems

supported by Advance NDC

CEN XFS 3 CEN XFS 3.xx

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

xviii APTRA Advance NDC, Overview

 Preface
How to Use This Publication

How to Use This Publication

If you are new to Advance NDC and not an NDC+ user, NCR
recommends you read the following:
 Chapter 1, “Introducing Advance NDC”
 Chapter 4, “The Advance NDC Package”.
If you intend to upgrade from a previous release of Advance NDC,
NCR recommends you read the following:
 Chapter 1, “Introducing Advance NDC”
 Chapter 2, “Upgrading from Earlier Releases of Advance NDC”
 Chapter 4, “The Advance NDC Package”.
If you intend to migrate from NDC+, NCR recommends you read
the following:
 Chapter 1, “Introducing Advance NDC”
 Chapter 3, “Migrating from NDC+ to Advance NDC”
 Chapter 4, “The Advance NDC Package”.

This publication can be viewed on‐screen with Adobe Reader, or

Navigating the Publication printed. Viewing on screen provides the following for navigation:
 Hyperlinked page references
 A hyperlinked contents tree in the Bookmarks pane, with
bookmarks down to the third heading level.
For both the printed version and on screen viewing, the following
elements are provided for navigation.

Table Pref-3 Element Description

Navigation Elements
Revision Record Lists updates for the current release of Advance
NDC, in page order with page references. The page
references are hyperlinked.

Table of Contents Lists the first two heading levels in page order with
page references.

Table of Contents Lists the first three heading levels in page order
for chapter or with page references.
appendix

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview xix

Preface
How to Use This Publication

Element Description

Glossary Provides an alphabetical list of terms, acronyms,

and abbreviations with their meaning.

Index Provides an alphabetical list of topics, keywords

and concepts, with page references.

User Feedback Allows you to comment on the publication by

Form completing the feedback form and sending it to
NCR by post, or by e‐mail.
Alternatively you can use the Web address
provided to access the form and submit it to NCR.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

xx APTRA Advance NDC, Overview

 Preface
Support Information

Support Information

If you have a problem with the Advance NDC software, please

contact your internal support department, or your local NCR
representative. NCR provides a wide range of support programmes.
For more information, contact your local account team.
If you have problems using the publication, please see the User
Feedback Form at the back of this publication. You will find
information on submitting comments by email or by regular mail.
Please take the time to reply, as your comments will be appreciated.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview xxi

Preface
Support Information

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

xxii APTRA Advance NDC, Overview

 Table of Contents
Introducing Advance NDC

Chapter 1
Introducing Advance NDC

Overview 1‐1

The Advance NDC Product 1‐2

What is Advance NDC? 1‐2
Multi‐Vendor Environment 1‐2
Advance NDC Applications 1‐3
SST Operation 1‐3
Host Application 1‐4

Benefits of Advance NDC 1‐5

Direct Benefits of Advance NDC 1‐5
Authoring Environment 1‐5
Benefits for NDC+ Users 1‐6

New Features and Changes in Advance NDC 1‐7

New Features 1‐7
Card Eject State 1‐7
Disable Clear Key in PIN Entry State 1‐7
Fixed Cassette Mapping for BRM 1‐7
Update GBXX Cassette Configuration Sets
from Supervisor 1‐7
GBXX Device with Not Configured Cassettes 1‐7
Capturing Bunch Note Image 1‐7
EPP 1‐8
E‐Receipt 1‐8
Exiting from A‐Card Read and T‐Card Read‐PIN Entry
Initiation States 1‐8
Configuring Reject and/or Retract Bin for 
Depositing Notes 1‐8
Map Entire Touch Area to FDK D 1‐8
Updated Features 1‐8
Uninterruptible Power Supply (UPS) 1‐8
Local Cash Dispense State 1‐8
Serial Number Information 1‐8
Journaling the Summary of Presented 
and Retracted Notes 1‐9

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

Table of Contents
Introducing Advance NDC

Journaling the Count of Notes that Pass 

through the Bill Validator 1‐9
Retain Destination for the Notes in Escrow (Close state) 1‐9
Journaling the Rejected Counts in CLR CASH And STD
CASH Supervisor Options 1‐9
Count of Notes in Unknown Location 1‐9
Fault Display 1‐9
Log Signatures of Good Notes in a Deposit Transaction 1‐10
Report Counts Per Operation 1‐10
Handling the Incorrect Denomination
and Short Dispense 1‐10
Interaction with Contactless Cad Reader 1‐10
Controlling the Card Entry Retries 1‐10
Journaling Supervisor Mode Change 
During a Transaction 1‐10
Journaling Security Trace Message 1‐10
Journal and Print Refund Reply 1‐11
Report Reject Bin Count as UNKNOWN 1‐11
Journaling the Count of Notes When a 
Present is Attempted Before Power Failure 1‐11
Default Network Connection 1‐11
Voice Out Entered Key 1‐11

Prerequisite Knowledge and Training 1‐12

Development Environment 1‐12
SST Installation and Configuration 1‐12
Training 1‐12

Hardware and Software Requirements 1‐14

Hardware Requirements 1‐14
Development System (PC) 1‐14
Runtime System (SST) 1‐15
Software Requirements 1‐16
Development System (PC) 1‐17
Runtime System (SST) 1‐18
Unattended Installation 1‐18
Operating Environment 1‐19
Operating Environment on Other Vendors’ SSTs 1‐19

Advance NDC Architecture 1‐21

Application Core 1‐22
Supervisor 1‐23
Customisation Layer 1‐23

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

 Table of Contents
Introducing Advance NDC

Creating an Advance NDC System 1‐24

Modifying Advance NDC 1‐25

Customising Advance NDC 1‐25
Enhancing Advance NDC 1‐25
Enhancing the Customisation Layer 1‐25
Enhancing the Application Core and Supervisor 1‐25
Extending an Advance NDC Application 1‐26
Examples of Extending an Advance NDC Application 1‐26

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

Table of Contents
Introducing Advance NDC

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

 Introducing Advance NDC
A

Overview

Overview 1

This chapter provides the following:

 An introduction to the Advance NDC product
 Information on the benefits of Advance NDC for users of
previous releases of Advance NDC and for users of NDC+
 Brief details of the new features and changes in Advance NDC
 Details of the prerequisite knowledge and training that are
recommended for users of Advance NDC
 Details of the hardware and software required to run Advance
NDC in the development environment and in the runtime
environment
 An overview of the Advance NDC architecture
 Information on creating an Advance NDC system
 Information on how Advance NDC provides an environment in
which users can customise, enhance or extend the product to
suit their specific requirements.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-1

Introducing Advance NDC
The Advance NDC Product

The Advance NDC Product 1

The Advance NDC product operates in a Windows environment on

self‐service terminals (SSTs), supports the NDC message format and
offers the following:
 A multi‐vendor application that will run on either NCR’s or
other vendors’ SSTs
 Flexibility in methods of enhancing the product
 A migration path from OS/2‐based NDC+ to a Windows
environment, allowing customers to benefit from the features
available in Advance NDC without requiring changes to the
host application or NDC+ customisation data (states and screens
download).

Advance NDC is a self‐service application that executes financial

What is Advance NDC? 1

transactions providing bank customers (consumers) with access to

their accounts 24/7. It is used to operate and maintain SSTs in a
multi‐vendor environment.
Advance NDC enables an SST to send transaction requests and
status messages to an application on a host or switch and process
the transaction according to the replies received from the host
application.

Advance NDC is capable of running on SSTs that are compliant

Multi‐Vendor with release 3 of the CEN‐XFS interface specification, which
Environment 1
provides a standard interface for accessing and manipulating
various financial service devices regardless of the manufacturer.
NCR’s implementation of the CEN‐XFS specification for NCR SSTs
is APTRA XFS, a runtime platform running on a 32‐bit or 64‐bit
Windows operating system.
On NCR SSTs, APTRA XFS is an intermediate layer between the
operating system and the application, providing the application
with a measure of operating‐system independence and access to the
SST devices and services. Other vendors provide their own
implementation of the CEN‐XFS specification on their SSTs.

Note: APTRA XFS is not supplied with Advance NDC but is

available as a separate product. For more information about APTRA
XFS, refer to the NCR APTRA XFS Overview.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-2 APTRA Advance NDC, Overview

 Introducing Advance NDC
The Advance NDC Product

Advance NDC consists of the following three projects in the APTRA

Advance NDC Author from which one application executable and two application
Applications 1
DLLs are built:
 Application Core (executable)
 Customisation Layer (DLL)
 Supervisor (DLL).
When Advance NDC is running, the Application Core drives the
Customisation Layer and Supervisor, and passes control to them at
several key points.
The Application Core performs background processing activities
such as message handling and managing SST modes. The
Customisation Layer performs the in‐service activities associated
with the consumer. The Supervisor application performs the
out‐of‐service activities associated with the maintenance and
running of the SST.
Shared data is used by the Application Core, Customisation Layer
and Supervisor applications. The repository that holds this data is
called the Common Data Interface (CDI).
For more information about the Advance NDC architecture, see
“Advance NDC Architecture” on page 1‐21.
For more information about migrating, upgrading, installing and
configuring Advance NDC, refer to the APTRA Advance NDC,
Developer’s Guide.
For more information about the Advance NDC worker classes used
in the authored projects, refer to the APTRA Author Help.

When the SST is switched on and the Advance NDC software is

SST Operation 1

loaded, a power‐up message is sent to the host application. The host

application downloads any necessary data to the SST in a series of
messages that are acknowledged by the SST. When the host
application has sent all of the customisation data successfully, it
puts the SST into service.
During a consumer session, the SST gathers transaction details and
sends the details in a Transaction Request message to the host
application. When the SST receives a Transaction Reply command
from the host application, it completes the transaction.
If a fault occurs during a transaction, the SST sends a message to the
host application and waits for another Transaction Reply command,
authorising it to complete the transaction another way. Once the
transaction has been completed, the SST sends a confirmation
message to the host application.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-3

Introducing Advance NDC
The Advance NDC Product

The SST sends solicited status messages to the host in response to

terminal commands and requests for information. The SST also
sends unsolicited status messages to the host to report unexpected
events.
In addition, local transactions can be completed without host
interaction, for example, foreign currency transactions.

The host application is not part of the Advance NDC package but it
Host Application 1

is briefly described here to provide a fuller picture of the Advance

NDC software system.
The host application receives Transaction Request messages from
the SST and determines whether the transaction should be
approved or declined. It controls the SST by sending terminal
commands to it and acting on responses received.
The host application must be able to decode and act on messages it
receives from the SST. It must also be able to code messages in the
format that the Advance NDC software running on the SST can
understand—the NDC message format.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-4 APTRA Advance NDC, Overview

 Introducing Advance NDC
Benefits of Advance NDC

Benefits of Advance NDC 1

The Advance NDC vendor‐independent application for

multi‐vendor environments can accommodate the requirements of
the following groups of users:
 Users requiring a self‐service application running on a Microsoft
Windows operating system
 Users with older versions of Advance NDC
 Users of NDC+ who wish to migrate to Advance NDC
 Anyone who wants to use the NDC message interface
Advance NDC offers direct benefits for all groups, and particular
benefits for existing users of Advance NDC or users of other
vendors’ self‐service applications.

As well as being a vendor‐independent application complying with

Direct Benefits of Advance CEN‐XFS 3 for use in a multi‐vendor environment, Advance NDC
NDC 1
offers the following:
 Support for the latest SSTs from NCR and other vendors
 Integration with APTRA Connections, a web‐based service,
allowing it to process transactions initiated at the SST through
Advance NDC
 Integration of fault display into the Supervisor interface
 Flexibility in supporting new features
 A straightforward upgrade path for users who intend to
implement the application without any modification
 Various methods for enhancing or extending the Advance NDC
application including an authoring environment.
For more information, including the changes required to upgrade a
modified Advance NDC application, see Chapter 2, “Upgrading
from Earlier Releases of Advance NDC”.

Authoring Environment 1

NCR recommends the use of routines written in C (C‐Exits) to

extend the functionality of APTRA Advance NDC, but existing
authored states can be modified using the APTRA Author.
The authoring environment provides a graphical development tool
for a paperless approach to developing enhancements to or
modifying Advance NDC. It also provides the following:
 Simulation and testing on a development PC
 A range of multimedia formats with multimedia control using
authored workers

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-5

Introducing Advance NDC
Benefits of Advance NDC

 Integration with other development tools that are compliant

with ActiveX.
For more information about the Author, refer to the APTRA Author,
User’s Guide.

For existing users of NDC+, Advance NDC offers the following:

Benefits for NDC+ Users 1

 Maintenance of the existing NDC message structure and, as far

as possible, the existing message content.
 More flexibility than the NDC+ product offers
 Migration of the SST application from an OS/2 environment to a
Windows environment
 No loss of investment made in host or switch systems
 Support for the following NDC+ customisation data:
— State Types
— Screen Data
— Printer Data
— Configuration Parameter
— Financial Institution Tables
— Keyboard Data, except for downloadable keyboards
 Support for NDC+ Exits (but changes are required for Exits that
interact with devices, as access to devices is now through the
CEN‐XFS interface)
 Support for NDC Supervisor capabilities
 Compatibility with the NDC programming model of States and
Screens
 Support for more graphics formats, without requiring any
change in NDC+ screen definitions.
For a comparison of the features offered by NDC+ and Advance
NDC, see Chapter 3, “Migrating from NDC+ to Advance NDC”.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-6 APTRA Advance NDC, Overview

 Introducing Advance NDC
New Features and Changes in Advance NDC

New Features and Changes in

Advance NDC 1

This section gives an overview of the new features and changes

provided in this release of Advance NDC.

This release of Advance NDC supports the following new features:

New Features 1

Card Eject State 1

A new state, the Card Eject State, is used to eject a card. It also has a
timeout option to either leave the card or capture the card on
timeout.

Disable Clear Key in PIN Entry State 1

Advance NDC can be configured through a registry to disable the

Clear key in the PIN Entry state.

Fixed Cassette Mapping for BRM 1

The mapping of cash‐in NDC cassette types to XFS logical cash units
can be fixed. If defined, the fixed mapping overrides the automatic
cassette mapping.

Update GBXX Cassette Configuration Sets

from Supervisor 1

Advance NDC can be configured to view and apply the GBXX

cassette configuration sets present in the XML file through the
supervisor option 39 GBXX CONFIG.

GBXX Device with Not Configured Cassettes 1

The GBXX devices when configured in recycle mode continue to be

operative even when any of the cassettes that are not configured are
present in the device. The INIT BNA, CLR BNA, ADD CASH and
CLR CASH Supervisor options can be performed successfully.

Capturing Bunch Note Image 1

On a BRM device, Advance NDC supports capturing the image of

bunch of notes through a camera present at the entry or exit slot.
The application copies the captured images in a specific path with a
specific file format.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-7

Introducing Advance NDC
New Features and Changes in Advance NDC

EPP 1

At the start of day, if the EPP is not detected, the application loads
successfully.
If the EPP is not detected or goes fatal, the application either stops
or allows further transactions through a registry setting.

E‐Receipt 1

Advance NDC sends the e‐receipts data to the CxM component that
delivers the data to the CxM server. The CxM server sends e‐receipt
as an SMS/email to the consumers.

Exiting from A‐Card Read and T‐Card Read‐PIN Entry

Initiation States 1

A new API is used to exit from A‐Card Read State and T‐Card
Read‐PIN Entry Initiation State.

Configuring Reject and/or Retract Bin for 

Depositing Notes 1

In a deposit transaction, reject and/or retract bins can be configured

to accept notes when there is a bin overflow and there are no other
usable recycling and/or cash‐in cassettes available.

Map Entire Touch Area to FDK D 1

Advance NDC can be configured to map the entire touch area on

the screen to FDK D for cardless transactions in the Card Read state.

This release of Advance NDC supports the following updated

Updated Features 1

features:

Uninterruptible Power Supply (UPS) 1

Advance NDC can be configured through a registry to keep the SST

either in service or out of service when the mains power is active
and the UPS battery level is below the low threshold.

Local Cash Dispense State 1

By default, Advance NDC doesn’t support Local Cash Dispense

State. If you need to use this functionality, please contact NCR FSE
Product Management.

Serial Number Information 1

Journaling Location Advance NDC journals location information 1

of notes along with the serial number in both deposit and dispense
(only in a BRM device) transactions in the EJ.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-8 APTRA Advance NDC, Overview

 Introducing Advance NDC
New Features and Changes in Advance NDC

Logging to the ECB6 Database On a BRM device, the serial 1

number information of the deposited notes is logged to the

ECB6Log database file.
File Name of the Serial Number Image In a deposit transaction, 1

the file name of the captured serial number image is formatted with
details like operation type and machine number. The file name can
also be journaled to the EJ along with the existing serial number
information.
Archiving and Deletion of SNR Image Files Advance NDC can 1

be configured to archive and delete the SNR image files.

Journaling the Summary of Presented 

and Retracted Notes 1

On a BRM device, if two stage retract is enabled and there is a

mismatch in presented and retracted notes, the summary of the
presented and retracted notes is journaled.

Journaling the Count of Notes that Pass 

through the Bill Validator 1

In a deposit transaction, when a hardware error occurs, the count of

notes that pass through the bill validator is journaled irrespective of
whether the notes are moved to escrow/cassettes. Also, the
information is stored in CDIs.

Retain Destination for the Notes in Escrow (Close state) 1

In the Close state, the retain destination for the notes in escrow can
be configured to either retract bin or deposit cassettes.

Journaling the Rejected Counts in CLR CASH And STD

CASH Supervisor Options 1

Along with the existing dispense counters, the CLR CASH and STD
CASH supervisor options will now journal the rejected counts
before clearing the counters.

Count of Notes in Unknown Location 1

In a dispense transaction, if a hardware error occurs after the notes

are picked from the cassette and the notes are neither presented to
the customer nor moved to any cassette, the notes count is reported
as unknown location.

Fault Display 1

The fault display for Cheque Processing Module is enhanced to

show the bin door status.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-9

Introducing Advance NDC
New Features and Changes in Advance NDC

Log Signatures of Good Notes in a Deposit Transaction 1

Advance NDC can be configured to log signatures of good notes to

the ECB6Log database file in a deposit transaction.

Report Counts Per Operation 1

Advance NDC can be configured to report either counts per

operation or cumulative counts for a transaction for counterfeit and
suspect notes.

Handling the Incorrect Denomination

and Short Dispense 1

On a BRM device, when a dispense is attempted from a cassette and

an incorrect denomination note is found, then the note is moved to
the cassette configured for that denomination. When a cassette
contains insufficient notes (short dispense) then the notes are
moved either to the configured cassette or reject bin as per the
registry setting.

Interaction with Contactless Cad Reader 1

Advance NDC supports interaction with the contactless card reader

device through the XFS session or the wrapper session. By default,
the application interacts with the device through the XFS session.
Interaction with the device through the XFS session supports the
contactless card reader on the other vendors’ SST.

Controlling the Card Entry Retries 1

The number of card entry retries can be restricted in the Insert Card
State (z008) through a registry configuration when a card is misread
due to an invalid card or a mechanism error.

Journaling Supervisor Mode Change 

During a Transaction 1

During a transaction, whenever a supervisor mode change is

attempted either using the supervisor switch, opening the safe door
or cabinet door, Advance NDC journals this mode change status in
the EJ to identify it as a fraudulent activity.

Journaling Security Trace Message 1

When a cash‐in cassette is inserted or removed, along with the

tamper and sensor status reporting, a security trace message is also
journaled.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-10 APTRA Advance NDC, Overview

 Introducing Advance NDC
New Features and Changes in Advance NDC

Journal and Print Refund Reply 1

In a deposit transaction, when refund reply is received from the host

and notes are refunded, Advance NDC prints the receipt and
journals data which is supplied in refund transaction reply
command irrespective of the notes are taken or not.

Report Reject Bin Count as UNKNOWN 1

Advance NDC reports the reject bin count as UNKNOWN when an

invalid note is moved to the reject bin and reports in the DSP BNA
CNTS and the PRN BNA CNTS.

Journaling the Count of Notes When a 

Present is Attempted Before Power Failure 1

In a dispense transaction, when a present is attempted and a

power‐fail occurs before notes are presented, then after restart,
application journals the count of notes that are requested from each
cassette type in the EJ.

Default Network Connection 1

Advance NDC automatically determines and applies the default

network connection based on the operating system of the SST i.e.
Ethernet for Windows 10 and Local Area Network for Windows 7.

Voice Out Entered Key 1

Advance NDC can voice out either the entered cumulative data or
the last entered key, when the entry mode is configured to numeric
key entry in the Information Entry state.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-11

Introducing Advance NDC
Prerequisite Knowledge and Training

Prerequisite Knowledge and

Training 1

This section describes the prerequisite knowledge and

recommended training that is required for Advance NDC.

Before using Advance NDC on a development system, the

Development following knowledge and experience are required:
Environment 1

 Knowledge of the SSTs on which Advance NDC will run (for

instance, NCR 56XX, Personas or SelfServ™ Series)
 Knowledge of the CEN‐XFS interface specification, release 3.0x
 Experience of using Windows operating systems
 For testing on a development PC, knowledge of the XFS
Simulator for APTRA

To install and configure Advance NDC on an SST network, the

SST Installation and following are required:
Configuration 1

 Familiarity with the different types of installation process that

can be used to install Advance NDC
 Knowledge and experience of the APTRA Aggregate Builder
and APTRA XFS
 Knowledge and experience of using Windows 7 or Windows 10
to install and configure SST networks
 Knowledge and experience of Windows 7 and/or Windows 10

NCR recommends that NCR associates, partners and customers

Training 1

complete appropriate training as follows:

 NCR associates supporting APTRA Advance NDC: 
complete the curriculum “Supporting APTRA Advance NDC
for a Technical Audience”.
 NCR partners: 
complete the curriculum “25731 APTRA Advance NDC
Certification Program”.
 NCR customers: 
contact your local NCR office to arrange a suitable training
programme.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-12 APTRA Advance NDC, Overview

 Introducing Advance NDC
Prerequisite Knowledge and Training

A full list of courses, including other useful courses such as those for
Bunch Note Acceptor (BNA) and Bunch Recycling Module (BRM)
devices, voice guidance, S2 dispensers, Display Manager, Scalable
Deposit Module (SDM)/SDM2, is available on the NCR University
web site (registered users only).

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-13

Introducing Advance NDC
Hardware and Software Requirements

Hardware and Software

Requirements 1

This topic describes the hardware and software required to run

Advance NDC in a development environment and in a runtime
environment on NCR SSTs.

Hardware requirements for development PCs and runtime SSTs are

Hardware Requirements 1

listed in the following tables.

NCR recommends that you have as high a specification as possible,
particularly if you wish to perform more than basic cash dispensing,
are using HTML screens or if you are planning to run Solidcore for
APTRA, which offers additional security.

Development System (PC) 1

The following tables show the minimum and minimum

recommended hardware configuration to run Advance NDC on a
development system with Windows 7 (32‐bit or 64‐bit) or 64‐bit
Windows 10.

Table 1-1
Development System Hardware 
(32-Bit or 64-Bit Windows 7)

Hardware Minimum Minimum Recommended for Advance NDC

Processor 1 GHz or faster 2.4 GHz or faster 

or 
Intel® Core™2 Duo, 2.13 GHz

RAM 1 GB 2 GB

Fixed disk 20 GB or above 80 GB or above

Load devices CD drive or a network connection to  CD drive or a network connection to the

the destination SST destination SST
 DVD drive or other removable storage
device

Video card DirectX 9 graphics device with WDDM DirectX 10 or higher for optimal performance
1.0 or higher driver

Display SVGA colour monitor XGA colour monitor (1280 x 1024)

See Note:

Keyboard PC keyboard PC keyboard

Mouse Microsoft compatible mouse Microsoft compatible mouse

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-14 APTRA Advance NDC, Overview

 Introducing Advance NDC
Hardware and Software Requirements

Table 1-2
Development System Hardware 
(64 -Bit Windows 10)

Hardware Minimum Minimum Recommended for Advance NDC

Processor 1 GHz or faster 2.4 GHz or faster

RAM 2 GB 3 GB
Fixed Disk 20 GB or above 80 GB or above

Load Devices CD drive or network connection to  CD drive or a network connection to the

destination SST destination SST
 DVD drive or other removable storage
device

Display SVGA colour monitor XGA colour monitor (1280 x 1024)

See Note:

Keyboard PC keyboard PC keyboard

Mouse Microsoft compatible mouse Microsoft compatible mouse

Note: To use the APTRA Author, the graphics card must be capable
of a minimum screen resolution of 1024 x 768 using the High Colour
(16 bit) palette.

Runtime System (SST) 1

The following tables show the minimum hardware configuration

for running Advance NDC on NCR SSTs with cash acceptors and
without cash acceptors. For other vendorsʹ hardware requirements,
refer to their documentation and ensure that the hardware
specifications used are similar to those recommended for NCR SSTs.

Note: With the minimum requirements, performance may be

affected.

Table 1-3
NCR SSTs: Runtime System Hardware 
(with Cash Acceptor)

Minimum Requirement for Minimum Requirement for 64-bit

Hardware
32-bit or 64-bit Windows 7 Windows 10

Motherboard Talladega/Pocono Falcon

Processor Conroe L440 2 GHz Intel(R) Core(TM) i3‐4350T

RAM 2 GB 4 GB

Fixed Disk 80 GB or above 80 GB or above

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-15

Introducing Advance NDC
Hardware and Software Requirements

Minimum Requirement for Minimum Requirement for 64-bit

Hardware
32-bit or 64-bit Windows 7 Windows 10

Load Devices A DVD drive or other removable storage A DVD drive or other removable storage
device device

Front Display VGA VGA

Rear Display GOP GOP

Table 1-4
NCR SSTs: Runtime System Hardware 
(no Cash Acceptor)

Minimum Requirement for 32- bit or 64-bit Minimum Requirement for 64-bit
Hardware
Windows 7 Windows 10

Motherboard Talladega Falcon

Processor Conroe L440 2 GHz Intel(R) Core(TM) i3‐4350T

RAM 2 GB 4 GB

Fixed Disk 80 GB or above 80 GB or above

Load Devices A DVD drive or other removable a DVD drive or other removable storage device
storage device

Front Display VGA VGA

Rear Display GOP GOP

NCR also recommends that each SST has an uninterruptible power

supply (UPS).

Note: On an NCR development SST, use a PS/2 or USB type mouse

since a Bus Adapter mouse may clash with the touch‐screen device.

Before installing Advance NDC on a development or runtime

Software Requirements 1

system, one of the software environments given in the following

tables “Development System Software Requirements” and
“Runtime System: Software Requirements” must be installed. For
additional information, refer to the Advance NDC Release Bulletin
which is available on the Advance NDC CD‐ROM. After the
prerequisite software is installed, you can install Advance NDC.

Note: Advance NDC supports only the English version of the

supported Windows operating systems.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-16 APTRA Advance NDC, Overview

 Introducing Advance NDC
Hardware and Software Requirements

Development System (PC) 1

On a development PC, you need at least the software shown in the

following table:

Table 1-5
Development System Software
Requirements

Requirements Windows 7 Windows 10 Comment

Operating System Windows 7 64‐bit Windows 10 —

Professional
32‐bit and 64 ‐bit

Programming  Microsoft  Microsoft  Used to modify the supplied Advance

and Testing Visual Studio 2015 Visual Studio 2015 NDC applications and to build the final
Environment with Update 3 with Update 3 applications and ActiveX controls
See Note:

Browser Internet Explorer 11 Internet Explorer 11 —

or later, with the or later, with the
latest service pack latest service pack

Platform APTRA XFS APTRA XFS for Optional

06.06.00 Windows 10 Used to extend Advance NDC with
(01.01.00/ 01.02.00/ user‐written routines
01.02.01)

PDF Viewer Adobe Reader 7.0 or Adobe Reader 7.0 or Available free from www.adobe.com
later later

SST Device APTRA XFS APTRA XFS Used to test an authored application in a
Simulation Tool Simulator 04.02.00 Simulator 04.03.00 development environment with
simulated devices
The APTRA XFS Simulator is not
provided with Advance NDC but must
be purchased separately if required

WinHelp Viewer Install the Windows Not Supported Used to view the APTRA Author help
Help program
(WinHlp32.exe) as
described at
http://www.microsoft.
com/en‐us/download/
details.aspx?id=91

Configuration Run the APTRA Run the APTRA —

Author and the Author and the
Advance NDC Advance NDC
application as application as
Administrator Administrator

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-17

Introducing Advance NDC
Hardware and Software Requirements

Note: The Microsoft Foundation Classes (MFC) for C++ library is

required to build Author and C‐Exits. The Visual Studio 2015
installation doesn’t include MFC, by default. Make sure that the
MFC library is included while installing Visual Studio 2015.

Runtime System (SST) 1

On an SST, you will need at least the software shown in the

following table:

Table 1-6
Runtime System: Software Requirements
NCR SSTs Other Vendors’ SSTs

Operating System Windows 10 IOT Enterprise 64‐bit ‐ 2016 Latest version of Windows 10 as supplied by
LTSB (1607) (see Note:) the vendor of the SST

NCR Windows 7 Professional (32‐bit or —

64‐bit) (see Note:)

Windows Embedded POSReady 7 (32‐bit or —

64‐bit) (see Note:)

Platform APTRA XFS 06.06.00 on Windows 7 and APTRA XFS equivalent, including a CEN‐
APTRA XFS for Windows 10 01.01.00/ XFS 3 interface
01.02.00/ 01.02.01 on Windows 10 (CEN‐XFS compliant service providers must
(must be ordered as a separate product and be installed before Advance NDC)
must be installed before Advance NDC)

Browser Internet Explorer 11 or later, with the latest Internet Explorer 11 or later, with the latest
service pack service pack

Note: Registered users can obtain the operating systems listed in

the table from the NCR Download Center. If you do not have access,
please contact NCR Solutions Management or your NCR Account
Manager.

Unattended Installation 1

Unattended installation is the installation of all required software

on an SST without local operator interaction.
For unattended installation on an SST, requirements are provided in
the following documentation:
 The APTRA Advance NDC Developer’s Guide
 The on‐line help documentation provided with the Initial
Unattended Installation component
 The on‐line and PDF documentation provided with APTRA
Security
 For NCR SSTs, the Installation and Configuration topic of the
APTRA XFS on‐line documentation.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-18 APTRA Advance NDC, Overview

 Introducing Advance NDC
Hardware and Software Requirements

These publications can be obtained through a Documentation‐Only

installation of the software products or for internal users with access
to the NCR intranet, from the Information Products web site.

The following table summarises the operating systems, CEN‐XFS

Operating Environment 1

platforms, communications protocols and support for EMV

integrated circuit cards typically used in a development
environment or a runtime environment (NCR SSTs).

Table 1-7 Development NCR SSTs

Platform
Operating Environments for Development Environment Runtime
PC and NCR SSTs
64‐bit Windows 10 and the required Y N
version of the APTRA XFS Simulator
(See Table 1‐5)

NCR OEM 64‐bit Windows 10 and N Y

APTRA XFS for Windows 10 01.01.00/
01.02.00/ 01.02.01 on Windows 10

Windows 7 Professional (32‐bit or Y N

64‐bit) and the required version of the
APTRA XFS Simulator (See Table 1‐5)

Windows 7 Professional (32‐bit or N Y

64‐bit) or Windows Embedded
POSReady 7 (32‐bit or 64‐bit) and
APTRA XFS 06.04.xx, 06.05.00 or
06.06.00

Communications protocols supported N Y

by APTRA CCM

Windows 10 and Windows 7: N Y

EMV/CAM2 Exits for APTRA Advance
NDC 04.00.00 or above

Operating Environment on Other Vendors’ SSTs 1

The following environment is supported on other vendorsʹ

hardware:
 Service Providers compliant with CEN XFS 3.0x except for the
below
 IPM (Item Processing Module) SP compliant with CEN XFS
3.20
 Below service providers are compliant with CEN XFS 3.30
 IDC (Identification Card Device)
 Card Reader
 Cash Dispenser (CDM)
 Pin keypad

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-19

Introducing Advance NDC
Hardware and Software Requirements

Receipt Printer


 CIM (Cash‐in Module)

 Communications protocols 
APTRA CCM TCP/IP and Dialup

Note: Support of dial up in 64‐bit systems (Windows 7 or

Windows 10) is not available. For more information, please
contact NCR FSE Product Management.

 EMV Exits for Advance NDC

— For Windows 10 and Windows 7
EMV/CAM2 Exits for APTRA Advance NDC 04.00.00 or above.

Note: Other vendors have their own service provider

implementations and may offer different operating system
environments for SSTs.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-20 APTRA Advance NDC, Overview

 Introducing Advance NDC
Advance NDC Architecture

Advance NDC Architecture 1

Advance NDC consists of the following application and modules

developed using the APTRA Author:

Table 1-8 Authored Application Function

Authored Applications for Advance NDC
Application Core Single executable. Performs background
processing activities and controls the
Supervisor and Customisation Layer
application DLLs
Supervisor Application DLL. Performs the SST
out‐of‐service activities associated with
Supervisor or operator functions
Customisation Layer Application DLL. Performs the
in‐service activities associated with the
consumer

The Customisation Layer has been modularised, with separate

application DLLs for state types and Transaction Reply functions,
which can be loaded at start of day or only when required,
depending on the need for fast performance or a small footprint in
memory. This modularisation simplifies maintenance and
modification since the Customisation Layer is now very small and
need not be updated by NCR. It allows any customisation to remain
localized to the area of customisation.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-21

Introducing Advance NDC
Advance NDC Architecture

Figure 1-1
Advance NDC Application Architecture
Advance NDC

Customisation Supervisor
Layer

Application
Core

Host
Application

Application Core 1

The Application Core is responsible for controlling the transitions

between the various modes the SST can enter, as well as performing
the functions of each mode.
The Application Core handles (accepts or rejects) incoming
messages from the host application according to the content of the
message, and the current mode of the SST.
The host application can send the following types of messages to the
SST:
 Terminal Commands—sent by the host to start up or shut down
the SST, or to request information such as the SST configuration
or supplies status
 Customisation Data Commands—sent by the host to provide
different types of data such as configuration data, screens and
states
 Transaction Reply—sent by the host in response to a transaction
request, authorising the transaction
 Host to Exit—data sent by the host to a user‐defined routine
(exit)
The Application Core also allows a new message class to be
processed or data to be added to terminal state messages.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-22 APTRA Advance NDC, Overview

 Introducing Advance NDC
Advance NDC Architecture

Supervisor 1

The Supervisor is activated by the Application Core. When an SST is

switched to Supervisor mode, out‐of‐service activities such as
replenishment of supplies and routine maintenance can be
performed.

Customisation Layer 1

The Customisation Layer is driven by the Application Core. It

performs the in‐service activities associated with the cardholder,
such as card reading, PIN acceptance and cash dispensing. Any
processing performed by the Customisation Layer can only be done
while the SST is in In Service mode.
The Application Core drives the Customisation Layer by
communicating in‐service and out‐of‐service mode changes to the
Customisation Layer. However, the Customisation Layer will only
allow changes from In Service mode when it is suitable, not in the
middle of a cardholder session.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-23

Introducing Advance NDC
Creating an Advance NDC System

Creating an Advance NDC System 1

There are two distinct tasks in creating an Advance NDC system:

 Creating the customisation data
 Creating the host application.
Except for cardholder keyboard downloads, Advance NDC
supports the existing NDC+ customisation data, and also offers
additional mechanisms for customisation. For more details refer to
chapter 1 “Introducing Advance NDC” and chapter 3 “Migrating
Existing NDC+ Applications to Advance NDC” in the APTRA
Advance NDC, Developer’s Guide.
Cardholder keyboards are configured locally on the SST, and not
downloaded. Function Display Key (FDK) associations, however,
can be downloaded. For more information, refer to the APTRA
Advance NDC, Reference Manual and chapter 5 “Configuring
Advance NDC and Associated Components” in the APTRA Advance
NDC, Developer’s Guide.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-24 APTRA Advance NDC, Overview

 Introducing Advance NDC
Modifying Advance NDC

Modifying Advance NDC 1

Various options exist to modify Advance NDC, as follows:

 Customising the configuration with data downloads from the
host
 Enhancing existing functionality by altering existing C‐Exits,
authored Exits or Workers
 Extending the functionality of Advance NDC with new C‐Exits,
new authored Exits or new worker classes
In a multi‐vendor environment, the following can be modified for
other vendors’ hardware:
 Printer data
 Operator screen layout
 Cardless settlement screen text for Supervisor transactions
The following sections briefly introduce enhancement options.

Advance NDC supports all the standard NDC+ customisation

Customising Advance downloads using the following:
NDC 1

 Screen downloads
 Configuration parameters download
 Option digits
 Option digits that are configurable through Supervisor
 Reserved screens

Modifying existing C‐Exits, Authored Exits or Workers lets you

Enhancing Advance NDC 1

alter the Advance NDC applications to suit your individual

requirements.

Enhancing the Customisation Layer 1

The Customisation Layer is now very small and the state type
functionality has been modularised to simplify maintenance and
modification. Any change made to the Customisation Layer will not
breach the format of NDC terminal to host messages. However, any
changes must follow the recommendations given in the APTRA
Advance NDC, Developer’s Guide, to minimise rework when
upgrading to a future release of Advance NDC.

Enhancing the Application Core and Supervisor 1

The Application Core does not usually require enhancement as

most enhancements are made to the Customisation Layer.
However, recognising that some users may wish to make changes in

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 1-25

Introducing Advance NDC
Modifying Advance NDC

modes other than In Service, NCR have allowed for enhancement of

the Application Core and Supervisor.
The Application Core offers the facility to add additional data to
Terminal State messages.

Extending an Advance NDC application lets you provide new

Extending an Advance functionality by creating C‐Exits or new worker classes. The
NDC Application 1
advantage of using C‐Exits is that these do not have to be
re‐implemented for subsequent releases of Advance NDC. If the
application cannot be extended using C‐Exits, it can be extended
using the Author.

Examples of Extending an Advance NDC Application 1

For each subsequent release, the authored Advance NDC

applications can be extended as follows:
 In the Customisation Layer, new cardholder services and
transactions can be provided and incorporated into an existing
NDC state flow with no impact to the rest of the application
 In the Application Core, new message classes can be added
 In the Supervisor application, the out‐of‐service functionality
can be extended by adding new operator functions
For more information about using C‐Exits or the Author to extend
or modify an Advance NDC application, refer to the following
publications:
 APTRA Advance NDC, Extending the Product
 APTRA Author, User’s Guide
Any extension to the Customisation Layer, Supervisor or
Application Core must follow the guidelines given in the APTRA
Advance NDC, Developer’s Guide. This will ensure the core
functionality (mode handling and existing messages) remains intact.
Also, it will help reduce re‐implementation work as all extensions
implemented using the Author will have to be re‐applied to future
releases of Advance NDC or service pack updates.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

1-26 APTRA Advance NDC, Overview

 Table of Contents
Upgrading from Earlier Releases of Advance NDC

Chapter 2
Upgrading from Earlier Releases of
Advance NDC

Overview 2‐1

Compatibility with Single‐Vendor Releases of Advance NDC 2‐2

Configuration Options 2‐2
Device Access 2‐2
Fault Display 2‐2
State Tables 2‐2

Upgrading Your Application 2‐3

Modified Applications 2‐3
C‐Exits 2‐3
Author Workers 2‐3
User Messages and User Terminal Data 2‐4
Promote Campaigns 2‐4

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

Table of Contents
Upgrading from Earlier Releases of Advance NDC

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

 Upgrading from Earlier Releases of Advance NDC
2

Overview

Overview 2

The work required to upgrade from a previous version of Advance

NDC depends on how much your Advance NDC application has
been modified.
This chapter gives an overview of the issues to consider when
upgrading your Advance NDC application. For details, refer to the
following publications:
 APTRA Advance NDC, Developer’s Guide
 APTRA Advance NDC, Multi‐Vendor Support Reference Manual.
The APTRA Advance NDC, Developer’s Guide describes what has to
be done for Advance NDC on NCR SSTs, covering common
information that also applies to Advance NDC on other vendors’
SSTs. The APTRA Advance NDC, Multi‐Vendor Support Reference
Manual describes the differences, exceptions and additional
configuration that apply to other vendors’ SSTs.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 2-1

Upgrading from Earlier Releases of Advance NDC
Compatibility with Single-Vendor Releases of Advance NDC

Compatibility with Single‐Vendor

Releases of Advance NDC 2

Multi‐vendor Advance NDC, introduced in release 3.00, runs on

both NCR and other vendors’ SSTs that are compliant with CEN
XFS 3. It is functionally compatible with single‐vendor versions of
Advance NDC.

Multi‐vendor Advance NDC supports all configuration options,

Configuration Options 2

communications protocols and message formats between the host

application and the SST except for the following:
 Cancel/Clear swap option
 Upload of tallies and error logs.
These restrictions are due to the constraints of the CEN‐XFS
specification. Any change to keyboard layouts must be performed
as part of the service provider configuration.

Access to all devices is through the CEN‐XFS interface.

Device Access 2

All the device status information is provided through XFS. On NCR

Fault Display 2

SSTs, vendor‐specific information is also available, so the status

information is virtually unchanged from previous releases.
On other vendors’ SSTs, the messages indicate the device or device
type and, where possible, give extra details to help the operator to
identify the failure. The constraints of the CEN‐XFS specification
affect the information that can be provided. The provision of values
for the fields in the device status messages reflects what can be
provided in an XFS environment.

Multi‐vendor Advance NDC can accept the download of all the

State Tables 2

state tables supported by Advance NDC 2.x. There are additional

states supported for new functionality.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

2-2 APTRA Advance NDC, Overview

 Upgrading from Earlier Releases of Advance NDC
Upgrading Your Application

Upgrading Your Application 2

If you are currently using the Advance NDC application as

provided by NCR without any changes, you will be able to upgrade,
install and run an equivalent application on your NCR SSTs with
minimal changes.

For a modified Advance NDC application, changes will be required

Modified Applications 2

for the following and you will need to determine what has to be
done to upgrade successfully:
 C‐Exits
 Workers
 User Messages or User Terminal Data Messages, for releases
prior to Advance NDC 2.06.

Note: If you intend your end solution to be compliant with the

Payment Card Industry Data Security Standard (PCI DSS), any
changes you make to Advance NDC must comply with the
requirements of the Payment Application Data Security Standard
(PA‐DSS). For further information, refer to the following
publications:

 APTRA Advance NDC, Developer’s Guide, Appendix E, “PCI DSS

& PA‐DSS Compliance in Advance NDC”
 APTRA Advance NDC, Payment Application Data Security
Standard, Implementation Guide.

C‐Exits 2

All C‐Exits that were used with Advance NDC prior to release 3.02
must be recompiled using Microsoft Visual Studio 2015.
Any C‐Exit implementing ADI2 (Application Device Interface)
device functionality will have to be re‐implemented as access to all
devices is now through the CEN‐XFS 3 interface.

Note: For 32‐bit operating system, all C‐Exits must be installed to

and run from C:\Program Files\NCR APTRA\Advance NDC and for
64‐bit operating system from C:\Program Files (x86)\NCR
APTRA\Advance NDC on the SST and C:\NTGlobal\AANDCAPPS
on the development PC for both 32‐bit and 64‐bit operating systems.

Author Workers 2

If you have extended Advance NDC using any of the following, you
will have to check them for differences and change as necessary:

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 2-3

Upgrading from Earlier Releases of Advance NDC
Upgrading Your Application

 Your own new worker classes, particularly those implementing

ADI2 device functionality as access to all devices is now through
the CEN‐XFS 3 interface
 Worker classes that are no longer supported in Advance NDC
but have been replaced with new worker classes
 Worker classes that are still supported in Advance NDC but
have been modified.
For details of worker support in Advance NDC, refer to the APTRA
Author, User’s Guide.

Note 1: All modifications in the Author projects must be re‐applied

to the new release, even if they do not use devices at all. Old author
project files that have been modified cannot be used.

Note 2: For the structure of the authored applications, see

Chapter 1, “Advance NDC Architecture”.

User Messages and User Terminal Data 2

If you have created new message classes or included additional data

in Terminal State messages, the code must be imported into the
Application Core. For more information refer to section “User
Messages and User Terminal Data” in Chapter 4, “Upgrading from
Earlier Releases of Advance NDC” of the APTRA Advance NDC,
Developer’s Guide.

All Promote campaigns must be created using the appropriate

Promote Campaigns 2

version of APTRA Promote Manager. If you have existing

campaigns, you may need to recreate them.
For details of recreating campaigns, refer to the APTRA Promote
Manager User’s Guide.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

2-4 APTRA Advance NDC, Overview

 Table of Contents
Migrating from NDC+ to Advance NDC

Chapter 3
Migrating from NDC+ to Advance
NDC

Overview 3‐1

Reasons for Migrating to Advance NDC 3‐2

Comparing Advance NDC with NDC+ 3‐3

Operating Environments 3‐3
Features in NDC+ and Advance NDC 3‐4

Migrating to Advance NDC 3‐9

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

Table of Contents
Migrating from NDC+ to Advance NDC

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

 Migrating from NDC+ to Advance NDC
3

Overview

Overview 3

This chapter describes the advantages of Advance NDC for users of

NDC+. It outlines the reasons for migrating to Advance NDC,
compares NDC+ with Advance NDC and provides a brief overview
of the minimal work that is required to migrate to Advance NDC.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 3-1

Migrating from NDC+ to Advance NDC
Reasons for Migrating to Advance NDC

Reasons for Migrating to Advance

NDC 3

Advance NDC is a more flexible and open product than NDC+,

allowing a greater degree of enhancement using a variety of
methods.
Advance NDC allows development of special application features
which are beyond the standard NDC+ customisation capabilities.
Advance NDC lets you take advantage of the benefits offered by the
multi‐vendor environment without requiring changes to the host
application, or NDC+ customisation data.
Advance NDC is designed to help you to do the following:
 Move with technology and upgrade the resources on SSTs
 Move SSTs from the OS/2 platform to a Windows environment

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

3-2 APTRA Advance NDC, Overview

 Migrating from NDC+ to Advance NDC
Comparing Advance NDC with NDC+

Comparing Advance NDC with

NDC+ 3

For comparison purposes, where Advance NDC consists of an

application, two modules and a set of downloaded customisation
data, an NDC+ application can be considered as consisting of an
application core and a set of customisation data. In NDC+, the
application core was released as an executable only, providing fixed
behaviour; and the customisation data allowed a degree of
customer‐specific control of the terminal.

The following diagram compares the Advance NDC environment

Operating Environments 3

with the NDC+ environment on NCR SSTs.

APTRA XFS S4/S4I
Figure 3-1
Windows OS/2
Advance NDC and NDC+ Environments

Advance NDC SST NDC+ SST

Host
Host
Host

Advance NDC Exits Host NDC+ Exits

NDCADI ADI2

APTRA XFS S4/S4I

Windows OS/2

Advance NDC
Advance NDC Exits
Exits NDC+
NDC+ Exits
Exits
Advance NDC Exits NDC+ Exits
Advance NDC SST NDC+ SST
Advance NDC Exits NDCADI
NDC+
NDCADI
NDCADI ADI2
Exits
ADI2
ADI2

APTRAXFS
APTRA
APTRA XFS
XFS S4/S4IADI2
S4/S4I
NDCADIS4/S4I
Windows
Windows
Windows OS/2
OS/2
OS/2
APTRA XFS S4/S4I

Windows OS/2

AdvanceNDC
Advance
Advance NDCSST
NDC SST
SST NDC+SST
NDC+
NDC+ SST
SST

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 3-3

Migrating from NDC+ to Advance NDC
Comparing Advance NDC with NDC+

The following table summarises the features offered by NDC+, and

Features in NDC+ and compares them with those offered by Advance NDC. For more
Advance NDC 3
details of the specific differences, refer to the APTRA Advance NDC,
Developer’s Guide. For more information about new features
included in this release of Advance NDC, refer to Chapter 1, “New
Features and Changes in Advance NDC.”

Table 3-1
Comparison of NDC+ and Advance NDC
Features

NDC+ Features Advance NDC Features

Runs on S4 or S4I platforms. Runs on platforms compatible with CEN XFS 3.

Uses IBM OS/2 operating system. Uses Windows 7 (32‐bit or 64‐bit) or 64‐bit Windows 10
for the development system and NCR Original
Equipment Manufacturer (OEM) Windows 10 IOT
Enterprise 64‐bit 01.00.00 or Windows 7 NCR OEM or
Windows Embedded POSReady7 for NCR SSTs.

Uses the ADI2 interface for access to devices. Uses CEN XFS 3 for access to devices.

Enables connectivity with an NDC host Enables connectivity with an NDC host application and
application. CRM web‐based applications such as APTRA Relate.

Uses customisation data (such as states and Supports NDC+ customisation data, and provides the
screens) to customise the NDC+ terminal software. opportunity to use the visual programming model
offered by the Author.

Allows user‐written code (called NDC Exits) to be Supports C‐Exits, and enables additional Advance NDC
added to NDC+. authored enhancements.

Sends and receives messages of defined formats Supports all the NDC+ message formats that can pass
between the SST and the host application. between the host and the terminal, provides more
flexibility than NDC+, and is designed to prevent users
breaking the message interface.
Facilitates addition of a new message class, or additional
data to Terminal State messages.

Supports proprietary Antex audio files. Supports industry‐standard Sound Blaster Wave (.WAV)
and MIDI (.MID) files.
Supports Windows Media Player and an audio system
for voice guidance.

Supports proprietary VGM .ANI animation files Supports Microsoft animation (.AVI) and industry‐
and .FLI/C files. standard MPEG (.MPG) files (depending on the codec
that is installed).

‐ Supports additional graphics formats (for example: JPEG,

TIFF, GIF, PNG).

Supports Basic Operator Panel (BOP) interface and Supports the EOP interface, the Graphical Operator Panel
Enhanced Operator Panel (EOP) interface. (GOP) and on SelfServ 22e, the Compact Operator Panel
(COP).

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

3-4 APTRA Advance NDC, Overview

 Migrating from NDC+ to Advance NDC
Comparing Advance NDC with NDC+

NDC+ Features Advance NDC Features

Supports Document Processing Module (DPM) Supports the Coin Dispenser with support for up to eight
and Coin Dispenser. hoppers.

Supports spray cash dispenser. Supports spray cash dispenser.

‐ Supports dual cash handlers.

Supports S2 Media Dispenser Module.

‐ Supports cash acceptors, including NCR BNA, GBNA,

GBRU and BRM devices, including retract capability, for
up to 200 notes.

‐ Supports foreign currency exchange transactions on SSTs

that have both dispense and deposit capabilities.

‐ Supports Cheque Processing Module (CPM).

‐ Supports Bunch Cheque Acceptor.

‐ Enabled for Smart Card (EMV) support.

‐ Supports Dip And Smart Hardware (DASH) card readers

for EMV.

Supports up to two card readers, one a contact card

reader and the other a contactless card reader.

Supports EMV on contactless card readers.

Supports local functions such as foreign currency

exchange or receipt printing without the need for host
interaction.

Supports Scalable Deposit Module (SDM) for bunch

cheque deposit and note deposit.

Supports basic and enhanced Night Safe Supports Enhanced Night Safe.

Supports Door Access. Door Access is not supported in Advance NDC.

Supports Security Camera. Supports USB camera using the CEN XFS interface.

Supports CIM86. CIM86 is not supported in Advance NDC.

‐ TM‐Alert messages are not supported.

‐ PIN Entry States cannot use the Touch Screen.

Local State Of Health (SOH). Fault display is offered in Advance NDC to provide fault
reporting.

Supports Native and Diebold Emulation modes. Supports Native mode only.
See Note:

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 3-5

Migrating from NDC+ to Advance NDC
Comparing Advance NDC with NDC+

NDC+ Features Advance NDC Features

Supports IBM 3600 Loop communications. IBM 3600 Loop communications is not supported because it
has a restricted message length of 255 characters and requires
special treatment for all NDC messages.

Supports TCP/IP communications using the CCM TCPIP provides Communication Connection
TCP/IP Application Access Service. Management (CCM) for the TCP/IP protocol on all SSTs.
It supports communication using TCP/IP (Sockets 2).

Supports Band 1, 2 and 3 communications CCM PCCM provides CCM for the Personal Computer
Communication Module on NCR SSTs. It supports all
APTRA Communication Feature protocols.

Supports VISAII communications CCM VISA2 provides CCM for the VISAII protocol on all
SSTs. It supports communication using a subset of VISAII
over a dialup connection.

Provides Supervisor functions. Provides equivalent Supervisor functions and

customer‐specific functions can be added.

Replenishment status of cassettes is updated Replenishment status reporting can be configured to

following a note‐dispensing transaction report the actual status of all cassettes, not only those
only for cassettes used in the transaction. used during a transaction.

Provides extensive security features. Supports NDC+ security features, including secure PIN
entry.
The following PIN verification methods are not supported by
Advance NDC:
 Local Diebold PIN verification
 GBP PIN verification
 Atalla verification

‐ Complies with the Payment Application Data Security

Standard (PA‐DSS) and includes security updates to
facilitate and not prevent customer compliance with the
Payment Card Industry Data Security Standard (PCI
DSS) when deploying APTRA Advance NDC solutions.

From NDC+ 7.00.01 onwards with an Encrypting With an EPP, supports Triple DES encryption.
PIN Pad (EPP), supports Triple DES encryption.

From NDC+ 7.00.01 onwards with an EPP, RSA public key encryption is supported.
supports public key encryption.

From NDC+ 7.00.01 onwards with an EPP, With an EPP, encryption keys can be remotely distributed
encryption keys can be remotely distributed from from the host application.
the host application.

From NDC+ 7.00.01 onwards with an EPP, single With an EPP, single and double length encryption keys
and double length encryption keys can be used can be used and securely stored.
and securely stored.

The EPP supports the previous Hi Basic The EPP supports the previous HiBAPE encryption
Alpha‐Pinpad Encryptor (HiBAPE) and Encrypted standards.
Key Components (EKC) encryption standards. EKC is not supported.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

3-6 APTRA Advance NDC, Overview

 Migrating from NDC+ to Advance NDC
Comparing Advance NDC with NDC+

NDC+ Features Advance NDC Features

‐ Master key (Key A) and Communications key (Key B)

may be entered in two parts.

Electronic journal upload to the host application is Supports upload of the electronic journal to the host.
supported.

‐ Up to 1000 electronic journal backup files can be retained.

‐ Multiple destinations for electronic journal are

supported.

‐ Supports automatic initialisation and direct initialisation

of the electronic journal.

‐ Supports privacy and compression options for the

electronic journal.

Card fraud prevention can be supported if the card Card fraud prevention can be supported if the card
reader has an enhanced card device (ECD Jitter). reader has an enhanced card device.

Maximum state number of 750 is supported. Maximum state number of 46655 is supported.

‐ New state types may be authored or implemented as

Exits.

‐ Supports nested states, which lets an extension state call

any other extension state.

Third‐party fonts and character sets can be defined and

used in screens.

‐ Supports aggregate installation on the SST.

Supports custom screens and characters; up to 999 Supports custom screens and characters; up to 9,999
screens supported. screens supported.

‐ Supports the barcode reader, which provides

functionality to read two‐dimensional barcodes.

‐ Supports receipt retract, printer forms, and extended

journaling.

‐ Supports the cash‐in component.

Note: The NDC+ Diebold Emulation product cannot be migrated to

Advance NDC.
Advance NDC supports NDC+ Native mode only, including Native
mode status reporting. NDC+ Native mode offers more advanced
features than Diebold Emulation mode. If you currently use NDC+
Diebold Emulation and want advanced features, you can move to
Native mode.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 3-7

Migrating from NDC+ to Advance NDC
Comparing Advance NDC with NDC+

Any restrictions are summarised in the APTRA Advance NDC,

Developer’s Guide. More specific differences are documented in the
APTRA Advance NDC, Reference Manual.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

3-8 APTRA Advance NDC, Overview

 Migrating from NDC+ to Advance NDC
Migrating to Advance NDC

Migrating to Advance NDC 3

As the Customisation Layer application executes an entire NDC+

State flow, migrating existing NDC+ applications requires minimal
effort. You do not need to modify the download, nor is there any
need to make changes using the APTRA Author until you wish to
enhance Advance NDC. For more information, see “Creating an
Advance NDC System” on page 1‐24.
You will need to recreate files such as graphics and animation files.
If you have edited the resrvd.def file, you will need to redo the edits
or use an additional reserved file to update it. If your NDC+
application makes use of Exits, you will need to examine how they
are affected and make any necessary changes. For details, refer to
the APTRA Advance NDC, Extending the Product.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 3-9

Migrating from NDC+ to Advance NDC
Migrating to Advance NDC

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

3-10 APTRA Advance NDC, Overview

 Table of Contents
The Advance NDC Package

Chapter 4
The Advance NDC Package

Overview 4‐1

Advance NDC Package Contents 4‐2

Advance NDC Installation 4‐2
Installation Types 4‐2
Components in the Advance NDC Aggregate 4‐3
Optional Aggregates and Components 4‐4
Building a Custom Aggregate 4‐4

Component Overviews 4‐5

.NET 2.x Runtime 4‐5
.NET 4.x Runtime 4‐5
.NET Activate Core Service 4‐5
.NET Assemblies for Advance NDC 4‐5
Advance NDC Cash‐In 4‐5
.NET Archive Manager 4‐5
.NET Cash Accept Service 4‐6
.NET Class Configurator 4‐6
.NET PD Collection 4‐6
.NET PDC Support Tasks 4‐6
.NET Retrieve Archive Tasks 4‐6
.NET Promote Supervisor Tasks 4‐6
.NET ECB 6 Cash Accept Service 4‐6
.NET ImageMark Deposit Recorder 4‐6
.NET Bunch Cheque Acceptance Service 4‐6
.NET CCM TCPIP 4‐7
.NET TCPIP Support Tasks 4‐7
.NET Codeline Cheque Validator 4‐7
.NET NDC CRM Service 4‐7
.NET Common States 4‐7
.NET Targeted Marketing Promote 4‐7
.NET Targeted Marketing Customer Power 4‐7
.NET Relate Supervisor Tasks 4‐8
.NET CIM Configuration Tasks 4‐8
.NET Signature Verification Service 4‐8
.NET CxM Content Deployer Service 4‐8

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

Table of Contents
The Advance NDC Package

.NET CxMEReceipt Service 4‐8

3rd Party Runtime 4‐8
ActiveXFS Controls 4‐8
Advance NDC 4‐9
Advance NDC Tools 4‐9
Aggregate Builder 4‐9
Aggregate Builder Tool 4‐9
Aggregate Installer 4‐10
Business Services Interfaces 4‐10
CCM PCCM 4‐10
CCM VISA2 4‐10
Component Builder 4‐10
Data Manipulation 4‐10
Dialogs 4‐11
Disk Imaging for APTRA XFS 4‐11
Display Manager (for HTML) 4‐11
ECB6 Database Support 4‐11
Exception Handling 4‐12
HICS Interface 4‐12
HICOMMS 4‐12
Problem Determination 4‐13
Problem Determination Collection 4‐13
Problem Determination Analysis 4‐13
Running an Investigation 4‐13
Resource Manager 4‐13
Visual C++ 2005 Runtime 4‐14
Visual C++ 2010 Runtime 4‐14
Visual C++ 2015 Runtime 4‐14

Optional Aggregates and Components 4‐15

Security for APTRA Aggregate 4‐15
Advance NDC Runtime Component 4‐15
Secure Hard Disk Encryption 4‐15

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

 The Advance NDC Package
4

Overview

Overview 4

An Advance NDC package is all the software and documentation in

a release of Advance NDC. This chapter describes the contents of
the Advance NDC package and the components, under the
following headings:
 Advance NDC Package Contents
 Component Overviews
 Optional Aggregates and Components.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-1

The Advance NDC Package
Advance NDC Package Contents

Advance NDC Package Contents 4

The Advance NDC package contains a single installable Advance

NDC aggregate and two optional components.

Note: APTRA XFS is a prerequisite for NCR SSTs and must be

installed before Advance NDC. On other vendorsʹ SSTs, their
CEN‐XFS compliant service providers must be installed before
Advance NDC.

Advance NDC is delivered with two types of installer. The

Advance NDC Installation 4

Combined installer contains all installer types, one of which can be

selected at installation time and the Runtime Only installer is an
alternative offering only a runtime installation.

Installation Types 4

When the aggregate is installed using the combined installer,

different installation options are available for selection as follows:

Table 4-1 Installation Type Description

Installation Types
Runtime Installs all the components marked with an ʹXʹ in
the Runtime SST column in Table 4‐2 “Advance
NDC Aggregate Components” on page 4‐3, and
the templates for Problem Determination.

Development PC Installs all the components marked with an ʹXʹ in

or Development the Development PC column in Table 4‐2
and Simulation “Advance NDC Aggregate Components” on
page 4‐3, the templates for Problem Determination,
and the Advance NDC documentation described in
Table A‐1 “Advance NDC Documentation” on
page A‐2.

Simulation This option is not available for Advance NDC.

Documentation Installs all the documentation described in

only Table A‐1 “Advance NDC Documentation” on
page A‐2 plus the APTRA Author User’s Guide
described in Table A‐2, “Additional Authoring
Documentation” on page A‐4 and any help files
(CHMs) provided for the components listed in
Table 4‐2 “Advance NDC Aggregate Components”
on page 4‐3.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-2 APTRA Advance NDC, Overview

 The Advance NDC Package
Advance NDC Package Contents

Components in the Advance NDC Aggregate 4

The Advance NDC aggregate contains the components listed in the

following table, which also indicates where each component is
installed, development PC or runtime SST, depending on the
installation type selected. The list of components is given below in
alphabetical order with hyperlinks to the component descriptions in
“Component Overviews” on page 4‐5. The version numbers of the
components are provided in the APTRA Advance NDC Release
Bulletin.

Table 4-2 Development PC

Runtime SST
Advance NDC Aggregate Components Windows 7
Windows 7 (32-bit or
(32-bit or 64-bit)
APTRA Component 64-bit)/ Windows 10
or
or
64-bit Windows
POSReady 7
10

.NET 2.x Runtime X X

.NET 4.x Runtime X X

.NET Activate Core Service X X

.NET Assemblies for Advance NDC X X

3rd Party Runtime X X

ActiveXFS Controls X X

Advance NDC X X

Advance NDC Tools X —

Aggregate Builder X —

Business Services Interfaces X X

CCM PCCM X X

CCM VISA2 X X

Component Builder X —

Data Manipulation X X

Dialogs X X

Disk Imaging for APTRA XFS X X

Display Manager (for HTML) X X

ECB6 Database Support X X

Exception Handling X X

Exception Handling (64‐bit) X X

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-3

The Advance NDC Package
Advance NDC Package Contents

Development PC
Runtime SST
Windows 7
Windows 7 (32-bit or
(32-bit or 64-bit)
APTRA Component 64-bit)/ Windows 10
or
or
64-bit Windows
POSReady 7
10

HICS Interface X X

HICOMMS X X

Problem Determination Analysis X —

Problem Determination Collection X X

(32‐bit and 64‐bit)

Resource Manager X X

Visual C++ 2005 Runtime X —

Visual C++ 2010 Runtime X —

Visual C++ 2015 Runtime X —

Optional Aggregates and Components 4

The Advance NDC Package provides the following in their own

folders on the CD‐ROM. You can install them directly from the
CD‐ROM or import them into an aggregate. For an overview of
these components, see “Optional Aggregates and Components” on
page 4‐15.

Table 4-3 APTRA Aggregate/Component Development PC Runtime SST

Optional Aggregate/Component
“Security for APTRA Aggregate” X X
See Note:

Advance NDC Runtime — X

Component

Note: Once installed, the Security for APTRA aggregate cannot be

upgraded or removed. Upgrading to a later version requires the
disk on which Security for APTRA is installed to be reformatted or
replaced with a new disk, which has the required version installed.

To build a custom aggregate, see the following tables to determine

Building a Custom which components are required for each installation type:
Aggregate 4

 Table 4‐2 “Advance NDC Aggregate Components” on page 4‐3

 Table 4‐3 “Optional Aggregate/Component” on this page.
To build the aggregate from the various components, use the
Aggregate Builder. For details of building aggregates, refer to the
Aggregate Builder on‐line documentation.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-4 APTRA Advance NDC, Overview

 The Advance NDC Package
Component Overviews

Component Overviews 4

This topic contains brief overviews for each of the components that
are contained in the Advance NDC aggregate.
More detailed information about each of the components is
available in the APTRA on‐line documentation.

The .NET 2.x Runtime component is an auxiliary component,

.NET 2.x Runtime 4

supporting components that require Microsoft .NET Framework

2.x.

The .NET 4.x Runtime component is an auxiliary component,

.NET 4.x Runtime 4

supporting components or applications that require Microsoft .NET

Framework 4.x.

The .NET Activate Core Service is a Windows service that enables

.NET Activate MOF (Microsoft Operations Framework) management and the
Core Service 4
installation of a COM (Component Object Model) registered DLL on
behalf of the .NET WMI (Windows Management Instrumentation)
Core.

The .NET Assemblies for Advance NDC component includes the

.NET Assemblies for following:
Advance NDC 4

Advance NDC Cash‐In 4

Cash‐in functionality is delivered as part of the .NET Assemblies

component and supports the following:
 All of the cash deposit devices from NCR except BNA1
 Multi‐vendor cash deposit devices that support the XFS 3.x
interface
 Scalable Deposit Module in unmixed mode, that is, the device
can accept either cash or cheques but not both in a single
transaction.

.NET Archive Manager 4

The .NET Archive Manager component provides functionality for

collecting, managing and archiving data on an SST. It provides a
single step process for archiving all useful SST data.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-5

The Advance NDC Package
Component Overviews

.NET Cash Accept Service 4

This component allows cardholders to deposit notes in a cash

acceptor. The Cash Accept Service does the following:
 Handles differences between cash acceptor devices like the
BNA, GBNA and GBRU, and other vendorsʹ models
 Handles consumer exception scenarios like timeouts
 Implements error handling.

.NET Class Configurator 4

This component is used to configure any properties that are set at

runtime.

.NET PD Collection 4

This component provides .NET classes that wrap the trace

functionality provided by the Problem Determination collection
component.

.NET PDC Support Tasks 4

This component provides Supervisor tasks for creating, controlling,

and archiving Problem Determination investigation traces at the
SST.

.NET Retrieve Archive Tasks 4

This component provides Supervisor tasks for selecting and

exporting archives maintained by the Archive Manager from an SST
to a removable storage device.

.NET Promote Supervisor Tasks 4

This component provides a Supervisor task to copy campaigns to an

SST, using the CEN XFS standard interface to access CD, DVD and
USB drives.

.NET ECB 6 Cash Accept Service 4

This component is used to interface with the cash acceptor to

support ECB 6 regulations.

.NET ImageMark Deposit Recorder 4

This component records data during cheque deposits and

cheque‐related Supervisor tasks

.NET Bunch Cheque Acceptance Service 4

This component is used to interface with the bunch cheque acceptor

device.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-6 APTRA Advance NDC, Overview

 The Advance NDC Package
Component Overviews

.NET CCM TCPIP 4

This component provides a multi‐vendor TCP/IP implementation

that allows SSTs to connect to a TCP/IP network providing extended
security options to comply with PA‐DSS.

.NET TCPIP Support Tasks 4

This component provides a set of Supervisor tasks that allow

TCP/IP configuration for the following:
 Windows 7 (32‐bit and 64‐bit) and 64‐bit Windows 10
 Firewall
 SSL/TLS
 CCM TCPIP as well as basic diagnostic configuration

.NET Codeline Cheque Validator 4

This component is used to validate the codeline of an inserted

cheque.

.NET NDC CRM Service 4

This component interacts with customer relation management

(CRM) services such as Targeted Marketing Promote and Targeted
Marketing Customer Power for the display and retrieval of
campaigns and coupon printing.

.NET Common States 4

This component allows user to execute the following states:

 Data copy and Compare State which is used to process the data
in Buffer B, Buffer C and the Amount buffer.
 CRM Flow Point State which is used to call the specified CRM
flowpoint based on the configuration defined in the
CRMFlowpoints.xml file.

.NET Targeted Marketing Promote 4

This component is used to manage marketing content on an SST.

The marketing content includes images, animations, printed
materials and videos that may be presented to the consumer during
a transaction.

.NET Targeted Marketing Customer Power 4

This component is used to retrieve a message (typically an

advertisement or question) to be presented to the consumer with the
option of providing a response.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-7

The Advance NDC Package
Component Overviews

.NET Relate Supervisor Tasks 4

This component provides a Supervisor task that allows APTRA

Relate customer targeted messages to be displayed on the consumer
interface.

.NET CIM Configuration Tasks 4

This component provides Supervisor tasks for CIM device

maintenance, using the CEN‐XFS interface to access the devices.

.NET Signature Verification Service 4

This component authenticates signed software on SSTs and gives

recommendations for the signing of software and the management
of private keys and public key pairs.

.NET CxM Content Deployer Service 4

This component periodically polls the CxM server to synchronize

and download the marketing communication packages available on
the server. This packages are presented to the consumer at the SST.

.NET CxMEReceipt Service 4

This component sends transaction data to the CxM server and this
server sends the data to the consumer as an e‐receipt (SMS/email).
This transaction data is received from the application.

The 3rd Party Runtime component defines the minimum

3rd Party Runtime 4

Windows‐based system environment recommended by NCR for a

self‐service target machine. Target machines include the following:
 SSTs
 Development PCs used to develop, test or configure software
designed to operate on an SST.
Service packs and hotfixes are all freely available from the Microsoft
support web site; but some of the required files are not packaged in a
format that makes installation on a target machine easily achievable.
Therefore, 3rd Party Runtime supplies these additional files.
The 3rd Party Runtime component must be installed after installing
any service packs and hotfixes that are available from Microsoft and
recommended by NCR.

The ActiveXFS Controls component provides a COM interface to

ActiveXFS Controls 4

the CEN‐XFS interface. ActiveXFS Controls is vendor independent

and is designed to run on any product that supports the CEN‐XFS
interface. It allows a single application to run in a multi‐vendor
environment, and provides essential support for retail and banking

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-8 APTRA Advance NDC, Overview

 The Advance NDC Package
Component Overviews

peripherals. Advance NDC makes use of ActiveXFS Controls for

cash‐in functionality.

The Advance NDC component consists of the following:

Advance NDC 4

 Advance NDC environment, including the Customisation

Layer, Application Core and Supervisor projects
 Advance NDC support files
 Silent Debug trace information capture utility
 Advance NDC PD (Problem Determination) templates
 Advance NDC publications.

The Advance NDC Tools component contains the following tools to

Advance NDC Tools 4

assist in the testing and debugging of modifications or extensions to

Advance NDC and management of users in the Author:
 DebugLog (trace information utility for test environments)
 NDC Host Emulator (can be used with IPv4 and IPv6 but is
unsupported)
 User ID utility (managing user IDs in the APTRA Author).
The Advance NDC tools component supports only a development
installation. Therefore, if the tools are required on a runtime SST, for
example in a test environment, tools.bat must be run from the
Advance NDC Tools component.

NCR releases all new APTRA software products as aggregates.

Aggregate Builder 4

Simple aggregates comprise only components, while more complex

aggregates have a tree‐like structure that includes both components
and other aggregates.
The Aggregate Builder is an APTRA component for creating,
customising and exporting aggregates. Using this component, you
can create an installable aggregate that includes all of the software
for a PC or SST, except the operating system.

Aggregate Builder Tool 4

The Aggregate Builder Tool is a Windows‐based, graphical tool that

supports the following activities:
 Creating or repackaging aggregates, for example, to combine
two separate aggregates into a single aggregate for more
convenient installation, or to remove components from an
existing aggregate
 Customising aggregates, for example, to modify the components
within an aggregate to suit a particular target system or locale
 Exporting aggregates to create installable aggregates.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-9

The Advance NDC Package
Component Overviews

Aggregate Installer 4

Exporting an aggregate from the Aggregate Builder Tool creates a

dedicated Aggregate Installer. A single command invokes an
Aggregate Installer which manages all aspects of the aggregate
installation, including system reboots and component
dependencies.

This component contains the definitions of the Business Services

Business Services abstract classes and their corresponding architected interfaces.
Interfaces 4
These definitions support the following activities:
 Creating an implementation of a business service, for example,
an Interactive Financial Exchange (IFX) account service
implementation
 Creating generic code that is compatible with any software that
implements a Business Services interface. For example, a
consumer flow or transaction object that interfaces with an
account service through the IAccountService interface, is
compatible with any AccountService implementation
supporting that interface.

The CCM PCCM component provides PCCM communication

CCM PCCM 4

management for NCR SSTs. This component supports all

communication protocols provided by the APTRA Communications
Feature; for a list of these protocols, refer to the APTRA
Communications Feature, Users Guide (B006‐0012‐B000).

The CCM VISA2 component provides CCM for the VISAII protocol.
CCM VISA2 4

This component supports communication using a subset of VISAII

over a Plain Old Telephone System (POTS) dialup connection. This
component also provides Dialup Diagnostics.

The Component Builder allows software components to be

Component Builder 4

packaged in such a way that the Aggregate Builder Tool can create
installable aggregates from them. To be compatible, a component
must be installable using an installer such as MSI (Microsoft
Windows Installer) database, and have a component description
file. For more information about the process, see “Aggregate
Builder” on page 4‐9.

The Data Manipulation component provides support for the storage

Data Manipulation 4

and sharing of data between components of an APTRA application.

It consists of the following:
 Standard Data Record, which stores primitive data type
information to be used, for example, in the contexts of receipt
printing and journal printing

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-10 APTRA Advance NDC, Overview

 The Advance NDC Package
Component Overviews

 Standard Data Dictionary, which stores multiple data records

and allows data records to be shared between components
within the same process boundary
 Object Dictionary, which allows object references to be shared
between containers, for example, COM objects and web pages.

In the context of customer relationship management (CRM)

Dialogs 4

applications such as APTRA Promote, Dialogs acts as a

pass‐through between the application logic and a dedicated
presentation client to enable the separation of presentation
development from functional development. This means that the
presentation client can be developed independently of the
application, making it easier to introduce richer content and control
its presentation.

The purpose of Disk Imaging for APTRA XFS is to provide tools and
Disk Imaging for APTRA instructions to aid the initial installation of Windows 7 (32‐bit and
XFS 4
64‐bit), Windows 10 (64‐bit) and APTRA XFS on NCR SSTs using
disk imaging technology.
This component describes an advocated method for installing SST
software from a CD or DVD, which includes the following:
 NCR OEM Windows 7 with Service Pack 1 and Windows 10
Professional for embedded systems.
For other vendors’ SSTs in a Windows 7 environment, you must use
a disk imaging technology like ImageX or DISM (Deployment Image
Servicing and Management) and in a Windows 10 environment, you
must use a disk imaging technology like DISM from Microsoft, as
Disk Imaging for APTRA XFS is not supported on other vendors’
SSTs.

This component allows the designer of the APTRA Advance NDC

Display Manager (for application to use web design tools to create screens which
HTML) 4
incorporate design features of HTML applications, as follows:
 HTML pages can replace or partially overlay NDC screens
 Touch‐ key entry is supported
 HTML pages can already be on the SST or downloaded as part
of an NDC screen
 Dynamic parameters in web URLs.
Display Manager can be used with APTRA Promote and APTRA
Relate.

ECB 6 refers to Article 6 of the European Central Bank (ECB)

ECB6 Database Support 4

Council Regulation 1338/2001. The ECB6 Database Support

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-11

The Advance NDC Package
Component Overviews

component provides functionality for a self‐service application to

add and retrieve ECB6‐related information to and from a database
in conformance with ECB6. This component is used only if the cash
acceptor is configured to process counterfeit or suspect banknotes.
The application must keep a record of all counterfeit and suspect
banknotes deposited through a cash deposit device. It must be
possible to retrieve this record and identify the customer who
deposited the counterfeit or suspect banknote.
The functionality provided by the ECB6 Database Support
component is accessible through COM interfaces.
For more information about the ECB 6 regulations, refer to the
European Central Bank web site at www.ecb.int.

An exception is any event that stops the normal running of the SST.
Exception Handling 4

Exception handling enables recovery from exceptions to restore the

SST to normal service. The unattended environment of an SST
means that exceptions must be dealt with as soon as possible, to
maintain availability 24 hours a day, seven days a week.
The Exception Handling component has been developed by NCR to
enable the following to be handled in an appropriate way:
 Pop‐ups requiring user intervention
 Events that cause the SST to freeze
 The majority of unhandled exceptions
 Repeated restarts of the SST.
The component also provides detailed information about these
exceptions to help with their resolution. Two versions of Exception
Handling are provided with Advance NDC, as follows:
 Exception Handling for 32‐bit Windows
 Exception Handling for 64‐bit Windows.

The HICS Interface component allows a developer to create generic

HICS Interface 4

code that is compatible with any software that implements a HICS

interface.

The HICOMMS component contains the definitions of the

HICOMMS 4

Hardware‐Independent Comms Interface abstract classes and their

corresponding architected interfaces.
The HICOMMS component includes the following interfaces:
 ICommunicationsLink
 ICommunicationsLinkEvents
 ICommunicationsService

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-12 APTRA Advance NDC, Overview

 The Advance NDC Package
Component Overviews

Problem determination is the name given to the process of

Problem Determination 4

collecting, managing and analysing data in order to determine the

cause of a software problem. Using the Problem Determination
component involves collecting data from one or more data sources
on a PC or SST for analysis. The data collected can be managed as a
single unit for analysis. This single unit is called an “investigation”.
The Problem Determination API allows tracing data to be specified
for the General Trace (GenTrace) data source.

Problem Determination Collection 4

The Problem Determination Collection component allows other

components in the system to send data to be collected in an
investigation. This data can later be analysed using the Problem
Determination Analysis component.
Two versions of Problem Determination Collection component are
provided with Advance NDC, as follows:
 Problem Determination Collection for 32‐bit Windows
 Problem Determination Collection for 64‐bit Windows.

Problem Determination Analysis 4

The Problem Determination Analysis component is a

Windows‐based GUI application used for the collection and
analysis of data from one or more data sources on a PC or SST. The
data is collected in an investigation, which can then be analysed by
the utility. This component also provides a programmer’s reference
detailing how to provide information for analysis.

Running an Investigation 4

An investigation can be run by either creating an investigation

template or selecting an existing template. A template specifies the
data sources and their configuration for an investigation. It is
possible to run and complete the investigation using the commands
within the Analysis Utility or Supervisor tasks in Advance NDC.
The completed investigation can be exported for analysis on another
machine.
The investigation can then be viewed using Problem Determination
Analysis. Data can be displayed according to user‐defined
investigation views, filtered to hide the records that are not required
and searched for specific items.

In self‐service applications, the dynamics of which services or

Resource Manager 4

transactions to offer to the consumer can be very complex. They can

depend on the following:
 Hardware availability

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-13

The Advance NDC Package
Component Overviews

 Availability of networked resources

 The identity of the consumer
 The consumer’s previous interaction with the application
 The demands of other applications that also need to use or
manage a resource.
The Resource Manager contains this complexity by allowing all
resources to be handled in a consistent way. It offers a system‐wide
concept of a ‘resource’ and defines interfaces by which any system
or application object can conform to this concept.
Resource management is designed to facilitate the standard SST
consumer application model by making the co‐operation of all SST
applications as straightforward as possible.

This component packages the x86 Microsoft redistributable package

Visual C++ 2005 Runtime 4

with SP1 for inclusion in APTRA products like APTRA Advance

NDC to maintain security. The file has been obtained from the
Microsoft Download Center. The Microsoft file name vcredist_x86.exe
has been shortened to vcredist.exe to adhere to the 8.3 file name
format.

This component packages the x86 Microsoft redistributable package

Visual C++ 2010 Runtime 4

with SP1 for inclusion in APTRA products like APTRA Advance

NDC. The component installs the runtime components of Visual
C++ Libraries that are required to run applications developed with
Visual C++ on a computer that does not have Visual C++ 2010
installed. The file has been obtained from the Microsoft Download
Center. The Microsoft file name vcredist_x86.exe has been shortened
to vcredist.exe to adhere to the 8.3 file name format.

This component packages the x86 and x64 Microsoft

Visual C++ 2015 Runtime 4

redistributables for inclusion in APTRA products like APTRA

Advance NDC. The component installs the runtime components of
Visual C++ Libraries that are required to run applications developed
with Visual C++ on a computer that does not have Visual C++ 2015
installed. The file has been obtained from the Microsoft Download
Center.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-14 APTRA Advance NDC, Overview

 The Advance NDC Package
Optional Aggregates and Components

Optional Aggregates and

Components 4

The Security for APTRA Aggregate and Advance NDC Runtime

Component are provided in Advance NDC package, but not
included in the Advance NDC aggregate. NCR Secure Hard Disk
Encryption (HDE) is a solution (not included in Advance NDC
package) from NCR to protect the Hard Disk Drive (HDD).

Security for APTRA is NCRʹs software solution to protect the

Security for APTRA business assets held on SSTs. NCRʹs solution is designed for SSTs as
Aggregate 4
standalone nodes on a network. It does not cover all aspects of
security; however, customers can build separate components to be
installed before or after the Security aggregate.
Security for APTRA 04.01.xx for Windows 7 (32‐bit and 64‐bit) and
Security for APTRA 05.00.xx for 64‐bit Windows 10 is installed on
Windows 7 and Windows 10 respectively and consists of
customised settings, scripts and documentation.

The documentation for Security for APTRA is provided in the

APTRA on‐line help under APTRA Documentation|Security.

Advance NDC Runtime is available as a smaller alternative to the

Advance NDC Runtime combined installer when installing the runtime version on SSTs.
Component 4

Advance NDC supports NCR Secure Hard Disk Encryption (HDE)

Secure Hard Disk which protects the Hard Disk Drive (HDD) of an SST from off‐line
Encryption 4
physical attacks, such as preventing access to boot an ATM or
copying the malware to drive from a USB flash drive. The HDE does
the following on the AANDC application:
 A full disk encryption software, SecureDoc Enterprise Server
from WinMagic encrypts hard disks and provides centralized
control of the encrypted systems.
 A network based authentication is provided to ensure that the
encrypting key used to access the data on the SST is controlled
remotely in a database and not on the SST.
To obtain the software or information on NCR HDE, please contact
NCR FSE Product Management.

Note: APTRA Advance NDC does not recommend Bitlocker (a

component of Microsoft Windows) as an advocated solution for
disk encryption. If you would like to use Bitlocker, it is advised to
test Bitlocker with APTRA Advance NDC.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview 4-15

The Advance NDC Package
Optional Aggregates and Components

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

4-16 APTRA Advance NDC, Overview

 Table of Contents
Related Documentation

Appendix A
Related Documentation

Overview A‐1

Advance NDC Documentation A‐2

APTRA Author Documentation A‐3

Additional Authoring Documentation A‐4

NDC+ Documentation A‐5

Other NCR Documentation A‐6

CEN‐XFS Documentation A‐7

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

Table of Contents
Related Documentation

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview

 Related Documentation
A

Overview

Overview A

This appendix gives details of the documentation you may find

useful when customising or extending your application and
deploying it to an SST.
The documentation is a combination of on‐line help files and Adobe
Portable Document Format (PDF) files. To read the PDF
documentation, you need Adobe Reader version 7.0 or later. The
latest version is available free from www.adobe.com.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview A-1

Related Documentation
Advance NDC Documentation

Advance NDC Documentation A

The following publications are provided in the APTRA Advance

NDC package:

Table A-1
Advance NDC Documentation

Title Format Description

APTRA Advance NDC, PDF Provides an introduction to Advance NDC, including

Overview overviews of the components contained in the Advance
B006‐6597 NDC product and provided as part of the ANDC Package
on CD‐ROM.

APTRA Advance NDC, PDF Describes how to migrate to Advance NDC. It also
Developer’s Guide identifies the functionality offered by Advance NDC, and
B006‐6046 describes how to enhance it.

APTRA Advance NDC, PDF Provides application programmers with reference

Reference Manual information for Advance NDC, including States, Screens,
B006‐6180 and the message formats between the host application
and the terminal.

APTRA Advance NDC, PDF Provides users with information about running the
Multi‐Vendor Support Advance NDC application on other vendors’ SSTs,
Reference Manual describing the differences between Advance NDC on
B006‐6344 NCR SSTs and other vendors’ SSTs.

APTRA Advance NDC, PDF Describes the Supervisor interface and how to set up the
Supervisor’s Guide terminal’s local configuration parameters, and how to
B006‐6062 replenish the terminal.

APTRA Advance NDC, PDF Describes how to modify Advance NDC to enhance or
Extending the Product extend its functionality.
B006‐6926

APTRA Advance NDC, PDF Describes how to use the Display Manager for HTML
User Guide for pages to replace or overlay NDC screens.
Display Manager
B006‐6796

APTRA Advance NDC, PDF Provides a guide for customers of Advance NDC to allow
Payment Application them to comply with the Payment Application Data
Data Security Standard, Security Standard (PA‐DSS) when deploying APTRA
Implementation Guide Advance NDC solutions.
B006‐6861

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

A-2 APTRA Advance NDC, Overview

 Related Documentation
APTRA Author Documentation

APTRA Author Documentation A

The following publications are provided in the Advance NDC

component, for the authoring environment.

Caution: APTRA Author Help and all the other Helps of the format Windows
Help are available only in a Windows 7 (32‐bit and 64‐bit) operating
system and are not available in a 64‐bit Windows 10 operating
system as Microsoft has deprecated the support for Windows Help
from Windows 10. The Author help for Windows 10 will be made
available from the next release.

Table A-2
Authoring Environment Documentation

Title Format Description

APTRA Author, User’s Guide PDF Describes how to use the Author and provided components to
B006‐6038 develop and modify a self‐service application.

APTRA Author Help Windows Context‐sensitive help for the Author user interface and authoring
Help errors.

Runtime Core Help Windows Context‐sensitive help for the Runtime Core Authoring
Help components and runtime errors, which are part of Advance Core
Self‐Service.

GUI Help Windows Context‐sensitive help for the GUI Authoring components, which
Help are part of Advance Core Self‐Service.

Self‐Service Core Help Windows Context‐sensitive help for the Self‐Service Core Authoring
Help components, which are part of Advance Core Self‐Service.

ActiveX Help Windows Context‐sensitive help for the ActiveX Authoring components
Help and runtime errors, which are part of Advance Core Self‐Service.

Basic Self‐Service Help Windows Context‐sensitive help for the Authoring components provided
Help with Advance Basic Self‐Service.

ATM Help Windows Context‐sensitive help for the Authoring components and
Help runtime errors provided with Advance ATM.

Special Self‐Service Help Windows Context‐sensitive help for the Authoring components and
Help runtime errors provided with Advance Special Self‐Service.

Statement Printer Help Windows Context‐sensitive help for the Authoring components and
Help runtime errors provided with Advance Statement Printer.

Voice Guidance Help Windows Context‐sensitive help for the Authoring components provided
Help with Advance Voice Guidance.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview A-3

Related Documentation
APTRA Author Documentation

Title Format Description

Passbook Printer Help Windows Worker classes and help for the Passbook Printer.
Help

Advance NDC Help Windows Context‐sensitive help for the Advance NDC Authoring
Help components (excluding Application Core components).

Advance NDC Application Core Windows Context‐sensitive help for the Application Core/Supervisor
Help Help Authoring components.

The publications in Table A‐3 are not provided in the Advance NDC
Additional Authoring package, but are listed here for reference. They are available from
Documentation A
NCR on request.

Table A-3
Additional Authoring Documentation

Title Format Description

APTRA Advance ADE, PDF Describes how application programmers should create their own
Programmer’s Guide C++ Worker Classes. It also contains information on using C
B006‐6042 routines to manipulate data.

APTRA Advance ADE, C++ PDF Provides application programmers with definitions for a number
Class Reference of C++ Runtime and Utility Worker Classes provided by NCR.
B006‐6043

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

A-4 APTRA Advance NDC, Overview

 Related Documentation
NDC+ Documentation

NDC+ Documentation A

The publications in the following table are not provided on the

Advance NDC CD‐ROM but are listed here for reference. These
publications are available from NCR on request.

Table A-4
NDC+ Documentation

Title Format Description

NDC, Programmer’s Overview PDF Provides an introduction to, and overview of the NDC
B006‐2485 software.

NDC+, Programmer’s Reference PDF/ For programmers who write Central control applications to
Manual Paper support NDC+ terminals, or who create the terminal
B006‐2486 configuration that customises NDC+.

NDC, Message Formats For PDF/ For Central control application developers working with NDC
Host Application Developers Paper RMX, NDCxa or NDC+. Intended to help in creating a control
B006‐4201 program that handles all the NDC variants.

NDC+, Supervisor’s Reference PDF/ For people who are responsible for setting up the terminal’s
Manual Paper local configuration parameters, or for routine replenishment of
B006‐2487 the terminal.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview A-5

Related Documentation
Other NCR Documentation

Other NCR Documentation A

The publications in the following table are provided with the

software aggregate or component to which they refer.

Table A-5
Other NCR Documentation

Aggregate or
Title Format Description
Component

APTRA APTRA SNMP Agent PDF Describes the management information exposed
SNMP Reference Manual by the SNMP Agent: the NCR SST MIB, SNMP
Agent B006‐6017 Traps, the Event Log Agent and SNMP Errors.

EMV/CAM2 EMV Integrated Circuit PDF Provides reference information for any Advance NDC
Exits for Card (ICC) Reference developer who wishes to add EMV Integrated Circuit
APTRA Manual Card (ICC) Card Authentication Method (CAM)
Advance B006‐6297 functionality to their Advance NDC application.
NDC Version 03.00.00 of the product is required for Advance
NDC.

APTRA XFS NCR APTRA XFS PDF Provides information about APTRA XFS, its features
Overview and functionality, and the requirements for its use.
B006‐6166

APTRA XFS Simulator for Microsoft Context‐sensitive help for the XFS Simulator.
Simulator APTRA HTML
Help
(CHM)

APTRA APTRA Promote User’s PDF Provides information about how to install and
Promote Guide configure the APTRA Promote components, and how
Manager B006‐6309 to create, edit and export advertising campaigns.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

A-6 APTRA Advance NDC, Overview

 Related Documentation
CEN-XFS Documentation

CEN‐XFS Documentation A

For device access, Advance NDC supports release 3 or later of the

CEN‐XFS specification.
More information about CEN‐XFS specifications is available at
http://www.cen.eu/cen/pages/default.aspx.
You can search for specific documents including the following
documents at http://esearch.cen.eu/esearch/

Table A-6
CEN-XFS Documentation

Component Title Format Description

CEN‐XFS Extensions for Financial PDF or Provides reference information for

Specifications Services (XFS) interface zipped CEN‐XFS specifications, release 3.03
specification PDF
(CWA 14050)

Extensions for Financial PDF or Provides reference information for

Services (XFS) interface zipped CEN‐XFS specifications, release 3.10
specification PDF
(CWA 15748)

XFS Clarifications for Device Word Provides additional information

Class Interfaces for the CEN‐XFS specifications {check
whether this is still available ‐ CEN web
site down 25.02.14}

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview A-7

Related Documentation
CEN-XFS Documentation

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

A-8 APTRA Advance NDC, Overview

 Glossary

Glossary 0

ActiveX ActiveX is the product of two Microsoft technologies called

A OLE and COM.
ADI Application Device Interface. An NCR proprietary
programming device interface for hardware modules.
Advance NDC Advance NCR Direct Connect. A self‐service
application for the operation and maintenance of SSTs in a
multi‐vendor environment. Advance NDC runs on Windows 7
(32‐bit and 64‐bit) and 64‐bit Windows 10 and supports the same
message format as NDC+. 
See also NDC and NDC+.
AER Automatic Error Recovery.
Aggregate A grouping of components or aggregates or both. The
Advance NDC package consists of a single aggregate and optionally
installable aggregates and components.
Aggregate Builder A tool that can be used to create, repackage or
customise an aggregate.
API Application Programming Interface.
Application In the Author, an application is a collection of Workers
that can be built to create an executable 
See also Self‐Service Application.
Application Core In Advance NDC, the Application Core is the
authored application that performs the SST mode handling and
message processing.
APTRA Author A tool with a graphical user interface for the design,
development and modification of a self‐service application.
APTRA XFS A 32‐bit open software platform supplied by NCR for
use on NCR SSTs. It is used to support the various Self Service
devices found on an SST.
Assembly All of the files that comprise a .NET application,
including resource, security management, versioning, sharing and
deployment information, and the executable code. An assembly
may appear as a single DLL or EXE file, or as multiple files, and is
approximately the equivalent of a COM module.
Author Environment Software from NCR to develop, build and test a
self‐service application.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview Glossary-1

Glossary

Authoring components Units in the APTRA Author. Examples are

Workers, Applications and Catalogs.
AVI Audio Video Interleave. An audio/video standard designed by
Microsoft for Windows.

BNA Bunch Note Acceptor. An NCR device variant that allows a

B consumer to deposit a number of banknotes in a bunch without
using an envelope. 
See also Cash acceptor.
BOP Basic Operator Panel. Not supported by Advance NDC. 
See also EOP.
BRM Bunch Recycling Module. An NCR term for a device that
accepts and dispenses notes as configured using the same cassettes
or separate cassettes.

Cash acceptor A a general term for any device capable of accepting

C notes or coins in an SST
Catalog In the APTRA Author, a Catalog allows all other Authoring
components to be organized into manageable groups.
CCM Communications Connection Management.
CEN Comité Européen de Normalisation (European Committee for
Standardization). Responsible for the XFS interface specification.
Codec Compressor/decompressor software or hardware that
compresses and decompresses audio and video data streams. The
purpose is to reduce the size of digital audio samples and video
frames in order to speed up transmission and save storage space.
COM Component Object Model. An open architecture for
cross‐platform development of client/server applications based on
object‐oriented technology. Clients have access to an object through
interfaces implemented on the object (access to Methods, Properties
and Events).
Component A single piece of software which might be able to run on
its own, but which usually requires other components. A
component can be imported into the Aggregate Builder for
inclusion in an installable aggregate.
See also Authoring components.
Component Builder A tool used to build components that are
compatible with the Aggregate Builder.
COP Compact Operator Panel.
CPM Cheque Processing Module.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

Glossary-2 APTRA Advance NDC, Overview

 Glossary

CRM Customer Relationship Management.

Customisation Layer In Advance NDC, the Customisation Layer is
the authored application that performs the ‘In Service’ activities
associated with the consumer.

Denomination The values of the monetary units in a series as defined

D by the combination of value, currency and media type.
DES Data Encryption Scheme. 
See also Triple DES encryption.
DHCP Dynamic Host Configuration Protocol.
DMI Desktop Management Interface. A specification that
establishes a standard framework for managing networked
computers.

ECB 6 European Clearing Bank Article 6.

E
EJ Electronic Journal.
EMV Europay MasterCard and Visa, a consortium responsible for
the smart card authentication method.
EOP Enhanced Operator Panel.
EPP Encrypting PIN Pad. Combined encryptor and PIN Pad
providing enhanced security.
Exits The general term covering user‐defined States, Supervisor
features, Virtual Controllers and special synchronisation routines
called Hooks.

FDK Function Display Key. These keys are located on each side of
F the facia screen and enable various options to be chosen. Some
screens have touch screen areas which emulate FDK functions.
FIT Financial Institution Table. This contains details of where and
how information is stored on the card and how a transaction should
be processed.

GBNA Global Bunch Note Acceptor

G
GBRU Global Bill Recycling Unit. An NCR device that allows a
consumer to deposit a number of banknotes in a bunch without
using an envelope. The device can also dispense notes and recycle
deposited notes (that is, dispense the deposited notes). 
See also Recycling unit.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview Glossary-3

Glossary

GBXX Short form for GBNA and GBRU. An NCR term for a
recycling unit or a cash acceptor with configurable cassettes where
the specific device is not significant.
GIF Graphics Interchange format.
GIS Go‐in‐service.
GOP Graphical Operator Panel
GUI Graphical User Interface.

HICS Hardware Independent Channel Services.

H
HiBAPE High Integration ‐ Basic Alphanumeric PINpad and
Encryptor. A variant of the BAPE combined PINpad and encryptor.
Supports single length DES encryption with various local and
remote PIN verification schemes.

IP Advance NDC supports IPv4 and IPv6.

I
JPEG Joint Photographic Experts Group.
J
KBPK Key Block Protection Key
K
MDM Media Dispenser Module.
M
MEI Media Entry/Exit Indicator.
MICR Magnetic Ink Character Recognition.
MIDI Musical Instrument Digital Interface. Hardware interface
specifications and software protocols which define how musical
instruments communicate with computer hardware and software.
MPEG Moving Pictures Experts Group. A set of standards for audio
and video compression, or a video/audio file in the MPEG format
(usually with the MPG file extension
MSSA Mini Self‐Service Assistant. Also known as MAST within
Advance NDC.
Multi-vendor application An Advance NDC application that runs on
both NCR’s and other vendors’ SSTs.

NDC NCR Direct Connect. An NCR application that works in

N conjunction with a host or switch application to perform self‐service
transactions.
NDC+ NCR Direct Connect Plus. A development of NDC designed
for NCR SSTs on the OS/2 platform.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

Glossary-4 APTRA Advance NDC, Overview

 Glossary

OEM Original Equipment Manufacturer.

O
OLE Object Linking and Embedding. An architecture for enabling
one application to insert and access objects created in other
applications.

PA-DSS Payment Application Data Security Standard.

P
PCCM Personal Computer Communications Module. The hardware
that a protocol will be run on. An NCR proprietary network card.
PCI DSS Payment Card Industry Data Security Standard.
PDF Portable Document Format. The Adobe file format for
documents viewable in Adobe Reader.
PNG Portable Network Graphics.
Project An APTRA Author project is a collection of Authoring
components.

Recycling unit A device that allows a consumer to deposit a number

R of banknotes in a bunch without using an envelope. The device can
also dispense notes and recycle deposited notes (that is, dispense
the deposited notes).
RSIs Remote Status Indicators.
RKM Remote key management.

Security for APTRA A set of components from NCR to protect the

S software on and the operational security of an SST by the creation of
a trusted environment. It is provided on the APTRA Advance NDC
CD‐ROM.
SDA Single Note Divert. A reject bin that collects all the pick failure
notes.
Self-Service Application The application that runs on an SST and
processes all the necessary transactions.
SDM/SDM2 Scalable Deposit Module.
SNMP Simple Network Management Protocol. Standard protocol
for network and systems management developed to manage nodes
on an IP network.
Solidcore for APTRA A third‐party application, deployed by NCR,
that can be used to lock down (solidify) system software on a fixed
disk to ensure unauthorised code is not executed. It also protects the
system from unauthorised changes.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview Glossary-5

Glossary

SSL Secure Sockets Layer.

SST Self‐Service Terminal.
S2 A currency dispenser contains a purge bin partitioned into three
units; retract bin, reject bin and single note divert (reject bin 2).

TCP/IP Transmission Control Protocol/Internet Protocol. TCP/IP is

T the suite of network protocols used for all Internet traffic.
TCPIP A CCM software component that supports TCP/IP
connections on SSTs.
Test Application An application running on a development PC is
called a test application.
TIFF Tagged Interface File Format.
TLS Transport Layer Security.
Triple DES encryption DES encryption performed three times
successively, for greater security.

User A developer using the APTRA Author with a personal user

U ID. A user can create and own components in the Author.
UPS Uninterruptable Power Supply.

VDM Vendor Dependent Mode. Also CEN‐XFS class name for the
V Vendor Dependent Mode service.
VISAII A message format used by financial transaction processing
systems.
VISA2 A CCM software component that supports the VISAII
message format on SSTs.

WAVE WAVE or .WAV (Waveform Audio). A standard Windows

W based sound format.
Windows 7 A Microsoft Windows operating system supported by
Advance NDC.
Windows 10 A Microsoft Windows operating system supported by
Advance NDC. Windows 10 provides improvements in security,
performance and start‐up time.
Workers The graphical building blocks or components in a
self‐service application developed using the APTRA Author.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

Glossary-6 APTRA Advance NDC, Overview

 Glossary

WPF Windows Presentation Foundation. A unified programming

model from Microsoft for the creation of interactive client
applications.

XFS Extensions for Financial Services.

X
XML Extensible Markup Language meant to structure, store, and
transport information.

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview Glossary-7

Glossary

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

Glossary-8 APTRA Advance NDC, Overview

 Index

Index 0

.NET Assemblies for Advance NDC

Symbols .NET Archive Manager 4‐5
.NET Bunch Cheque Acceptance Service 4‐6
.NET Cash Accept Service 4‐6
.NET CCM TCPIP 4‐7
.NET CCM TCPIP Support Task 4‐7
.NET CIM Configuration Tasks 4‐8
.NET Class Configurator 4‐6
.NET Codeline Cheque Validator 4‐7
.NET ImageMark Deposit Recorder 4‐6
.NET NDC CRM Service 4‐7
.NET PD Collection 4‐6
.NET PDC Support Tasks 4‐6
.NET Promote Supervisor Tasks 4‐6
.NET Relate Supervisor Tasks 4‐8
.NET Retrieve Archive Tasks 4‐6
.NET Signature Verification Service 4‐8
.NET Targeted Marketing Customer Power 4‐7
.NET Targeted Marketing Promote 4‐7
Cash‐In functionality 4‐5
.NET components
.NET 2.x Runtime 4‐5
.NET 4.x Runtime 4‐5
.NET Activate Core Service 4‐5

3rd Party Runtime 4‐8

Numerics
ActiveX and the authoring environment 1‐6
A ActiveXFS Controls 4‐8
Advance NDC
Advance NDC component 4‐9
Advance NDC Tools component 4‐9
architecture 1‐21
Application Core 1‐22
Customisation Layer 1‐23
Supervisor 1‐23
authored applications 1‐3
benefits 1‐5
benefits for NDC+ users 1‐6
comparing with NDC+ 3‐3
compatibility with previous versions 2‐2
configuration options 2‐2
creating a system 1‐24
Customisation Layer 1‐23
device access 2‐2
documentation A‐2
enhancing the Application Core and Supervisor 1‐25

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview Index-1

Index

extending the application 1‐26

features compared with NDC+ 3‐4
host application 1‐4
installation 4‐2
migrating from NDC+ 3‐9
multi‐vendor environment 1‐2
new features in this release 1‐7
product information 1‐2
SST operation 1‐3
what is Advance NDC?
host application 1‐4
upgrading from a previous release 2‐3
ways of modifying 1‐25
Advance NDC and NDC+
operating environments 3‐3
Advance NDC Cash‐In 4‐5
Advance NDC component 4‐9
Advance NDC package contents 4‐2
building your own aggregate 4‐4
installing the aggregate 4‐2
Advance NDC Runtime component 4‐15
Advance NDC Tools component 4‐9
Advance NDC upgrade
customised applications 2‐3
Aggregate Builder 4‐9
Aggregate Builder Tool 4‐9
Aggregate Installer 4‐10
Analysis component of Problem Determination 4‐13
Application Core 1‐22
Application Core and Supervisor, enhancing 1‐25
APTRA Author
benefits of the authoring environment 1‐5
minimum screen resolution 1‐15
workers 2‐3
APTRA Author documentation A‐3
APTRA Promote campaigns 2‐4
APTRA Simulator documentation A‐6
APTRA XFS benefits 1‐21
Author workers, new and modified 2‐3

Benefits of Advance NDC 1‐5

B authoring environment 1‐5
for NDC+ users 1‐6
BRM Glossary‐2
Building your own aggregate 4‐4
Bus adapter mouse 1‐16
Business Services Interfaces component 4‐10

Card Eject State 1‐7

C Cash‐In functionality for Advance NDC 4‐5
CCM PCCM
communication protocols 4‐10

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

Index-2 APTRA Advance NDC, Overview

 Index

component 4‐10
CCM VISA2 component 4‐10
CEN‐XFS
documentation A‐7
interface 4‐8
C‐Exits in Advance NDC 2‐3
Comparing Advance NDC with NDC+ 3‐3
environments 3‐3
features in NDC+ and Advance NDC 3‐4
Compatibility with Advance NDC 2.x 2‐2
Compatibility with previous releases of Advance NDC 2‐2
configuration options 2‐2
device access 2‐2
fault display 2‐2
state tables 2‐2
Component Builder component 4‐10
see also Aggregate Builder 4‐10
Component overviews 4‐5
.NET 2.x Runtime 4‐5
.NET 4.x Runtime 4‐5
.NET Activate Core Service 4‐5
.NET Assemblies for Advance NDC 4‐5
3rd Party Runtime 4‐8
ActiveXFS controls 4‐8
Advance NDC 4‐9
Advance NDC Runtime component 4‐15
Advance NDC Tools 4‐9
Aggregate Builder 4‐9
Aggregate Builder Tool 4‐9
installing an aggregate 4‐10
Business Services Interfaces 4‐10
CCM PCCM 4‐10
CCM VISA2 4‐10
Component Builder 4‐10
Data Manipulation 4‐10
Dialogs 4‐11
Display Manager 4‐11
ECB 6 Database Support 4‐11
Exception Handling 4‐12
HICS Interfaces 4‐12
Initial Unattended Installation 4‐12
Problem Determination 4‐13
Problem Determination Analysis 4‐13
Resource Manager 4‐13
Security for APTRA 4‐15
Visual C++ 2005 Runtime 4‐14
Configuration options fir Advance NDC 2‐2
Customisation Layer 1‐23
enhancing 1‐25
Customising Advance NDC 1‐24

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview Index-3

Index

Data Manipulation component 4‐10

D Development PC 1‐17
Development system 1‐14, 1‐17, 4‐2
Device access in Advance NDC 2‐2
Dial Up note 1‐20
Dialogs component 4‐11
Dialup diagnostics for CCM VISA2 4‐10
Display Manager
component 4‐11
Documentation
Advance NDC A‐2
APTRA Author A‐3
CEN‐XFS A‐7
NDC+ A‐5
other A‐6

ECB 6 Database Support 4‐11

E Enhancing Advance NDC 1‐25
customising Advance NDC 1‐25
enhancing the Customisation Layer 1‐25
Exception handling 4‐12
Exits, user‐defined 3‐4
Extending Advance NDC 1‐26
examples 1‐26

Features in NDC+ and Advance NDC 3‐4

F
Hardware and software requirements 1‐14, 4‐2
H hardware requirements 1‐16
development system (PC) 1‐14
runtime system (SST) 1‐15
operating environment 1‐19
software requirements
development system (PC) 1‐17
runtime system (SST) 1‐18
unattended installation 1‐18
Hardware requirements 1‐14, 1‐16
NCR SSTs 1‐15
HICS Interfaces component 4‐12
Host application 1‐4

Initial Unattended Installation components 4‐12

I In‐service activities, Customisation Layer 1‐23
Installing Advance NDC 4‐2

Message handling 1‐22

M Migrating from NDC+
overview 3‐1
reasons for 3‐2
tasks 3‐9

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

Index-4 APTRA Advance NDC, Overview

 Index

Minimum screen resolution for the Author 1‐15

Mode handling 1‐22
Modifying Advance NDC 1‐25
Multi‐vendor environment 1‐2

NCR Download Center 1‐18

N NCR SSTs, hardware requirements 1‐15
NDC Exits 3‐4
NDC state tables 2‐2
NDC+
compared with Advance NDC 3‐3
documentation A‐5
Exits 1‐6, 3‐4
migrating to Advance NDC 3‐9
New features in Advance NDC 1‐7

Operating environments
O for Advance NDC and NDC+ 3‐3
on NCR SSTs 1‐19
on other vendors’ SSTs 1‐19
Optional aggregates and components
Advance NDC Runtime 4‐15
Security for APTRA 4‐15
Out‐of‐service activities 1‐23
Overview
Advance NDC package overview 4‐1
introducing Advance NDC 1‐1
migrating from NDC+ to Advance NDC 3‐1
related documentation A‐1
upgrading from earlier versions of Advance NDC 2‐1

Platform environment 1‐14

P Prerequisite knowledge and training
development 1‐12
SST installation and configuration 1‐12
training 1‐12
Problem Determination
Analysis component 4‐13
API 4‐13
Collection component 4‐13
running an investigation 4‐13
Problem Determination Collection and Analysis 4‐13
Promote campaigns 2‐4

Reasons for migrating to Advance NDC 3‐2

R Recommendations for hardware 1‐14
Related documentation A‐1
Resource Manager component 4‐13
Runtime system (SST) 1‐15, 1‐18

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

APTRA Advance NDC, Overview Index-5

Index

Security for APTRA 4‐15

S Software requirements 1‐16
Solidcore for APTRA 1‐14
SST installation and configuration 1‐12
SST operation 1‐3
States and screens 1‐6, 3‐4
Supervisor
application functionality 1‐23

Training for Advance NDC 1‐12

T
Unattended environment, exception handling in 4‐12
U Uninterruptible power supply (UPS) 1‐16
Upgrading from earlier releases of Advance NDC 1‐5
compatibility with previous releases 2‐2
overview 2‐1
upgrading your application
customised applications 2‐3
Upgrading from NDC+ 3‐9
Upgrading your application 2‐3
modified applications 2‐3
C‐Exits 2‐3
user messages and user terminal data 2‐4
workers 2‐3
User messages and user terminal data 2‐4

VISAII protocol in CCM VISA2 4‐10

V Visual C++ 2005 Runtime component 4‐14

What is Advance NDC? 1‐2

W Windows 7
and development systems 1‐17
and IUI 4‐12
and runtime systems on SSTs 1‐18
Workers, support for 2‐3

Confidential and proprietary information of NCR.

Unauthorised use, reproduction and/or distribution is strictly prohibited.

Index-6 APTRA Advance NDC, Overview

 User Feedback Form

Title: APTRA™ Advance NDC, Overview

Number: B006‐6597‐K000 Release: Issue 1 Date: May 2019

NCR welcomes your feedback on this publication. Your comments can be of great value in helping us improve
our information products.
Cut


You may send your comments to us electronically. See over for details.

Circle the numbers below that best represent your opinion of this publication.

Ease of use 5 4 3 2 1 0 5 = Excellent

4 = Good
Accuracy 5 4 3 2 1 0
3 = Adequate
Clarity 5 4 3 2 1 0 2 = Fair
1 = Poor
Completeness 5 4 3 2 1 0
Organisation 5 4 3 2 1 0 0 = Not applicable
Appearance 5 4 3 2 1 0
Examples 5 4 3 2 1 0
Illustrations 5 4 3 2 1 0
Job performance 5 4 3 2 1 0
Question resolution 5 4 3 2 1 0
Overall satisfaction 5 4 3 2 1 0

Indicate the ways you feel we could improve this publication.

 Improve the table of contents  Add more/better quick reference aids

 Improve the overview/introduction  Add more examples
 Improve the organisation  Add more illustrations
 Improve the index  Add more step‐by‐step procedures
 Make it less technical  Add more troubleshooting information
 Make it more concise/brief  Add more detail
Write any additional comments you may have below and on additional sheets, if necessary. Include page
numbers where applicable.

Use the following addresses to send your comments to us electronically:

E‐mail ‐ Advance NDC, Information Products

Cut
Fold

If we may contact you concerning your comments, please fill in the information below:

Name:
Organisation:
Company:
Address:

Phone: Fax:

Thank you for your evaluation of this publication. Fold the form where indicated, tape (please do not staple),
and drop in the mail.

F 8763‐0695

Fold

Affix
Postage
Stamp
Here

NCR Financial Solutions Group Ltd

Product Management Feedback
Discovery Centre
3 Fulton Road
Dundee, Scotland
DD2 4SW