PRELIMINARY - DRAFT COPY

Tue Mar 11 14:24:23 2003

Agilis 91x™ Electronic Data Capture

(EDC) 3.0.2 Operating Guide
TP-820864-001A PD 5631
PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Agilis 91x™ Electronic Data Capture

(EDC) 3.0.2 Operating Guide
March 2003
TP-820864-001A PD 5631
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Document History

Document Number Date Remarks

TP-820864-001A 3/2003 Original edition - For Windows NT 4.0 Operating
System and Diebold ix Series and foreign vendor
terminals

Copyright protection is claimed for each revision listed in the document history, as of the date indicated.

Any trademarks, service marks, product names or company names not owned by Diebold that appear in this
document are used for informational purposes only and Diebold claims no rights thereto, nor does such use indicate
any affiliation with or any endorsement of Diebold or Diebold products by the owners thereof.

This document contains proprietary information. If the document pages state the information is confidential
(or words of similar import), then this document is intended solely for the use of the copyright owner’s
employees or other personnel expressly authorized in writing by the copyright owner. Other uses of this
information without the express written consent of the copyright owner are prohibited. This document should
be treated as confidential material for security reasons. Any unauthorized disclosure or use of confidential
material may violate Section 1832 of Title 18 of the United States Code as well as other laws, and may be
punishable by fine and imprisonment.

The information contained in this document is subject to change without notice. When using the document for system
implementation, please call your authorized sales or service representative for any applicable changes.

This document and the information contained herein are provided AS IS AND WITHOUT WARRANTY. In
no event shall the copyright owner or its suppliers be liable for any special, indirect, or consequential damages
of any nature resulting from the use of information in this manual.

No part of this document may be reproduced, stored in a retrieval system, or transmitted, in any form or by any
means: electronic, mechanical, photocopying, recording, or otherwise, without prior written permission from the
copyright owner.

Your use of this document and/or any of the information contained herein constitutes your agreement to all of the
terms stated on this page.

ii
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Contents

Section 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

1.1 Operating Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.1.1 Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.1.2 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1.2 Upgrade Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1.3 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Section 2 Operating Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

2.1 Local Data File Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2.2 Store and Forward (SAF) Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2.3 Unsolicited Status Messages Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Section 3 Remote Command Interface (RCI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Section 4 EDC Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

4.1 Enable EDC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.2 Enable EDC Dial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.3 Disable EDC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.4 Disable EDC Dial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.5 Configuring CSS LEs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.6 EDC Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4.7 Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
4.8 Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
4.9 Reconfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

Section 5 Message, File, and Remote Command Formats . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

5.1 Store and Forward (SAF) Message Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.2 Unsolicited Status Message Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
5.3 SAF Record Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
5.4 Local Data File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
5.5 Remote Command Message Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
5.6 Remote Command Response Message Formats . . . . . . . . . . . . . . . . . . . . . . . . 5-9
5.6.1 Get File Info Response Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
5.6.2 Get Directory Response Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
5.6.3 Get Options Response Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
5.6.4 Get Config Info Response Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

Section 6 Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6.1 EDC for the Maintenance GUI Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
6.1.1 Replenish Supply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6.1.2 Manage Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
6.1.2.1 Copy then Delete Archive . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
6.1.2.2 Copy Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
6.1.2.3 Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
6.2 EDC for the Maintenance TTU Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

iii
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Tables

Table 4-1 EDC Configuration File Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Table 5-1 SAF Message Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Table 5-2 SAF Response Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Table 5-3 Unsolicited Status Message Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Table 5-4 SAF Record Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Table 5-5 Local Data File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
Table 5-6 Remote Command Message Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Table 5-7 Valid Remote Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Table 5-8 Remote Command Response Message Format . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Table 5-9 Valid Remote Command Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10

iv
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Section 1
Introduction

Agilis 91x™ Electronic Data Capture (EDC) 3.0.2 is a user exit application
that, in conjunction with SXA, allows an ATM to store journal information
electronically on the hard disk and support remote commands for the retrieval
of the stored data. EDC 3.0.2 provides support for Windows® NT operating
platform only.

NOTE

A user exit is a separate application that operates under the

direction of SXA. User exits communicate messages to
and from SXA, and SXA directs these messages to other
applications and user exits. User exits provide maximum
system flexibility by allowing you to add additional
applications designed to meet your needs.

EDC supports multiple operating modes that can be configured based on the
customer’s needs. Journal data can be handled using any combination of the
following three methods:

• Store locally to hard disk

• Store to a file that can be retrieved by a host application
• Send to host in unsolicited status message on each print request

EDC supports remote command interface (RCI) which allows a remote

application to send commands to configure EDC or retrieve EDC files. The
remote command interface can be accessed using one of the following methods:

• Dial-up telephone line

• Leased line
• ATM application

1.1 Operating Environment

This section details the hardware and software requirements for the EDC 3.0.2
user exit application.

1.1.1 Hardware

Agilis 91x EDC 3.0.2 requires the following hardware:

• Diebold ix Series ATM or non-Diebold (foreign) terminals

• Dedicated leased line data connection or modem and dial-up phone line

1-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

1.1.2 Software

Agilis 91x EDC 3.0.2 requires the following minimum software:

• Microsoft Windows® NT 4.0 (with Service Pack 6) operating system

• Diebold 91X Terminal Control Software (TCS)
• Agilis 91x Software
• Agilis Base Communications (ABC) 4.0
• Diebold SXA 2.0.0 or greater

1.2 Upgrade Path

There is no compatibility between previous versions of EDC and Agilis 91x

EDC 3.0.2. No upgrade path from previous versions of EDC to Agilis 91x
EDC 3.0.2 is provided.

1.3 Documentation

The following manuals provide information about related applications and

utilities:

• Software Extended Application (SXA) 2.0.0 Operating Guide

(TP-820593-001A)

• Agilis 91x™ Installation and Configuration Guide for Diebold ix Terminals

(TM-000057-001A)

• Agilis 91x™ Installation and Configuration Guide for Foreign Terminals

(TM-000054-001A)

• Agilis 91x™ Maintenance Manual (TP-820744-001A)

1-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Section 2
Operating Modes

EDC can operate in one, two, or three different operating modes. Depending on
the needs of your institution, you can set up EDC to use the local data file option,
the store and forward (SAF) option, the unsolicited status messages option, or any
combination of these three options. The following sections explain these options.

2.1 Local Data File Option

This option causes EDC to store information at an ATM in the local data file.
The file may reside on the ATM’s floppy diskette or on any hard (fixed) disk
drive accessible to the ATM’s operating system, including LAN drives. The
default hard disk drive is the ATM’s C: drive.

Either EDC automatically names and locates the local data file (default) or the
user specifies the path and file name for the local data file. When EDC generates
the local data file automatically, it uses a default file name of EDCLOCAL.DAT
and a default directory path of C:\Diebold\EDC.

When the user names the local data file, a full path and file name should
be specified. If only a file name is specified, EDC generates the file in the
default directory (C:\Diebold\EDC). You can use any file name that is relevant
to your installation.

The maximum size of the local data file is determined by the storage space
available on the floppy diskette or the hard (fixed) disk drive, and the limit
you set through the EDC Local Data File options. When the file approaches
maximum capacity, an error status is sent to the Terminal Control Software
(TCS) indicating a disk space low or disk full condition. You must then perform
one of the following procedures:

• Remove the floppy diskette and replace it with a blank, formatted diskette
(only for user-named local data files generated on the floppy drive).

• Copy the local data file to diskette or some other hard drive (only for
user-named local data files generated on a hard drive).

• Archive the local data file (only for local data files automatically generated
by EDC). The archive procedure copies the local data file to an archive
file, deletes the old local data file, and then prepares a new, empty local
data file for use by EDC.

2.2 Store and Forward (SAF) Option

The store and forward option stores the same type of information as the local
data file option except the SAF option stores it in a different format. The SAF
information is also accessed in a different way. A remote host computer is
capable of issuing commands that upload the EDC SAF file.

2-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

When issued, the following host commands upload the EDC SAF file:

• 0100 - Send first record

• 0101 - Send next and delete previous record
• 0102 - Delete previous record and stop

You can change the default size limit for this file (2000 records) through the EDC
SAF file options (refer to Section 4). If this file is completely filled, EDC cannot
store any more records and sends disk full fault statuses to TCS. Depending on
the setup of your institution and network, the ATM may go out-of-service.

The SAF option allows journal data to be retrieved and processed without
sending personnel to each ATM.

2.3 Unsolicited Status Messages Option

This option causes EDC to send each journal record to the host as an ATM
unsolicited status message. No journal records are stored at the ATM.

2-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Section 3
Remote Command Interface (RCI)

EDC 3.0.2 uses the Remote Command Interface (RCI) to issue commands from a
remote source. These remote commands allow tasks such as archiving, browsing
and retrieval of the EDC local data file to be performed from a remote location.
EDC sends a response to a remote command in a pre-defined format.

The remote command interface can be accessed using one of the following
methods:

• Dial-up telephone line

• Leased line
• Terminal resident application

A supporting software application, EDCDial, supports remote commands sent

through telephone lines when an optional PC dialup feature is installed with
the EDC application.

The following paragraphs briefly describe the commands that may be issued to
EDC from a remote source. Refer to Section 5 for a detailed description of these
commands and the command responses.

Archive
The archive command causes EDC to stop using the current local data file. The
current file is renamed to the archive file-naming standard and moved to the EDC
archive directory. EDC automatically creates a new local data file when the next
print command is received from TCS.

Browse
The browse command retrieves the current local data file. The local data
continues to process transactions and is not affected by the browse operation.

Delete File
The delete file command deletes files from the EDC archive and the check
image directories.

Retrieve EDC File

The retrieve EDC file command transfers an archived EDC local data file from
the ATM to remote source which issued the command.

Get File Information

The get file information command retrieves information about the current local
data file at the ATM. The following information is included in the response:

• Current EDC status

• Last error that occurred
• Size of the local data file
• Amount of space remaining before low threshold status is issued
• Flag indicating if EDC is currently compressing an archived file

Get Directory
The Get Directory command determines the names of the files that have been
archived at a particular ATM or the list of available check image files.

3-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Get Options
The Get Options command retrieves the current set of RCI options used at
the ATM.

Set Option
The Set Option command allows the host to set certain EDC RCI options.

Set ATM File Prefix

The Set ATM File Prefix command sets the EDC archive file prefix. It is four
characters in length and is used as the first four characters of the archive file
name generated by the EDC archive process.

Get Configuration Information

The Get Configuration information command retrieves the following EDC
configuration information from the ATM:

• Maximum size of local data file

• Low threshold value of local data file
• Archive file prefix

3-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Section 4
EDC Configuration

This section presents the steps and procedures required to install and configure
Electronic Data Capture (EDC).

1. From the Extended Applications Installation CD, select the EDC folder.

2. Run the setup.exe file.

4.1 Enable EDC

Use the following steps to enable the EDC application:

1. Ensure the setting Enabled is set to Yes in the file

C:\Diebold\SXA\SXA.INI.

2. Add the following line to the file C:\Diebold\SXA\USEREXIT.LST:

EDC = C:\Diebold\EDC\edc.dll

3. In the following registry setting:

HKEY_LOCAL_MACHINE\Software\Diebold\TCS\DEVICE.INI\
electronic data capture\ditparam, set offset 0x000D to 01

4. In the registry setting, select the following path to change the value
of Characters per line:

HKEY_LOCAL_MACHINE\Software\Diebold\TCS\device.ini\
electronic data capture\ditparam, set offset 0x0011 to the required
hex value. The default is 28 hex (40 decimal).

5. The configuration file for EDC is C:\Diebold\EDC\edc.ini. Make the

required changes to the settings in this file. Then, run edccfg.exe so that
these values are transferred to the DFE file dxedco.dat file that EDC reads.

4.2 Enable EDC Dial

Follow these steps to enable the EDC Dial.

1. Create the registry key:

4-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\
Application_StartUp\EDCDial

2. Add the following String Values under this key:

• program name = edcdial.exe

• working directory =C:\Diebold\EDC

3. Set up the modem on a serial port.

4. The configuration file for EDC is C:\Diebold\EDC\edc.ini. Make the

required changes to the settings in this file in the section [EdcDial
application]. Make sure to enter the correct COM port. Now, run the
edccfg.exe program so that these values are transferred to the DFE file
dxedco.dat file that EDC reads.

4.3 Disable EDC

To disable the EDC, do the following.

1. Remove the line EDC =C:\Diebold\EDC\edc.dll from the file

C:\Diebold\SXA\userexit.lst.

2. In the registry setting:

HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\TCS\DEVICE.INI\
electronic data capture\ditparam, set offset 0x000D to 00

3. Reset the value of Characters per line to 28 hex (40 decimal). In the
registry setting:

HKEY_LOCAL_MACHINE\Software\Diebold\TCS\DEVICE.INI\
electronic data capture\ditparam, set offset 0x0011 to 28

4.4 Disable EDC Dial

Delete the following registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Diebold\
Application_StartUp\EDCDial

4.5 Configuring CSS LEs

If EDC is to receive SAF messages routed through the EDCHST000

CSS LE, then this LE must be appropriately set up in the following file:
C:\Diebold\Css\Devices.ini.

4-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

NOTE

CSS is the Diebold Communication Subsystem for TCS.

However, Agilis Base Communications (ABC). Diebold’s
Communication subsystem, is a data communications package
that provides support for a wide variety of communications
protocols and disciplines for the Agilis 91x software.

If the Remote Command Interface (RCI) is enabled, then the CSS LE

EDC-EDCRMT must be appropriately set up in the following file:
C:\Diebold\Css\Devices.ini.

4.6 EDC Configuration File

The configuration file for EDC is C:\Diebold\EDC\edc.ini. It is an ASCII file

in INI format. Make the required changes to the settings in this file. Run
the edccfg.exe program so that these values are transferred to the DFE file
dxedco.dat that EDC reads. Each of the settings and their valid values are
shown in the following table.

Table 4-1 EDC Configuration File Settings

Section Name Description Valid Values

Variable Name
Processing Options Specifies whether EDC should maintain a local 0, 1
LocalDataFile data file
Processing Options Specifies whether EDC should maintain a Store 0, 1
SafFile and Forward File
Processing Options Specifies whether EDC should send Unsolicited 0, 1
UnsolicitedStatus Statuses
RCI Local Data File Options Specifies whether EDC should process RCI 1, 2, 3
RCILocalFileOption commands and whether the name and location
of the local data file is to be automatically
generated by EDC or specified by the user.
Format:
1 - Auto Local Data File, RCI Enabled
2- Auto Local Data File, RCI Disabled
3 - User chooses location of Local Data File
(RCI Disabled)
RCI Password Specifies whether or not EDC should perform true, false
PasswordCheck RCI password checking
RCI Password The password required for a remote PC to Maximum of 8
Password access this ATM. characters. A ’*’ is
not allowed.
Program Options A bit mapped hex number that indicates the FFFFFF00
MessageFilter classes of journal data that EDC should process. FFFFFFFF
Program Options A logical unit number that EDC places in every Maximum of 13
Luno message received from TCS. characters
Local Data File The path and name EDC uses to store the local Any valid path/name,
FileName data file if RCILocalFileOption is set to user Maximum of 49
chooses location(3). characters

4-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Table 4-1 EDC Configuration File Settings (continued)

Section Name Description Valid Values

Variable Name
Local Data File The maximum number of kilobytes that will be 1 - 9999
LocalMaxSize stored in the local data file
Local Data File When the number of kilobytes remaining in the 1 - 9999
LocalThreshold file reaches this number, EDC issues a warning
status message
Local Data File The prefix EDC uses for the name of the archive Maximum of 4
ArchivePrefix files characters.
Local Data File Specifies whether EDC should automatically true, false
AutoCompress compress the archive files
Local Data File Specifies whether EDC should automatically true, false
AutoDelete delete archived files after specified number of
days
Local Data File Number of days after which archived files should 1 - 999
RetainDays be deleted, if auto-deletion is enabled.
SAF File The maximum number of records that will be 1 - 9999
SafMaxSize stored in the SAF file
SAF File When the number of records remaining in the 1 - 9999
SafThreshold file reaches this number, EDC issues a warning
status message
SAF File The maximum number of bytes EDC stores in a 1 - 1920
SafRecordLength single SAF record
SAF File The maximum number of seconds EDC will wait 1 - 9999
SafSequenceTimeout between host continuation commands after the
first SAF command is sent.
SAF File Specifies the source from where SAF commands 0, 1
Source of SAF Messages will be routed to EDCFormat:0 - SAF messages
routed through SXA
1 - SAF messages routed through EDCHST000
CSS LE

The settings in this section “EdcDial Application“ apply to the EDC Dial application.
Most of these settings, except “COM Port” does not have to be modified.
EdcDial Application Modem Initialization string Maximum of 39
Modem Initialize Command characters
EdcDial Application The commands in this string are performed Maximum of 39
Modem Hangup Command when the modem connection is terminated. characters
EdcDial Application This is the exact message that your modem will Maximum of 14
Modem Command OK return to indicate an acceptance of a command. characters
EdcDial Application The COM Port field specifies the serial port for 1–8
COM Port the modem

4-4
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Table 4-1 EDC Configuration File Settings (continued)

Section Name Description Valid Values

Variable Name
EdcDial Application These are the exact messages that your Maximum of 14
Modem Connect Message1 modem will return to indicate successful characters
connections made with another modem.
EdcDial Application Each message is associated with one of the
Modem Connect Message2 modem’s communication baud rates (up to 9600
baud).Arrange the messages in descending
EdcDial Application order by baud rate.
Modem Connect Message3
EdcDial Application
Modem Connect Message4

EdcDial Application These are the specific messages that the Maximum of 14
Modem Error Message1 modem returns to indicate an error. characters
EdcDial Application
Modem Error Message2
EdcDial Application
Modem Error Message3
EdcDial Application
Modem Error Message4

4.7 Startup

EDC is automatically started when TCS is started, if enabled as described above.

EDC Dial is automatically started when the system comes up, if enabled
as described above.

To start EDC Dial independently, open a command window and change the
directory to C:\Diebold\EDC. Type edcdial.exe to run the program.

4.8 Shutdown

EDC cannot be shutdown independently. Shutdown TCS to shutdown EDC.

To shutdown EDC Dial, activate the EDC Dial Window and press the CTRL+C
keys.

4-5
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

4.9 Reconfiguration

EDC can be reconfigured using the SXA trace window.

1. From Start, Programs, SXA, open the SXA TRACE WINDOW. Select
EDC in the Reconfigure menu.

2. Reconfiguration can be carried out from the command line using the
SXA trigger utility. Therefore, open a command window and change the
directory to c:\diebold\sxa. Type sxatrigr/S:/Reconfigure:EDC.

4-6
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Section 5
Message, File, and Remote Command Formats

This section contains all the message, file, and remote command formats related
to the Electronic Data Capture (EDC) 3.0.2 user exit application.

The message build files used by previous versions of EDC are now handled
internally by the software, thereby replacing the MBU source files.

5.1 Store and Forward (SAF) Message Format

This section lists the format of the host command that is sent to EDC in order to
retrieve EDC records (Table 5-1). It also lists the EDC SAF response format
(Table 5-2). Messages received by SXA at its high-side and low-side connections
are routed to user exits, including EDC, in the order configured in SXA. EDC
processes only SAF messages that are relevant to its functionality and passes all
other messages unchanged.

EDC processes SAF commands from the host by reading the mailbox associated
with the EDCATM000 CSS LE. Responses to SAF commands are CSS written to
the SAF host.

Table 5-1 SAF Message Format

Field Length Description

FS 1 Field separator (1C)

Msg ID 1 C

FS 1 Field separator (1C)

LUNO Variable Not checked - only used for reply (up to 13 characters
supported)

FS 1 Field separator (1C)

Cmnd code 4 Command to be executed:

• 0100 -> read first SAF record

• 0101 -> reset previous / send next record

• 0102 -> reset previous / stop

FS 1 Field separator (1C)

Table 5-2 SAF Response Format

Field Length Description

FS 1 Field separator (1C)

Msg ID 5 ’RESP ’

FS 1 Field separator (1C)

5-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Table 5-2 SAF Response Format (continued)

Field Length Description

Msgseq# 4 0000-9999 (incremented each time by EDC) initialized to 0000

each time EDC started

FS 1 Field separator (1C)

LUNO Var Copied from host command (up to 13 characters supported)

FS 1 Field separator (1C)

Resp code 4 Outcome of command processing:

• 0000 -> command executed

• 0001 -> End of file - the last data was sent in the previous
message

• 0103 -> execution incomplete - file error

• 0104 -> host command had invalid format

• 0110 -> invalid command - rejected

• 0120 -> sequence error

FS 1 Field separator (1C)

Cmnd code 4 Host command that is being replied to:

• 0100 -> read first SAF record

• 0101 -> reset previous / send next record

• 0102 -> reset previous / stop

FS 1 Field separator (1C)

Resp data Var Printer data (tag, time, date, LUNO, LF, printer msg)

5-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

5.2 Unsolicited Status Message Format

This section lists the format of the ATM unsolicited status message that is sent to
the host when an EDC transaction is processed (Table 5-3).

Table 5-3 Unsolicited Status Message Format

Field Length Description

Header 1 STX

Unsol ID 1 1

Msg ID 1 5 (EDC)

FS 1 Field separator (1C)

LUNO Var Field separator (1C)

FS 1 Field separator (1C)

FS 1 Field separator (1C)

Msgsource 1 = (EDC)

Msg Var Status text (tag, time/date, printer text)

Trailer 1 ETX

5.3 SAF Record Format

This section lists the internal format of an SAF record (Table 5-4) that is sent to
the host after the host issues a retrieve message to the ATM. The SAF file has the
standard 40-byte file header and uses a circular file manager format containing
fixed-length ASCII (text) records. Each record will be at least 29 bytes and
should not be any larger than 1949 bytes (the default is 278 bytes).

Table 5-4 SAF Record Format

Field Length Description

Length 2 Number of bytes in record - this field is removed before the

record is sent to the host

Tag 1 Identifies the type of data in the record:

• 0 -> status data
• 1 -> transaction data
• 2 -> device activity counter data
• 3 -> device activity log data
• 4 -> diagnostic data
• 5 -> continuation of previous record
• 6 -> configuration data
• 7 -> diagnostics data

Time/date 12 Time and date when data was captured (mmddyyhhmmss)

LUNO Variable Terminal logical unit number, ending with a line feed (LF)
character (maximum 13 characters plus LF)

Data Variable Data which TCS sends to the EDC printer (Maximum length is
1920)

5-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

5.4 Local Data File Format

This section lists the format of the local data file (Table 5-5). The information in
the local data file is stored in a standard ASCII (text) format.

Table 5-5 Local Data File Format

Field Length Description

Tag 1 Identifies the type of data in the record:

• 0 -> status data
• 1 -> transaction data
• 2 -> device activity counter data
• 3 -> device activity log data
• 4 -> diagnostic data
• 5 -> continuation of previous record
• 6 -> configuration data
• 7 -> diagnostics data

Seq Number 6 Sequential number to detect inserted/deleted records

Time/date Variable Time and date when data was captured (mmddyyhhmmss),
ending with an ’a’ (ASCII line feed). The time and date cannot
exceed 12 characters plus the delimiter

LUNO Variable Terminal logical unit number, ending with an ’a’ (ASCII line
feed). The LUNO cannot exceed 13 characters

Data Variable Data which TCS sends to the EDC printer - maximum length
is 1920 - several characters are translated into printable
characters.
• 0x0a LF -> a - line feed
• 0x0b VT -> b - alt char set
• 0x0c FF -> a - form feed (treated like LF)
• 0x0d CR -> d - carriage return
• 0x0e SO -> e - insert multiple blanks
• 0x1b ESC -> s - escape

TCS journal printer text is converted to upper-case characters,

so this translation is not ambiguous.

MAC 8 Record authorization code - used to ensure data integrity

5.5 Remote Command Message Formats

This section shows the format of the remote command messages sent to an ATM
from a remote computer (Table 5-6). All remote commands are in ASCII.
The commands consist of multiple fields with each field terminated by a field
separator character (hex 1C). If a field is not used in a message, its field separator
character is still required.

5-4
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Table 5-6 Remote Command Message Format

Field Length Contents

Header 3 EDC

FS 1 Field separator (1C)

Command ID 1 Refer to Table 5-7

FS 1 Field separator (1C)

Password 16 Nibble-expanded password

[1]

FS 1 Field separator (1C)

Parm1 5 (Max) Parameter 1; refer to command

descriptions following table

FS 1 Field separator (1C)

Parm2 5 (max) Parameter 2; optional message sequence

number

FS 1 Field separator (1C)

Parm3 15 (Max) Parameter 3; refer to command

descriptions following table

FS 1 Field separator (1C)

[1]Encrypted passwords are deemed necessary for security on dial-up phone lines. Password checking is enabled or disabled
through a configuration option. Refer to Section 4.

An unused field can be left empty. A terminating data separator, 0X1C, is

required after each used/unused field. The optional sequence number field is a
5-digit ASCII number. EDC does not check the sequence number in remote
commands. The remote command response message has the same sequence
number as in the remote command message that generated it, allowing a host
application to check the number (if required). If the command message does not
contain a sequence number, the command response message contains 00000 in
its sequence number field. The valid remote commands for EDC are shown
in Table 5-7.

Table 5-7 Valid Remote Commands

Command ID Parm1 Parm2 Parm3

Archive A Unused Sequence # Unused

Browse B Block # Sequence # Unused

Delete File D Dir ID Sequence # File name to delete

Retrieve EDC File R Block # Sequence # File being retrieved

Get File Info I Unused Sequence # Unused

Get Directory L Dir ID Sequence # Unused

Get Options G Unused Sequence # Unused

Set Option O Unused Sequence # ID/Value

Set ATM File Prefix P Unused Sequence # 4 character file prefix

Get Config Info F Unused Sequence # Unused

5-5
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

In the following command descriptions, the examples assume that password

checking is disabled. Therefore, no passwords are sent in the remote command
messages (password field is empty for all examples). In the examples, a field
separator is represented by a ♦ (diamond) character.

Archive
The archive command causes EDC to stop using the current local data file. The
current file is renamed to the archive file naming standard and moved to the EDC
archive directory. EDC automatically creates a new local data file when the next
print command is received from TCS.

EDC uses the following convention to name archived local data files:

ppppjjjy.r

or

ppppjjjy.rCM

Where the following conditions apply:

• pppp = the file name prefix

• jjj = the Julian date

• y = the last digit of the current year

• r = the revision number (if a file gets archived more than once a day)

• CM = compressed file indicator (if auto compression of archived files is

enabled in EDC)

The default for the file name prefix is EDC. The file name prefix can be set at
the ATM through the configuration options. Other than the optional sequence
number, the Archive command uses no parameters.

EXAMPLE

EDC♦A♦♦♦12345♦♦ (archive the local data file)

Browse
The Browse command retrieves the current local data file. The local data file
can continue to process transactions and is not affected by Browse operation.
This command must be repeated, retrieving one block of data (1024-bytes)
per command, until an end-of-file status is returned in the response to the
Browse command.

Parameter 1 is the block number to be retrieved. Parameter 3 is not used.

5-6
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

EXAMPLE

EDC♦B♦♦00000♦12345♦♦ (retrieve block 0)

EDC♦B♦♦00001♦12346♦♦ (retrieve block 1)
EDC♦B♦♦00002♦12347♦♦ (retrieve block 2)
... and so on ...

Delete File
The Delete file command is used to delete files from the EDC archive diectory
and from the check image directory.

Parm1 is a flag indicating whether the file to be deleted is in the EDC archive
directory or in the check image directory:

• E = file is in the EDC archive directory

• C = file is in the check image directory

EXAMPLE

EDC♦D♦♦E♦12345♦filename.dat (delete filename.dat from EDC directory)

Retrieve EDC File

The Retrieve EDC file command is used to transfer an archived EDC local
data file from the ATM. Block numbers start with zero and must continue
sequentially until an end-of-file status is returned in the response to the retrieve
EDC file remote command. Blocks consist of 1024-bytes of file data. After
the final data block is sent, end-of-file is sent in response to the next retireve
EDC file command (indicated in the response by a block size of zero and
block count of zero). If the end-of-file is returned in the response, no file
data is contained in that response.

Parm1 is the block number to be retrieved. Parm3 is the name of the file to be
retrieved.

EXAMPLE

EDC♦R♦♦00000♦12345♦filename.dat (retrieve block 0 of filename.dat)

EDC♦R♦♦00001♦12346♦filename.dat (retrieve block 1 of filename.dat)
EDC♦R♦♦00002♦12347♦filename.dat (retrieve block 2 of filename.dat)
...and so on...

Get File Info

The Get File Info command is used to retrieve information about the currently
active local data file at the ATM. Information returned in the response include
the current status of EDC, the last error which occurred (if any), the size of the
local data file, and the amount of space remaining in the file before a Paper Low
status is returned to TCS. The response also includes a flag indicating if EDC is
currently compressing an archived file.

No parameters are used in the Get File Info command.

EXAMPLE

EDC♦I♦♦♦12345♦♦ (retrieve file info)

5-7
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Get Directory
Get Directory is used to determine the names of the files which have been
archived at a particular ATM or the list of available check image files.

Parm1 is a flag indicating whether the directory list of the EDC archive directory
or the check image directory is to be sent in the response:

• E = get EDC archive directory

• C = get check image directory

EXAMPLE

EDC♦L♦♦E♦12345♦♦ (retrieve EDC archive directory information)

Get Options
The Get Options command is used to retrieve the current set of RCI options used
at the ATM. Currently, there is only one option defined, EXP (EXPAND_FILES).

The EXP option is set when a leased-line protocol supports only ASCII
characters.

No parameters are used.

EXAMPLE

EDC♦G♦♦♦12345♦♦ (retrieve current options)

Set Option
The Set Option command allows the host to set certain EDC RCI options.
Option names are three-character IDs and must be followed by either 0 or 1 to
turn the option off or on. Only one option can be set per command. Currently,
only one RCI option exists, EXP (EXPAND_FILES). The default value of the
option is Off.

The EXPAND_FILES option is used when the leased-line protocol supports

only ASCII characters. Each nibble of file data transferred is expanded to an
ASCII printable byte.

Parm3 is the option ID followed by either 0 (Off) or 1 (On).

EXAMPLE

EDC♦O♦♦♦12345♦EXP0♦ (turn OFF the EXPAND_FILES option)

5-8
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Set ATM File Prefix

This command sets the EDC archive file prefix, which is used during the archive
process to create the archive file name. It is four characters in length and is used
as the first four characters of the archive file name generated by EDC. The file
prefix must consist of only those characters valid in Windows filenames. The
file prefix is normally set during configuration of EDC at the terminal. This
configuration was done in the EDCOPTN utility in previous versions of EDC. In
EDC 3.0.2, this option can be set using the ATM configuration interface. The
default value of the file prefix is ’EDC_". The Set ATM File Prefix command is
provided so that a unique file prefix can be remotely set if such a setting was not
done during the EDC installation and configuration.

Parm3 is the archive file prefix.

EXAMPLE

EDC♦P♦♦♦12345♦EDCB_♦ (set archive file prefix to EDCB)

Get Config Information

The Get Config Information command retrieves most of the EDC configuration
information from the ATM. It consists of the maximum size of the local data file,
low threshold value, the archive file prefix, and other information.

No parameters are used in the Get Config Information command.

EXAMPLE

EDC♦F♦♦♦12345♦♦ (Retrieve configuration information)

5.6 Remote Command Response Message Formats

This section shows the format of the remote command response messages that
are returned to a remote computer from an ATM (Table 5-8).

All remote command responses are in ASCII. The responses consist of several
fixed-length fields followed by a variable-length data field. There are no
field separators in the response messages. The protocol in use must detect
transmission errors.

Table 5-8 Remote Command Response Message Format

Field Length Description

Header 3 EDC

Command ID 1 Same as the command that generated the response; refer

to Table 5-9.

Sequence No. 5 Same as the command that generated the response; if no

sequence number in command message, value is 00000.

Status 2 Refer to descriptions following the table.

Option ID 1 E = expanded data in data field; N = normal (not expanded)

data in data field.

5-9
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Table 5-8 Remote Command Response Message Format (continued)

Field Length Description

Block Size 5 Number of bytes of data in each data block.

Block Count 5 Number of data blocks in the data field.

Data Variable Requested data (if any).

The valid remote command responses for EDC 3.0.2 are shown in Table 5-9.

Table 5-9 Valid Remote Command Responses

Function ID Data Field Contents

Archive A not used

Browse B Local file data (up to 1024 bytes)

Delete File D not used

Retrieve EDC File R Archived file data (up to 1024 bytes)

Get File Info I Local data file information

Get Directory L Archive directory file names

Get Options G Current option status

Set Option O not used

Set ATM File Prefix P not used

Get Config Info F Configuration information

The valid values for the Status field are as follows:

• 00 = Normal completion
• 01 = End of file occurred
• 02 = File does not exist
• 03 = Error in file (i.e., crc error)
• 04 = Command had an invalid format
• 05 = Invalid command
• 06 = Unable to access information requested
• 07 = Timeout occurred
• 08 = Unable to access file
• 09 = Application out of memory
• 10 = Invalid password
• 11 = Unknown error

The valid values for the Option ID field are as follows:

• E = Data is expanded
• N = Data is not expanded (normal)

5.6.1 Get File Info Response Data

This section describes the structure and the contents of the Get File Info
response data fields.

5-10
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

The structure for the Get File Info data is as follows:

struct EFIL_STR

char STATUS[5]
char RECORDS_WRITTEN[8]
char SIZE[6]
char REM_SPACE[8]
char PROGRESS_FLAGS[4]
char OS_ERRORS[5]

The Get File Info response data contains six fields that are defined in the
following paragraphs.

Application Status
Size: 5 ASCII bytes
Description: The Application Status field contains a code that defines the status
of the last local data file access. The valid codes are as follows:

• 00000 = Normal completion

• 00001 = Disk space low
• 00002 = Disk full
• 00003 = Write protected
• 00004 = No disk in drive
• 00005 = Disk not formatted
• 00006 = Hard I/O error
• 00007 = No room on disk
• 00008 = Other error (unknown)

Number of Records Written

Size: 8 ASCII bytes
Valid Values: 00000001 to 99999999
Description: The Number of Records Written field contains the number of
records currently stored in the local data file.

File Size
Size: 6 ASCII bytes
Valid Values: 00000001 to 99999999
Description: The File Size field contains the current (actual) size of the local
data file in kilobytes (KB).

Remaining Hard Disk Space

Size: 8 ASCII bytes
Valid Values: 00000001 to 99999999
Description: The Remaining Hard Disk Space field contains the amount of disk
space remaining on the ATM’s hard disk in kilobytes (KB).

File Processing Progress Flags

Size: 4 ASCII bytes
Valid Values: 0 or 1
Description: The File Processing Progress Flags field contains four flags that
define the progress of various local data file processes. The four flags are
indicated in the four bytes of this field. The only flag defined is flag 0. Flags 1
through 3 are reserved for future use. Flag 0 defines the progress of the archive
file compression. If the flag is set to ASCII 1, EDC is actively compressing
an archive local data file. If the flag is set to ASCII 0, no file compression
is in progress.

5-11
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Operating System Errors

Size: 5 ASCII bytes
Description: The Operating System Errors field contains the most recent
Windows NT system error code returned by the ATM’s operating system.
Refer to the applicable Windows NT documentation for definitions of the
system error codes.

5.6.2 Get Directory Response Data

This section describes the structure and the contents of the Get Directory
response data fields.

The structure for the Get Directory data is as follows:

struct EDIR_STR

unsigned char NAME[12]

size SIZE[9]

The Get Directory response data contains two fields that are defined in the
following paragraphs. The two-field structure repeats for each file in the
requested directory.

File Name
Size: 12 ASCII bytes
Description: The File Name field specifies the name of a file in the requested
directory. For EDC 3.0.2, the only valid directory is the EDC archive directory.

Since the size is limited to 12 ASCII bytes, the the filename must follow the
8.3 format.

File Size
Size: 9 ASCII bytes
Valid Values: 000000001 to 999999999
Description: The File Size field contains the size in kilobytes (KB) of the
file specified in the File Name field.

5.6.3 Get Options Response Data

This section describes the structure and the contents of the Get Options response
data fields.

The structure for the Get Options data is as follows:

struct EOPT_STR

char ID[3]
char VALUE

The Get Options response data contains two fields that are defined in the
following paragraphs. The two-field structure repeats for each option enabled or
disabled at the ATM.

5-12
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Option ID
Size: 3 ASCII bytes
Description: The Option ID field specifies the identifier for an EDC ATM
option. The only valid option defined is for expanded data file transfers (EXP).

Option Value
Size: 1 ASCII byte
Description: The Option Value field identifies whether the option specified in
the Option ID field is enabled or disabled. The valid values are as follows:

• 0 = option disabled (off)

• 1 = option enabled (on)

5.6.4 Get Config Info Response Data

This section describes the structure and contents of the Get Config Info response
data fields.

Following is the structure of the Get Config Info data:

struct ECGF_STR
unsigned char LOCAL_MAX[5]
unsigned char LOCAL_LOW[5]
unsigned char ARC_PREFIX[4]
unsigned char SAF_MAX[5]
unsigned char SAF_LOW[5]
unsigned char SAF_LRECL[5]
unsigned char SAF_TMO[5]
unsigned char RETAIN_DAYS[5]
unsigned char OPCODE[5]
unsigned char CHECK_PASSWORD
unsigned char AUTO_COMPRESS
unsigned char AUTO_DELETE

The Get Config Info response data contains twelve fields that are defined in
the following paragraphs.

Local Data File Maximum Size

Size: 5 ASCII bytes
Valid Values: 00001 to 99999
Description: The Local Data File Maximum Size field specifies the maximum
size of the local data file in kilobytes (KB).

Local Data File Low Threshold Size

Size: 5 ASCII bytes
Valid Values: 00001 to 99999
Description: The Local Data File Low Threshold Size field specifies the size of
the local data file in kilobytes (KB) at which a low threshold warning is issued.

Archive File Name Prefix

Size: 4 ASCII bytes
Description: The Archive File Name Prefix field specifies the prefix characters
that EDC uses to name archive files at the ATM. The file name prefix can be up
to four characters in length and contain any four characters that in a Windows NT
environment conform to Windows file naming conventions.

5-13
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

SAF File Maximum Size

Size: 5 ASCII bytes
Valid Values: 00001 to 99999
Description: The SAF File Maximum Size field specifies the maximum size in
records of a Store and Forward (SAF) file.

SAF File Low Threshold Size

Size: 5 ASCII bytes
Valid Values: 00001 to 99999
Description: The SAF File Low Threshold Size field specifies the size of the
SAF file in kilobytes (KB) at which a low threshold warning is issued.

SAF Record Length

Size: 5 ASCII bytes
Valid Values: 00001 to 99999
Description: The SAF Record Length field specifies the length of each record in
kilobytes (KB) in a SAF file.

SAF Timeout
Size: 5 ASCII bytes
Valid Values: 00001 to 99999
Description: The SAF Timeout field specifies the maximum number of seconds
EDC waits between host SAF continuation commands.

Number of Days to Retain Archived Files

Size: 5 ASCII bytes
Valid Values: 00001 to 99999
Description: The Number of Days to Retain Archived Files field specifies the
number of days EDC retains archived files when the auto-deletion option is
enabled.

EDC Processing Options

Size: 5 ASCII bytes
Descripton: The EDC Processing Options field specifies which EDC processing
options are selected at the ATM. The value in this field is the sum of the weights
of the selected options as shown in the following table:

Weight Option

8 Remote command interface

4 Unsolicited status

2 Host SAF file

1 Local data file

RCI Password Checking

Size: 1 ASCII byte
Valid Values: 0 or 1
Description: The RCI Password Checking field specifies whether or not EDC
performs RCI password checking.

Auto Compression
Size: 1 ASCII byte
Valid Values: 0 or 1

5-14
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Description: The Auto Compression field specifies whether or not EDC

performs automatic compression of the local data file when the file is archived.

Auto Deletion
Size: 1 ASCII byte
Valid Values: 0 or 1
Description: The Auto Deletion field specifies whether or not EDC performs
automatic deletion of archived files after the set number of days. See the Number
of Days to Retain Archived Files field.

5-15
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

5-16
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Section 6
Maintenance

The Electronic Data Capture (EDC) application in the Agilis 91x Maintenance
application allows the following operations from either the GUI or the TTU
interfaces:

• Archives current file to copy to the hard drive while preparing a new
file to accept data

• Copies a file previously archived to a floppy disk

The Electronic Data Capture, an optional feature of the Agilis 91x Software
Suite, only appears if it is installed and enabled.

For more information on the Agilis 91x Maintenance software, refer to the Agilis
91x™ Maintenance Manual (TP-820744-001B).

CAUTION

Do NOT remove the floppy diskette from the drive when

the busy light is lit. This may cause EDC to lose in-progress
transactions and may cause unpredictable results. It is also
necessary that the floppy diskette be a newly-formatted
1.44-MB floppy diskette. It must also have no other data on
it when writing to it. If your EDC local data file is larger
than 1.44 MB, you must copy the file to another directory
on the current hard drive, or to any valid path on a hard
drive accessible to your system.

6.1 EDC for the Maintenance GUI Interface

The Electronic data capture operation can only be used if it is installed and
enabled. It is a separate option for the Agilis 91x Software Suite.

After selecting Supply, Load/Unload supplies, and then Electronic data capture,
the following screen appears.

G5631103

6-1
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Status messages appear that provide the following information:

• Supply - Indicates OK if the EDC file has not reached the low threshold level
or maximum file level. A low message appears if the low threshold level is
reached, and an out message appears if the maximum file level is reached.

• Archives - Indicates if there are archived files present in the hard drive.
Either NONE or PRESENT appears.

Select the Operations command and the following menu appears, as shown in
the following screen.

G5631104

The following operations can be selected:

• Select Replenish Supply to archive the current file and prepare a new
file to accept data.

• Select Manage Archive to copy a file previously archived to a floppy disk.

• Select Help to obtain a description of the Electronic data capture command.

• Select Exit to return to the Supply screen.

6.1.1 Replenish Supply

The Replenish Supply selection archives the current file and prepares a new
file to accept data.

After selecting Replenish Supply from the menu, the following window appears.

6-2
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

G5631105

Select Cancel to cancel the archiving process and return to the Supply screen.

Select OK to archive the current electronic Journal file to the hard drive and
prepare a new file to accept data. The following screen appears after completion
of this process.

G5631106

Select OK again, to return to the Operations screen.

6.1.2 Manage Archives

The Manage archives operation copies a file, previously archived, to a floppy

disk.

Select Manage Archives from the menu, and the following window appears.

6-3
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

G5631107

Selecting the Exit button returns you to the Operations screen.

All EDC archived files available appears in this screen. Select an archived file
to copy to the a:\ drive by highlighting it with your mouse. Be sure to insert a
floppy disk into the drive.

After selecting the archived file, select the Copy Operations button. The
following screen appears.

G5631108

These selections are described the following paragraphs.

6.1.2.1 Copy then Delete Archive

The Copy then Delete Archive command copies the selected file to the floppy disk
and then deletes the file from the hard drive, as shown in the following screen.

Select the Copy then Delete Archive button and the following screen appears.

6-4
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

G5631111

Select the OK button to begin the copy process, or select the Cancel button to
cancel the operation.

After selecting the OK button, the following screen appears.

G5631112

Upon completion of the archive copying, the following screen appears,

confirming the process.

G5631113

Select the OK button and you are returned to the Copy Operations archive screen.

6.1.2.2 Copy Archive

The Copy Archive command copies the file to the floppy disk without deleting
the file from the hard drive. Select this option and the following screen appears.

6-5
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

G5631110

Select the Cancel button if you wish to return to the EDC Operations screen.
Any pre-selected archive is also copied to the floppy drive.

After selecting the OK button, the archive begins the copy process, while the
following screen appears.

G5631110A

Upon completion of the archive copying process, the following screen appears.

G5631110B

Select the OK button to return to the Copy Operations archive screen.

6.1.2.3 Exit

The Exit command returns you to the Agilis 91x Maintenance menu screen.

6-6
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

6.2 EDC for the Maintenance TTU Interface

Before selecting the EDC option, be sure to have a formatted floppy disk in the a:
drive. Follow these steps to access the EDC Status and Operations menu while
using the Terminal Text Unit (TTU) interface.

1. Type the numbered selection for the Supply command.

2. Type the numbered selection for Load/Unload Supplies. A Supply Status

and Operations screen appears, as follows.

Electronic Journal Supply - Status and

Operations
Supply: OK

Archives: NONE
10 Replenish Supply
11 Manage Archives
12 Help
13 Exit

8 DOWN 9 BACK

Status messages appear that provide the following information:

• Supply - Indicates OK if the EDC file has not reached the low
threshold level or maximum file level. A low message appears if the
low threshold level is reached, and an out message appears if the
maximum file level is reached.

• Archives - Indicates if there are archived files present in the hard

drive. Either NONE or PRESENT appears.

The following operations can be selected from the screen menu:

• Type the numbered selection for Replenish Supply to archive the

current file and prepare a new file to accept data.

• Type the numbered selection for Manage Archives to copy a file

previously archived to a floppy disk.

CAUTION

Be sure to have a blank formatted, floppy

disk in drive a: if you are copying archives to
that media device.

6-7
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

• Type the numbered selection for Help to obtain a description of the

Electronic data capture command.

• Type the numbered selection for Exit to return to the Supply screen.

Type the numbered selection for the option you wish to perform. Follow all
remaining steps for the copying process.

Replenish Supply
Each time you select the Replenish Supply option from the Status and Operations
menu, a data archive is created on the local hard drive and will be listed when you
select the Manage Archives option. However, if you continue using the Replenish
Supply option without exiting, the same archived file initially created, continues
to be replenished. Entering and exiting a Replenish Supply session creates a new
data archive, adding it to the list of archives displayed in the Manage Archives
option. Follow these steps to archive the Electronic Journal Data.

1. After typing the numbered selection for Replenish Supply, another

screen appears, as follows.

Electronic Journal Supply - Replenish Supply

Supply: OK
Select OK to archive Electronic Journal Data:
10 OK. Produce an Archive of the current Electronic Journal
Data file.
11 Cancel.Prepare the Electronic Journal Data file to
accept new data.

8 DOWN 9 BACK

2. Type the numbered selection for OK to archive the current electronic

Journal file and prepare a new file to accept data and the following
screen appears.

Electronic Journal Supply - Archiving Data

Status
10 OK

9 BACK

Type the numbered selection for OK to archive the data. You are returned
to the previous Supply Status and Operations menu.

3. Type the numbered selection for Cancel to cancel the archiving process
and you are returned to the Supply Status and Operations menu.

Manage Archives
Follow these steps to copy the Electronic Journal Data archive to a floppy
diskette on the a: drive.

1. After typing the numbered selection for Manage Archives, another

screen appears, as follows.

6-8
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

Electronic Journal Supply - Manage Archives

Select the archive to be copied:
10 edc_0383.0 1532 2/7/2003
11 edc_0493.0 133 2/18/2003

8 DOWN 9 BACK

2. Type the numbered selection for the archive you want to copy. In the
following example, the archive for 2/7/2003 was copied. The following
screen appears.

Electronic Journal Supply - Manage Archives

Extension
The archive will be copied to a:\
10 Copy then Delete Archive
11 Copy Archive
12 Exit

9 Back

CAUTION

Be sure to have a blank formatted, floppy disk

in drive a: if you are copying archives to that
media device.

a. The Copy then Delete Archive option allows you to copy the current
selected data archive to the a:\ drive and then deletes the archived
data file from the hard drive. After typing this numbered selection,
the following screen appears.

Electronic Journal Supply - Insert Diskette

Please make sure there is a formatted, writable, floppy
diskette inserted into drive a:.
10 OK
11 Cancel

9 Back

Typing the numbered selection for OK copies the data to the floppy
diskette in the a: drive and the following screen appears, after a brief
PLEASE WAIT screen flashes.

Electronic Journal Supply - Copy Status

The file a:\edc_383.0 has been created.
Please remove the diskette.

10 OK

6-9
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

9 Back

Remove the diskette from the drive and type the numbered selection
for OK to return to the Supply Status and Operations menu.

b. The Copy Archive option copies the archived data to the a: drive but
DOES NOT DELETE the archive from the hard drive. After typing
the numbered selection for this option, the following screen appears.

Electronic Journal Supply - Insert Diskette

Please make sure there is a formatted, writable, floppy
diskette inserted into drive a:.
10 OK
11 Cancel

9 Back

Type the numbered selection for OK to write the target file to the
floppy. If a data file already exists on the diskette, the screen displays
a Prompt for Overwrite message. You are returned to the Manage
Archives listing. You can either select another data archive to copy, or
scroll back to the previous menu.

Type the numbered selection for the Cancel option and the following
screen appears.

Electronic Journal Supply - Copy Status

the file was not copied to a:edc_0493.0. The
archive was not affected.

10 OK

9 Back

Type the numbered selection for OK to return to the Manage Archives

listing.

c. The Exit option returns you to the Manage Archives listing. You can
either select another data archive, or scroll back to the previous menu.

Help
After typing the numbered selection for the Help option, the following screen
appears.

Electronic Journal Supply - Help

The Electronic Journal supply interface allows you
to manage Electronic Journal Data produced by the
Electronic Data Capture (EDC) application.
Using this interface, you can archive the current
Electronic Journal Data and create more space in
the local Electronic Journal file by selecting

6-10
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

"Replenish Supply". You can copy or move the

archives produced by replenishment to another
location by selecting "Manage Archives".
_______________________________________________________
10 OK

9 Back

Type the numbered selection for the OK option to return to the Supply Status
and Operations menu.

Exit
After typing the numbered selection for the Exit option, you are returned to the
Agilis 91x Maintenance menu screen.

6-11
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 PRELIMINARY - DRAFT COPY
Tue Mar 11 14:24:23 2003

6-12
©Diebold, Incorporated (3/2003) - All Rights Reserved
TP-820864 (Ed. A)
 USER RESPONSE FORM

Diebold continually strives to improve its products. Please use this form to give us your ideas on this document.

All comments received become the property of Diebold without obligation to the user.

Agilis 91x™ Electronic Data Capture (EDC) 3.0.2 Operating Guide, TP-820864-001A

How often do you use this manual?

In my daily work (daily or weekly)
Once in a while (once a month)
Infrequently (once in three months)

Please rate this document on the following items:

EXCELLENT GOOD POOR
Accuracy
Clarity
Organization
Completeness
For suggestions and comments, please use the space below.

Name Date
Company Department
Address City
State/Province Country Zip/Postal Code
Daytime Phone Number

Thank you for your time and cooperation. No postage is necessary if mailed in the U.S.A.

FAX (330) 490-6160

FOLD AND TAPE PLEASE DO NOT STAPLE FOLD AND TAPE

NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES

BUSINESS REPLY MAIL

FIRST-CLASS MAIL PERMIT NO 3 CANTON, OH

POSTAGE WILL BE PAID BY ADDRESSEE

ATTN DEPT 9-56-1

PO Box 8230
Canton, OH 44799-6147

FOLD AND TAPE PLEASE DO NOT STAPLE FOLD AND TAPE

(Staples can cause problems with automated mail sorting equipment)