Local Screen Changes (LSC) Version 2.0.0 Operating Guide: TP-820594-001A PD 4771
Local Screen Changes (LSC) Version 2.0.0 Operating Guide: TP-820594-001A PD 4771
Local Screen Changes (LSC) Version 2.0.0 Operating Guide: TP-820594-001A PD 4771
0
Operating Guide
TP-820594-001A PD 4771
Local Screen Changes (LSC) Version 2.0.0
Operating Guide
May 2001
TP-820594-001A PD 4771
Document History
Copyright protection is claimed for each revision listed in the document history, as of the date indicated.
The following are registered trademarks of Diebold and its wholly-owned subsidiaries and cannot be used without the written permission of
Diebold, Incorporated: 1/Link®, After Hour®, ATM Supply Shop®, Bank CashGard®, BOLDIMAGE®, Campus Monitor®, Card Glove®,
CashGard®, CashSource Plus®, CashSource + ®, Comm Master®, Diebold®, Diebold Visual Auto Teller®, Easy-aire®, Fourth Financial®,
Guardian®, Herring-Hall-Marvin®, ICAM®, Image 35®, Integrated Campus Access Management®, Intellisys Network®, InterBold®, iq®, iq
Epic®, iq System®, i Series®, ix Series®, MedSelect®, MedSelect Systems®, MicroBranch®, Movie Machine®, MULTI-GUARD®, OPTinet®,
OPTix®, PRESIDER®, REACT®, Securestat®, Securomatic®, Selectrac®, Teller Assist®, TITAN®, Wedge-lock®, XApCheck®, XApCoupon®,
XApEvent®, XApWare®.
The following are trademarks of Diebold and its wholly-owned subsidiaries and cannot be used without the written permission of Diebold,
Incorporated: ADAPT-A-WALL™, Advantage™, Campus Systems Gold™, Cardsystem Gold™, Cardsystems Gold™, Changing the Way People
Pay™, CS Gold™, CTU™, DCASH™, DI and DESIGN™, DICASH™, Diebold Automate III™, Diebold On-line Community™, DOC™,
DOHS™, DTIS™, EASYAIRE™, EASY-AIRE ® TWO-WAY LITE™, eBOLD™, e-BOLD™, ENCORE™, Event Management System™,
ExpressBus™, Express Delivery™, iConnect™, IDM™, Impressys™, Intelligent Depository Module™, Involve™, ix Performance Package™,
Maintenance Manager™, MDS™, MedSelect Smartstock™, NAS™, PACE™, PayStation™, PosiDoc™, RemoteTeller™, Revisor™, RTS™,
SECURITY VESTIBULE™, SMS 1000™, TimeSaver™, WristBand™, XApLogoPlus™.
THE MOVIE MACHINESM , DECALSM , FASTLINESM , and RECOVERY PLUSSM are service marks of Diebold, Incorporated.
Other brand and product names are trademarks or registered trademarks of their respective companies.
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 have not been authorized.
This document should be treated as confidential material for security reasons.
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.
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.
Priced Item
ii
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Contents
Tables
iii
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
iv
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Section 1
Introduction
Local Screen Changes (LSC) Version 2.0.0 is a user exit application that can save
network download data, load the terminal from the saved network download data,
and load additional custom configuration data. In addition to all functionality
included in prior versions of LSC, LSC Version 2.0.0 includes support for the
Windows 2000 operating system only.
This section contains the hardware and software requirements for the Local
Screen Changes (LSC) Version 2.0.0 user exit application.
1.1.1 Hardware
1.1.2 Software
1.3 Documentation
• Diebold 91X Terminal Control Software (TCS) and 91X TCS CSP Terminal
Programming Manual (TP-799387-001L)
1-1
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
1-2
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Section 2
Configuration
Local Screen Changes (LSC) comes pre-installed on the ATM. Use the Diebold
ATM Configurator interface provided in the Management Console to authorize
the application. See the Diebold 91x Terminal Control Software (TCS) Plus
Installation and Configuration Manual (TP-820605-001A) for instructions.
Once the application has been authorized, you must configure the software
and enable it.
2.1 Configuration
Local Screen Changes (LSC) can be configured using the Diebold ATM
Configurator interface provided in the Management Console. The configuration
screen can be accessed only if the Local Screen Change feature has been
authorized.
All current values on the Diebold ATM Configuration screen are initially set
to ’No’, by default.
NOTE
4. Click on Diebold_ATM.
2-1
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
G4771001A1
2-2
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
G4771001A2
9. Table 2-1 provides options to set the configuration fields. The current
value of each setting always displays. You can change any or all of the
displayed settings. If no change is made to a field, the current value is
maintained.
2-3
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Table 2-1 LSC Configuration Settings (continued)
2-4
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Table 2-1 LSC Configuration Settings (continued)
2-5
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Table 2-1 LSC Configuration Settings (continued)
10. Click OK to save the changes and exit the configuration screen or Apply
to save the changes without exiting.
Not all variables in the configuration file can be set through the Diebold ATM
Configuration interface. The variables not set have default values in them as
shown in Table 2-2. Please note that these default values can only be changed by
Software Engineers, and are not accessible to Field Representatives.
2-6
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Table 2-2 Configuration Variables Not Set in Management Console (continued)
Use the following steps to enable the Local Screen Change (LSC) feature.
2. Click OK to save the changes and exit the configuration screen or Apply
to save the changes without exiting.
Local Screen Changes (LSC) Version 2.0.0 supports lockout lists, but the
handling of lockout lists is different than in prior versions. All states and screens
are allowed by default. The host can disable a set of states, screens, FITs, or
miscellaneous data by sending a special write command II using the format
shown in Table 2-3. The LSC Lockout (LSCLOCK) utility and the Send Lockout
List (SLL) utility are no longer used.
2-7
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
To disable a state, screen, or FIT, the host uses the minus (-) character. The plus
(+) character enables a state, screen, FIT, or miscellaneous data.
Table 2-3 Write Command II Message Format for Lockout and Allow Lists
Table 2-4 contains the format of the data elements associated with the screen data.
2-8
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Section 3
Trigger Messages
This section describes the trigger messages supported by LSC 2.0.0 and the
actions taken in response to the trigger messages. Following are the valid
trigger commands:
• Reconfigure
• Loadall
• Loadnetwork
• Loadcustom
• Update_custom
The following paragraphs describe the trigger commands and provide samples
of SXA trigger messages directed to LSC. In addition, a script can be used to
run the trigger messages.
• Diebold 91X Terminal Control Software (TCS) and 91X TCS CSP Terminal
Programming Manual (TP-799387-001L)
RECONFIGURE
The RECONFIGURE command causes LSC to both reload its INI file and change
its configuration parameters using the new INI file settings. LSC reconfigures
itself only if it is in the ready state. The ready state is defined as LSC not being
in the process of storing or loading network or custom data, or processing a
transaction. If LSC is not in the ready state, then an error condition is returned.
EXAMPLE
SXATrigr /S:/Trigger:LSC:RECONFIGURE;
If an error occurs while reading or validating the contents of the INI file or
while configuring LSC for use with the new settings, then an error condition is
returned. LSC continues to use the original configuration file settings during the
current run of LSC.
Table 3-1 contains valid return codes for the RECONFIGURE command.
3-1
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Table 3-1 RECONFIGURE Return Codes (continued)
LOADALL
The LOADALL command causes LSC to load all stored network data and
custom configuration data using the names specified in the INI file. It behaves
as any other load operation in that an error loading stored network data causes
all stored network data to be deleted and a powerfail message to be sent to the
host and an error loading custom data turns off custom configuration loading
until LSC is reconfigured or restarted.
EXAMPLE
SXATrigr /S:/Trigger:LSC:LOADALL;
The LOADALL command executes only if LSC is in the ready state. If LSC is not
in the ready state, then an error condition returns. Stored network data loads only
if LSC is configured to load stored network data. Likewise, custom configuration
data loads only if LSC is configured to load custom configuration data.
Table 3-2 provides valid return codes for the LOADALL command.
LOADNETWORK
The LOADNETWORK command causes LSC to load its stored network data
using the file names specified in the INI file. An error causes LSC to delete all
stored network data and send a power fail message to the host.
EXAMPLE
SXATrigr /S:/Trigger:LSC:LOADNETWORK;
3-2
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
LSC loads stored network data only if it is in the ready state. If LSC is not in the
ready state, then an error condition returns. Stored network data loads only if
LSC is configured to load stored network data. If a reject message is received in
response to any write command that is part of the load, an error condition returns.
Table 3-3 provides valid return codes for the LOADNETWORK command.
LOADCUSTOM
The LOADCUSTOM command causes LSC to load its custom terminal
configuration data using the file names specified in the INI file. An error causes
custom loading to be disabled until LSC is reconfigured or restarted.
EXAMPLE
SXATrigr /S:/Trigger:LSC:LOADCUSTOM;
LSC loads custom configuration data only if it is in the ready state. If LSC is
not in the ready state, then an error condition returns. Custom configuration
data is loaded only if LSC is configured to load custom configuration data. If a
reject message is received in response to any write command that is part of the
load, an error condition is returned.
Table 3-4 provides valid return codes for the LOADCUSTOM command.
UPDATE_CUSTOM
The UPDATE_CUSTOM command causes LSC to replace some or all of its
custom ATM configuration files with newly supplied custom configuration files.
3-3
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
EXAMPLE
SXATrigr /S:/Trigger:LSC:UPDATE_CUSTOM;
LSC updates custom configuration data only if it is in the ready state. If LSC is
not in the ready state, then an error condition is returned. Custom configuration
data is updated only if LSC is configured to update custom configuration data.
• States.dat • Icons.dat
• Screens.dat • Fonts.dat
• FITs.dat • Cells.dat
• Misc.dat • Formats.dat
• CCS.dat • WriteA.dat
The custom configuration files are validated. If validation is successful, then they
are copied to the path and filename specified in the LSC.INI file.
Table 3-5 provides valid return codes for the UPDATE_CUSTOM command. For
all return codes other than 0 or 23, LSC restores its original custom configuration
files as the active custom configuration files.
3-4
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
Table 3-5 UPDATE_CUSTOM Return Codes (continued)
3-5
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (Ed. A)
3-6
©Diebold, Incorporated (5/2001) - All Rights Reserved
TP-820594 (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.
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.
NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES