Professional Documents
Culture Documents
1/10
Installation Manual
Introduction
J/Install Installation
Installation Steps
Parameters in "CUSTOM.PPF"
Parameter Management
Continued
Installation of Communication SW
Contents
Contents
Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Whats new ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Software Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Product short description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 ProBase/C Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hardware Configuration Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customization File for ProBase/C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PROBASE.CUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customization Files for ProSetup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PROSETUP.CUS and PROSETUP.PAR . . . . . . . . . . . . . . . . . . . . . . . . J/Install Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Registration Key Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Product Updates via J/Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation of ProTect/One . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customizing Media for J/Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creation of Installation Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multi Vendor Installation capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation subfolders of custom/update files . . . . . . . . . . . . . . . . . . . . . The Installation Disk Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Disk Manager for SlimCash . . . . . . . . . . . . . . . . . . . . . . . . . Installation on ProCash28x systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ProCash/NDC_28x and ProCash/DDC_28x license keys . . . . . . . . . . . Run application as "Non Administrator" user . . . . . . . . . . . . . . . . . . . . . . . . Installation restriction with NCR Aptra 05.01.xx . . . . . . . . . . . . . . . . . . . Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1 - Windows Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows XP + Service Pack 2 or 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 2 - Communication Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 3 - J/Install Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PROEINFO installation log folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 37 37 37 37 37 39 40 41 41 42 45 45 45 46 48 49 49 50 51 53 53 53 53 54 60
July 2011
Contents Parameter Configuration Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Dialog main and sub menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Parameters in CUSTOM.PPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [START_APPLICATION] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Program list called by the Restart Manager . . . . . . . . . . . . . . . . . . . . . . [STARTUP] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Communication framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Operator panel framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EPP framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . System Management Information Service framework . . . . . . . . . . . . . . . Special Electronics framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cash Dispenser framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coin Dispenser framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Card Reader framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Journal framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service Handler framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dialog framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Variable framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Converter framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Presentation framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Protocol framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Message Control framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt Printer framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Journal Printer framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document Printer framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Synchronisation framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . User Exit framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Device Status framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deposit framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transaction framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Script framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Utility framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Security framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ProCash/XDC-SOP dialog framework . . . . . . . . . . . . . . . . . . . . . . . . . . . Barcode Reader framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . System Restart settings of the Restart Manager . . . . . . . . . . . . . . . . . . . . . 63 64 64 65 65 65 66 66 67 67 68 68 69 69 70 70 70 71 71 71 72 72 73 73 74 74 75 75 75 76 76 76 77 77 77 78
July 2011
Contents Automatic System shut down & restart . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum system reboots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Power up period timer to clear actual reboot counter . . . . . . . . . . . . . . . Configurable screen during system shut down . . . . . . . . . . . . . . . . . . . . [CCPROTFW1] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Message Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Character Conversion Table location . . . . . . . . . . . . . . . . . . . . . . . . . . . Messages log file location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Size of Messages log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Append ETX character to the end of a message . . . . . . . . . . . . . . . . . . Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [SNA] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SNA Communication Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . Strip Function Management Header (FMH) . . . . . . . . . . . . . . . . . . . SNA open timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NAUTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logical Unit Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Communication response timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receive buffer size of project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OPMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Destination Logical Unit Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OPUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OPPASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OPLIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [X25] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X.25 Communication Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . Number of Virtual Circuits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Short hold mode time delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Waiting time for Call Accept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Waiting time for Call Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Waiting time for Clear Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . Number of calling retries to open X.25 connection . . . . . . . . . . . . . . Calling delay timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receive buffer size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X.25 connection index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Type of Virtual Circuit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Suppress TLS trace output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Buffer size in send direction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Buffer size in receive direction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . July 2011 78 78 79 79 80 80 80 81 81 81 82 82 82 82 83 83 84 84 85 85 85 86 86 86 87 87 87 88 88 89 89 90 90 90 91 91 92 92 92 7
Contents Permanent Virtual Circuit (PVC) number . . . . . . . . . . . . . . . . . . . . . . 93 Delivery control for send and receive direction . . . . . . . . . . . . . . . . . 93 Activate Short Hold Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Short Hold Mode passive configuration . . . . . . . . . . . . . . . . . . . . . . . 94 Start Short Hold Mode passive connection . . . . . . . . . . . . . . . . . . . . 95 Connection reconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Diagnostic code setting for SHM clear cause . . . . . . . . . . . . . . . . . . 96 Closed user group selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Closed user group outgoing call assignment . . . . . . . . . . . . . . . . . . . 97 Add Reversed Charging Facility to Call Request packets . . . . . . . . 97 Accept Reversed Charging Facility of incoming calls . . . . . . . . . . . . 98 Add Call User Data to Call Request packets . . . . . . . . . . . . . . . . . . 98 Check Call User Data of incoming calls . . . . . . . . . . . . . . . . . . . . . . . 99 Local station address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Remote station (host) address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 [TCPIP] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 TCP/IP Communication Framework . . . . . . . . . . . . . . . . . . . . . . . . 101 Remote station (host) address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 TCP port number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Keep Alive mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 TCP/IP open timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Connection retries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Send timeout timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Close timeout timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Local port address configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Coding DLL location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Size of memory blocks need to allocate . . . . . . . . . . . . . . . . . . . . . 106 TCP/IP parameters used by Windows . . . . . . . . . . . . . . . . . . . . . . . . . 107 KeepAliveTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 TcpKeepTries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 TcpKeepCnt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 KeepAliveInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 TcpMaxDataRetransmissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 [SSL_PROJECT] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Remote station (host) address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 SSL port number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 SSL Coding DLL location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 SSL Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 SSL Message length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 8 July 2011
Contents [LYNXCI_PARAMETER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Optional Parameters (NDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Miscellaneous Features I (DDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Miscellaneous Features II (DDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Miscellaneous Features III (DDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logical Unit Number (LUNO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuration Identification (Config ID) . . . . . . . . . . . . . . . . . . . . . . . . . . . [LYNXCI_TIMER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Keyboard response time (Timer 00) . . . . . . . . . . . . . . . . . . . . . . . . . . . Additional time (Timer 01) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Close state time delay (Timer 02) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Communication response time (Timer 03) . . . . . . . . . . . . . . . . . . . . . . Envelope insertion time (Timer 04) . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cash retract time-out ( Timer 05) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Poll/select time (Timer 06) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Take cash time (Timer 07) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Card capture time (Timer 09) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Additional cash present time (Timer 10) . . . . . . . . . . . . . . . . . . . . . . . . Document/Envelope present timeout (Timer 94) . . . . . . . . . . . . . . . . . Statement retract (Timer 95) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Statement present (Timer 96) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vandal guard close (Timer 98) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vandal guard close time (Timer 99) . . . . . . . . . . . . . . . . . . . . . . . . . . . Unsupported timers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [LYNXCI_SCREEN] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen default foreground color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen default background color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen transparent mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen softkey layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Blink rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Graphic file location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure MacroMedia Flash Animations . . . . . . . . . . . . . . . . . . . . . . . Palette file location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Character Width screen global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Character Height screen global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen horizontal offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen vertical offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen background picture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Play videos in full screen mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . July 2011 113 113 116 117 118 119 119 120 120 120 121 121 121 122 122 122 123 123 123 124 124 124 125 125 126 126 127 127 128 128 129 130 132 133 133 133 134 134 135 9
Contents ESC substitution character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Graphic and Video file extension mapping . . . . . . . . . . . . . . . . . . . . . . Stop Video after screen delay sequence (NDC only) . . . . . . . . . . . . . . Touch zone support in PIN entry dialogs (EPP only) . . . . . . . . . . . . . . . Assign "Confirm" FDK in PIN entry dialogs (EDM only) . . . . . . . . . . . . Configure default Audio path for NDC . . . . . . . . . . . . . . . . . . . . . . . . . . Configure default Audio path for DDC . . . . . . . . . . . . . . . . . . . . . . . . . . Configurable substitution character on display . . . . . . . . . . . . . . . . . . . Specific supervisor mode screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure number of PIN digits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [SCREEN_XXX] [1] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Foreground Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Background Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen idle next screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen idle time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Character Width screen specific . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Character Height screen specific . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen horizontal offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen vertical offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen transparent mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen background picture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen display contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Curser position for consumer inputs locally . . . . . . . . . . . . . . . . . . Upper left offset of the input rectangle . . . . . . . . . . . . . . . . . . . . . . . Upper top offset of the input rectangle . . . . . . . . . . . . . . . . . . . . . . . Lower right offset of the input rectangle . . . . . . . . . . . . . . . . . . . . . . Lower bottom offset of the input rectangle . . . . . . . . . . . . . . . . . . . . Input adjustment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Language bank screen parameters (DDC only) . . . . . . . . . . . . . . . . . . . . . [TOP_MSG] and [CUST_MSG] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event and Error message definitions . . . . . . . . . . . . . . . . . . . . . . . . . . Format Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event and Error message destination . . . . . . . . . . . . . . . . . . . . . . . . . . [HARDWARE_CONFIGURATION] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hardware Configuration Parameters (NDC) . . . . . . . . . . . . . . . . . . . . . Unsol./Sol. message logging on journal . . . . . . . . . . . . . . . . . . . . . . . . Expanded Hardware Configuration Parameters (DDC) . . . . . . . . . . . . MACing configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 July 2011 135 136 137 137 138 138 139 139 140 140 141 141 141 142 142 143 143 143 144 144 145 145 146 146 146 147 147 147 148 149 150 150 151 152 153 153 154 155 156
Contents Send TVN and MAC in Transaction Request messages . . . . . . . . Check TVN and MAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Send Machine Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Machine Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Send TVN and MAC in solicited status . . . . . . . . . . . . . . . . . . . . . . Field selected MACing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ASCII MACing activation in EBCDIC line environments . . . . . . . . . M-Data and MDS i series status code handling . . . . . . . . . . . . . . . . . . Go offline after host reply timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RKL message encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [APPLICATION_XXX][1] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hardware Fitness Fitness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Resend Power Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Suspend Mode timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Resend Power up message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sensor messages for terminal doors . . . . . . . . . . . . . . . . . . . . . . . . . . Force Supervisor Mode when door open . . . . . . . . . . . . . . . . . . . . . . . Solicited and Unsolicited message queuing . . . . . . . . . . . . . . . . . . . . . Default Miscellaneous Features (DDC only) . . . . . . . . . . . . . . . . . . . . Switch on/off logo light together with ready indicator . . . . . . . . . . . . . . Ready/Supply/Amount option defaults (NDC) . . . . . . . . . . . . . . . . . . . Card Read/Write error treshold defaults . . . . . . . . . . . . . . . . . . . . . . . . Enter "Out of service" mode after line reconnect . . . . . . . . . . . . . . . . . Rear Balancing host timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure Customer Relays 1 - 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LED_IN_SERVICE (ATM is in service mode) . . . . . . . . . . . . . . . . . LED_CUSTOMER (transaction active) . . . . . . . . . . . . . . . . . . . . . . LED_CASH (cash cassette(s) has/have low or out status) . . . . . . . LED_PAPER (printer paper low) . . . . . . . . . . . . . . . . . . . . . . . . . . . LED_SERVICE (technical service required) . . . . . . . . . . . . . . . . . . LED_SVR_MODE (ATM in supervisor mode) . . . . . . . . . . . . . . . . . Configure Remote Sensor Indicators (RSI) . . . . . . . . . . . . . . . . . . . . . RSI Status GREEN (RELAY3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RSI Status YELLOW (RELAY2) . . . . . . . . . . . . . . . . . . . . . . . . . . . RSI Status RED (RELAY1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure Remote Status Monitor (RSM) . . . . . . . . . . . . . . . . . . . . . . . LED Mapping for systems of other vendors . . . . . . . . . . . . . . . . . . . . . Guide Light flash rate control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Offline Reboot timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . July 2011 156 156 156 157 157 157 158 158 159 159 160 160 160 161 161 162 162 163 164 164 165 166 166 167 167 169 169 169 170 170 170 171 172 173 173 174 175 176 177 11
Contents Enable double length keys for triple DES . . . . . . . . . . . . . . . . . . . . . . . Zero filled General Purpose Buffer B and C . . . . . . . . . . . . . . . . . . . . . Configurable cassette names on journal . . . . . . . . . . . . . . . . . . . . . . . . Configurable text for reject/retract counter on journal . . . . . . . . . . . . . . ADRS options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADRS max retries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Store downloaded COM key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Force displaying "Card captured" screen in close state . . . . . . . . . . . . Print immediate processing options . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure anti skimming, mouthpiece and alarm sensors . . . . . . . . . . . Initial Status after application start . . . . . . . . . . . . . . . . . . . . . . . . . . Display receipt delivered screen in close state . . . . . . . . . . . . . . . . . . . Use Close (J) state Timer 02 always . . . . . . . . . . . . . . . . . . . . . . . . . . . Delay after Transaction Request processing . . . . . . . . . . . . . . . . . . . . . Screen delay time for FID Z (DDC only) . . . . . . . . . . . . . . . . . . . . . . . Options for PAN handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Monitor SEL boot switch (Wincor only) . . . . . . . . . . . . . . . . . . . . . . . . . Monitor Safe door . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reconnection delay time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Power Save Mode delay time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CAS dialog timer parameters (DDC only) . . . . . . . . . . . . . . . . . . . . . . . . . . Time-out for CAS of cash dispenser . . . . . . . . . . . . . . . . . . . . . . . . . . . Time-out for CAS of deposit module . . . . . . . . . . . . . . . . . . . . . . . . . . . Time-out for CAS of receipt printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . Time-out for CAS of document printer . . . . . . . . . . . . . . . . . . . . . . . . . . Check CAS of deposit module during dispense . . . . . . . . . . . . . . . . . . [CASH_DISPENSER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Number of logical cassettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set cassettes currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set cassettes values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default number of notes loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Automatic cassettes logon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Automatic cassettes logon in SOP session . . . . . . . . . . . . . . . . . . . . . . Set initial number of notes for auto logon cassettes . . . . . . . . . . . . . . . Send cash low message only if whole denomination low . . . . . . . . . . . Set dispense algorithm (ATMs only) . . . . . . . . . . . . . . . . . . . . . . . . . . . Ignore cash counters for removed cassettes . . . . . . . . . . . . . . . . . . . . Send unsol. Cash low message not only once . . . . . . . . . . . . . . . . . . . Stop dispensing after max. number of present errors . . . . . . . . . . . . . . 12 July 2011 178 178 179 180 181 182 182 183 183 184 188 189 189 190 190 191 191 192 192 193 194 194 195 196 197 198 199 199 199 200 200 201 201 202 203 203 204 205 206
Contents Set fatal after max. number of failed dispenses . . . . . . . . . . . . . . . . . . Send sol. message on Cash present time-out (NDC only) . . . . . . . . . . Cash retract through Presenter Dump Q (DDC only) . . . . . . . . . . . . . Send missing (@) for fatal cassettes (DDC only) . . . . . . . . . . . . . . . . Allow dispense if cassettes counter < 0 (NDC only) . . . . . . . . . . . . . . . Security timer between dispense and presenting money . . . . . . . . . . . Logical cassettes mapping for 6 cassettes ATMs . . . . . . . . . . . . . . . . Check cash dispenser shutter status after money taken . . . . . . . . . . . Upper case Denomination ID for cassettes (DDC only) . . . . . . . . . . . . Present failure screen and synchronous retract . . . . . . . . . . . . . . . . . . Screen display options during cash present . . . . . . . . . . . . . . . . . . . . . Cash Dispenser fatal if reject bin not operational . . . . . . . . . . . . . . . . . Dispense retries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dispense retries after hardware error . . . . . . . . . . . . . . . . . . . . . . . . . . Currency Exponent correction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum cash retracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Low threshold for physical cassettes . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum dispense time (watch dog) . . . . . . . . . . . . . . . . . . . . . . . . . . Withdrawal Retract logging and recycling on RM3 . . . . . . . . . . . . . . . . WOSA XFS30 Parameters (Wincor Nixdorf) . . . . . . . . . . . . . . . . . . . . Number of minimum bills (money low limit) . . . . . . . . . . . . . . . . . Number of maximum bills to be rejected . . . . . . . . . . . . . . . . . . . . . Obsolete WOSA XFS20 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . Number of minimum bills (money low limit) . . . . . . . . . . . . . . . . . Number of maximum bills to be rejected . . . . . . . . . . . . . . . . . . . . . Number of maximum cash retract operations . . . . . . . . . . . . . . . . . [COIN_DISPENSER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Number of coin hoppers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set coin hopper currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set coin hopper values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set coin dispense flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Number of coin hoppers reported to the host . . . . . . . . . . . . . . . . . . . . [DEPOSIT] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options to dispense envelopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen to be displayed during envelope dispense . . . . . . . . . . . . . . . . Screen "Please wait for an envelope" . . . . . . . . . . . . . . . . . . . . . . . . . Allow to cancel deposit transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . Disable printing on retracted envelopes . . . . . . . . . . . . . . . . . . . . . . . . Deposit print character mapping table . . . . . . . . . . . . . . . . . . . . . . . . . July 2011 207 208 208 209 210 210 211 212 212 213 213 214 215 215 216 216 217 217 218 219 219 219 220 220 220 221 222 222 222 223 223 224 225 225 226 227 227 228 228 13
Contents Deposit entry splitting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prepare envelope dispense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [CARD_READER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default track read definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default chip data read on Smart Cards . . . . . . . . . . . . . . . . . . . . . . . . . Card insert/eject wake up time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . "Remove Card" screen for left cards in DIP reader . . . . . . . . . . . . . . . . Read tracks during insert or remove direction (SWIPE) . . . . . . . . . . . . Card manipulation threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Card jam threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DIP eject screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [BARCODE] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure barcode type formates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [OPERATOR_SCREENS] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printer header for Operator screens . . . . . . . . . . . . . . . . . . . . . . . . . . . [JOURNALPRINTER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set journal destination on paper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Journal printer CPI setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Journal printer LPI setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Double Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Condensed Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Electronic journal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Send Spooler active or journal printer error message . . . . . . . . . . . . . . Keep original printer status if Spooler is configured . . . . . . . . . . . . . . . Force to send "Paper Out" message on paper out supply . . . . . . . . . . Assign codepage control sequence to NDC font type . . . . . . . . . . . . . . Print journal host data always prior function IDs . . . . . . . . . . . . . . . . . Hard disk free space low threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable journal file writing error messages . . . . . . . . . . . . . . . . . . . . . . Configure EJU or SAF shared mapping file . . . . . . . . . . . . . . . . . . . . . Configure EJU or SAF maximum file size . . . . . . . . . . . . . . . . . . . . . . . EJU journal NCR compatible mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extended range of characters in file journal . . . . . . . . . . . . . . . . . . . . . [ELECTRONIC_JOURNAL] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum journal files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Journal Spooler reset sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Journal Spooler check timer for Spooler data . . . . . . . . . . . . . . . . . . . . Journal Spooler threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum spool file size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 July 2011 229 229 230 230 230 231 231 232 232 233 233 234 234 235 235 236 236 236 236 237 237 238 238 239 239 240 240 241 241 242 242 243 243 244 244 244 245 245 245
Contents Maximum unprinted spool data size . . . . . . . . . . . . . . . . . . . . . . . . . . . [RECEIPTPRINTER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt printer CPI setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt printer LPI setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt printer character set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Double Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Condensed Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt printer page header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt printer page footer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt footer line position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LED timer during receipt delivery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable R01 print data merging (NDC only) . . . . . . . . . . . . . . . . . . . . . Assign codepage control sequence to NDC font type . . . . . . . . . . . . . Force receipt delivery after each host reply . . . . . . . . . . . . . . . . . . . . . Force to send "Paper Out" message on paper out supply . . . . . . . . . . Options during Rear Balancing print . . . . . . . . . . . . . . . . . . . . . . . . . . . [DOCUMENTPRINTER] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document printer CPI setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document printer LPI setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document printer character set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Double Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Condensed Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document printer page header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document printer page footer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document footer line position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum documents to be collected before delivery . . . . . . . . . . . . . . Cancel document processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printer Font parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Font type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Double Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Condensed Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . User defined Character set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printer initialization macros or characters . . . . . . . . . . . . . . . . . . . . . . . Printer character mapping table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GDI Windows name for receipt printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . GDI Windows name for document printer . . . . . . . . . . . . . . . . . . . . . . . . . Screen Font configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [VIEWER_FONT] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Number of screen fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . July 2011 246 247 247 247 247 248 248 249 249 250 250 251 251 252 252 253 254 254 254 254 255 255 255 256 256 257 257 258 258 260 260 261 261 262 263 263 264 264 264 15
Contents Font name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Font size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Font height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Font Resolution tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NDC font identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NDC double size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display characters in proportional mode . . . . . . . . . . . . . . . . . . . . . . . . Resolution dependent WINNT Font installation . . . . . . . . . . . . . . . . . . . . . Resolution dependent Bitmap/Icon installation . . . . . . . . . . . . . . . . . . . . . . User defined WINNT fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable and preconfigure ProAgent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Primary/Secondary Server and Port . . . . . . . . . . . . . . . . . . . . . . . . Terminal ID of ATM client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable Application Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Error description for ProAgent Server log window . . . . . . . . . . . . . . EMV parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Completion Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contact Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Language support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Acquirer Identifier 9F01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Merchant Category Code 9F15 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Terminal Country Code 9F1A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Terminal Capabilities 9F33 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Terminal Type 9F35 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Additional Terminal Capabilities 9F40 . . . . . . . . . . . . . . . . . . . . . . . . . . Vendor specific parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Number of physical cassettes names . . . . . . . . . . . . . . . . . . . . . . . . . . Configure physical names of cassettes units . . . . . . . . . . . . . . . . . . . . Set number of maximum rejected notes . . . . . . . . . . . . . . . . . . . . . . . . Set number of maximum retracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable test dispense function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Devide remaining notes equally to physical cassettes . . . . . . . . . . . . . Parameter Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The PARAC run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameter update process via PARAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . PCEDT - PARAC Parameter Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vendor and AddOn depended configuration . . . . . . . . . . . . . . . . . . . . . . . WOSA XFS30 automatic configuration . . . . . . . . . . . . . . . . . . . . . . . . . 264 266 266 267 269 270 271 272 272 273 274 274 275 275 275 276 276 276 277 277 278 278 279 279 280 281 281 281 282 282 283 283 285 285 286 287 288 289
16
July 2011
Contents ProCash/NDC parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ProCash/DDC parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customize Error Mapping Table CCERRMAP . . . . . . . . . . . . . . . . . . . . . . Configure multiple CDM Error Reasons for DDC . . . . . . . . . . . . . . . . . Variables in MDS i series status: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cassette specific variable in DDC912 status: . . . . . . . . . . . . . . . . . . . . Variables in M-Data status field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Error Class mapping of CSC-W32 and XFS classes . . . . . . . . . . . . . . Error mapping of XFS30 (WOSA) error events . . . . . . . . . . . . . . . . . . Error Suppression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure DDC 911 protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Use CCERRMAP.INA for 911 mode . . . . . . . . . . . . . . . . . . . . . . . . . . Setup hardware configuration status fields for 911 mode . . . . . . . . . . . Dispenser configuration for HI and LO denomination bills . . . . . . . . . . Diebold 911 compatible HI and LO denomination mode . . . . . . . . . . . Specific Step for dispense FID 8 in 911 Mode . . . . . . . . . . . . . . . . . . Printer initialisation via macro tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Macro parameters for Journal and Receipt printer . . . . . . . . . . . . . . . . User defined Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable Secure Key Entry (SKE) mode . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable Triple DES operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Triple DES enabled via J/Install installation . . . . . . . . . . . . . . . . . . . . . Triple DES activation manually on a running system . . . . . . . . . . . . . . Switch back to Single DES operation . . . . . . . . . . . . . . . . . . . . . . . . . . Switch to triple or single DES via SOP . . . . . . . . . . . . . . . . . . . . . . . . . Enable GDI Windows print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Automatic Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GDI operation and configuration parameters . . . . . . . . . . . . . . . . . . . . Enable card less transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Repository configuration of CLTSTTFW.DLL . . . . . . . . . . . . . . . . . . . . Dialog configuration parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameter fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Timeout parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Screen display and exit for parallel FDK press . . . . . . . . . . . . . . . . . . . Alpha numeric SMS key input style on EPP . . . . . . . . . . . . . . . . . . . . . . . Assign values for Left/Right keys of the 0 key . . . . . . . . . . . . . . . . . . . . . Dependent parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Specify cursor character for input position . . . . . . . . . . . . . . . . . . . . . . . . . Specify cursor character for input position . . . . . . . . . . . . . . . . . . . . . . . . . July 2011 290 300 309 310 311 312 312 313 314 314 315 315 315 316 317 318 319 319 321 321 322 322 322 323 323 324 324 324 325 325 325 326 327 327 328 328 329 329 330 17
Contents Set up character sequences for single EPP keys . . . . . . . . . . . . . . . . . . . . Input options for SMS input (NDC only) . . . . . . . . . . . . . . . . . . . . . . . . . . . Dialog options for SMS input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Allowed alpha numeric characters for SMS input . . . . . . . . . . . . . . . . . . . . Enable timer restart for input dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure Dial Up communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Repository section [STARTUP] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Protocol Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modem Interface DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Serial Interface DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Communication Yield DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Restart Manager section [START_APPLICATION] . . . . . . . . . . . . . . . Load dial up frameworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Specific communication settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modem automatic dial up number . . . . . . . . . . . . . . . . . . . . . . . . . . Modem initialisation command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Serial interface line attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Serial interface port name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Project settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COM channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Protocol channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Protocol type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Route ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Terminal ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing Network settings under restricted User . . . . . . . . . . . . . . . . . . . 330 331 332 332 333 334 334 334 334 335 335 336 336 337 337 337 338 338 339 339 339 339 340 340 341
Software updates via SOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Update diskette creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Automatic update process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 Start and Stop Application services . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 Start application services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 Stop application services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 Application Error Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transaction Framework (Class 6434) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cash Dispenser Framework (class 643A) . . . . . . . . . . . . . . . . . . . . . . . . . Security Overlay Framework (Class 643C) . . . . . . . . . . . . . . . . . . . . . . . . 347 347 350 352
18
July 2011
Contents Installation and Configuration Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . ProCash/NDC-DDC Configuration Manager . . . . . . . . . . . . . . . . . . . . . . . Font and Graphic utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Analyzing utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Font tools for journal and receipt printers . . . . . . . . . . . . . . . . . . . . . . . . . Font and Logo tools for printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logo print with ND9E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Font utilities for RJ03 series printers . . . . . . . . . . . . . . . . . . . . . . . . . . Miscellaneous tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Simulation utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 379 380 386 386 392 400 401 404 409
Installation of communication SW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 Installation of Eicon Wan Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427 Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
July 2011
19
Contents
20
July 2011
Introduction
This manual provides a detailed description for service technicans how to install the neccessary software components needed to get ProCash/NDC or ProCash/DDC running. It gives instructions in which order each product has to be installed and which parameters you have to keep an eye on. Furthermore this manual provides function descriptions about customizable parameters and how to create a branch specific installation set.
July 2011
21
Introduction
22
July 2011
Whats new ?
Whats new ?
This section lists a summery of documentation changes and extensions of the ProCash/NDC - ProCash/DDC Installation Manual. Since March 2011 until May 2011: New section Reconnection delay time on page 192 New section Withdrawal Retract logging and recycling on RM3 on page 218 New section Changing Network settings under restricted User on page 341 New section Power Save Mode delay time on page 193 New section Installation restriction with NCR Aptra 05.01.xx on page 51
Since November 2010 until March 2011: Changed section ProBase/C Installation on page 35 Changed section J/Install Installation on page 39
Since October 2010 until November 2010: Changed section RKL message encoding on page 159
Since April 2010 until October 2010: J/Install name introduced New section Guide Light flash rate control on page 176 New section Installation on ProCash28x systems on page 49
Since January 2010 until April 2010: Update process description extended and corrected
July 2011
23
Whats new ? New section [SSL_PROJECT] on page 110 New section Alpha numeric SMS key input style on EPP on page 328 New section Monitor Safe door on page 192 New section DIP eject screen on page 233
Since August 2008 until June 2009: New section Monitor SEL boot switch (Wincor only) on page 191 New section RKL message encoding on page 159 New section Enable Secure Key Entry (SKE) mode on page 321
Since May 2007 until August 2008: New section Default number of notes loaded on page 200 New section ProBase/C Installation on page 35 Extended section Configure anti skimming, mouthpiece and alarm sensors on page 184 New section Maximum dispense time (watch dog) on page 217
24
July 2011
Whats new ? Since July 2006 until May 2007: New section Installation Disk Manager for SlimCash on page 48 New section Run application as "Non Administrator" user on page 50 New section Low threshold for physical cassettes on page 217 New section Card manipulation threshold on page 232 New section Card jam threshold on page 233 New section Delay after Transaction Request processing on page 190 New section Screen delay time for FID Z (DDC only) on page 190 New section Options for PAN handling on page 191
Since September 2005 until July 2006: Extended section Font and Graphic utilities on page 380 New section Extended range of characters in file journal on page 243 New section EJU journal NCR compatible mode on page 243 New section Screen display options during cash present on page 213 New section Error mapping of XFS30 (WOSA) error events on page 314 New section PROEINFO installation log folder on page 60 New section Configure Remote Status Monitor (RSM) on page 174 New section [COIN_DISPENSER] on page 222 New section [BARCODE] on page 234 Extended section Miscellaneous tools on page 404 New section Configure Dial Up communication on page 334
Since October 2004 until September 2005: Extended section Parameter Management on page 285 New section EMV parameters on page 276 New section Currency Exponent correction on page 216 New section Enable card less transactions on page 325
July 2011
25
Whats new ?
Since March 2004 until October 2004: Extended section Automatic cassettes logon on page 201 New section Deposit entry splitting on page 229 New section Prepare envelope dispense on page 229 Changed section Parameter Management on page 285 New section Use Close (J) state Timer 02 always on page 189 New section Vendor specific parameters on page 281 New section Display receipt delivered screen in close state on page 189 Extended section Font utilities for RJ03 series printers on page 401 New section Go offline after host reply timeout on page 159 New section The Installation Disk Manager on page 46 Changed section Creation of Installation Media on page 45 New section Configure EJU or SAF shared mapping file on page 242 New section Configure EJU or SAF maximum file size on page 242 New section Print immediate processing options on page 183 New section Configure anti skimming, mouthpiece and alarm sensors on page 184 New section Enable journal file writing error messages on page 241 New section Force displaying "Card captured" screen in close state on page 183 New section Present failure screen and synchronous retract on page 213 Extended section ADRS options on page 181 Changed section ADRS max retries on page 182
Since November 2003 until March 2004: New section Configure MacroMedia Flash Animations on page 130 New section Font utilities for RJ03 series printers on page 401
26
July 2011
Whats new ? New section Configure number of PIN digits on page 140 New section Deposit print character mapping table on page 228
Since March 2003 until November 2003: New section Store downloaded COM key on page 182 New section Enable R01 print data merging (NDC only) on page 251 New section Screen "Please wait for an envelope" on page 227 New section ESC substitution character on page 135 New section Options during Rear Balancing print on page 253 Changed section Options to dispense envelopes on page 225 Changed section Screen to be displayed during envelope dispense on page 226 New section Receipt printer page footer on page 249 New section Receipt footer line position on page 250 New section Document printer page footer on page 256 New section Document footer line position on page 256 New section Hard disk free space low threshold on page 241 New section Configure multiple CDM Error Reasons for DDC on page 310 New section Check cash dispenser shutter status after money taken on page 212 New section Specific supervisor mode screen on page 140 New section Print journal host data always prior function IDs on page 240 New section ADRS options on page 181 New section ADRS max retries on page 182 New section Upper case Denomination ID for cassettes (DDC only) on page 212 New section Assign codepage control sequence to NDC font type on page 240 and 251. Changed section Number of maximum bills to be rejected on page 220
July 2011
27
Whats new ? Since April 2002 until March 2003: Changed section [TOP_MSG] and [CUST_MSG] on page 150 New section Maximum unprinted spool data size on page 246 New section Maximum spool file size on page 245 New section Printer initialization macros or characters on page 261 New section Configurable text for reject/retract counter on journal on page 180 New section Configurable cassette names on journal on page 179 New section Enable GDI Windows print on page 324 New section GDI Windows name for document printer on page 263 New section GDI Windows name for receipt printer on page 263 New section Security timer between dispense and presenting money on page 210 New section Default chip data read on Smart Cards on page 230 New section Logical cassettes mapping for 6 cassettes ATMs on page 211 New section Configurable substitution character on display on page 139 Extended section Options to dispense envelopes on page 225 New section Disable printing on retracted envelopes on page 228 New section Force to send "Paper Out" message on paper out supply on page 239 and 252. New section Zero filled General Purpose Buffer B and C on page 178 New section Enable Triple DES operation on page 322 Description of section Font and Logo tools for printers on page 392 extended for TH30 and TH21/TH22. Extended section Miscellaneous tools on page 404. Extensions for SetHwPPF.EXE and CpyNtFnt.EXE
28
July 2011
Whats new ? Since October 2001 until April 2002: Changed section Creation of Installation Media on page 45 New section Send missing (@) for fatal cassettes (DDC only) on page 209 Changed section Automatic System shut down & restart on page 78 New section CAS dialog timer parameters (DDC only) on page 194 New section Configure Customer Relays 1 - 4 on page 167 New section Configure Remote Sensor Indicators (RSI) on page 171 New section Offline Reboot timer on page 177 New section Cash retract through Presenter Dump Q (DDC only) on page 208 Enhanced section Miscellaneous tools on page 404. New tool PRINTRAW.EXE New section Keep original printer status if Spooler is configured on page 239 New section Configure default Audio path for NDC on page 138 New section Configure default Audio path for DDC on page 139 New section Logo print with ND9E on page 400 New section Enable double length keys for triple DES on page 178
July 2011
29
Whats new ? Since March 2001 until October 2001: Enhanced section Printer Font parameters on page 258 New section Graphic and Video file extension mapping on page 136 New section Touch zone support in PIN entry dialogs (EPP only) on page 137 section Assign "Confirm" FDK in PIN entry dialogs (EDM only) on page 138 New section Send sol. message on Cash present time-out (NDC only) on page 208 section Miscellaneous tools on page 404 enhanced. New tool PRT-RAW.EXE
Since December 2000 until March 2001: New section Local port address configuration on page 104 New section Printer initialisation via macro tables on page 319 New section TCP/IP parameters used by Windows on page 107 New section Stop dispensing after max. number of present errors on page 206
Since September until December 2000: New section Creation of Installation Media on page 45 New section System Restart settings of the Restart Manager on page 78 New section Rear Balancing host timeout on page 167 Changed section Force Supervisor Mode when door open on page 162 Changed section Product short description on page 32 Changed section Cash Dispenser framework on page 67
30
July 2011
CD
CD
CD
CD
ProBase/C 1.1/20 CD Device Drivers Firmware CSC-W32 ProDevice (XFS) 2.1/10 NDC/DDC ProCash/NDC ProCash/DDC ProTopas Manager AddOn Products ProAgent CD
CD
J / I N S T A L L
J / I N S T A L L
CD
July 2011
31
MEDIAS CD
SNA Workstation needs to be CD installed if the ATM has to communicate via SNA-SDLC or SNA-QLLC with the host.
NAME CSC-W32
VERSION DESCRIPTION 2.1/80 CSC Operating System communicates directly with the firmware of the hardware devices.
MEDIAS CD
---
This component contains the CD WOSA services used by ProTopas. Service and Operating functions for CSC applications on Windows XP. Security Paket CD
---
--1.6 V11
CD CD
32
July 2011
NAME ProCash/NDC
ProTopas/SOP-NDC
MEDIAS
ProCash/DDC
ProTopas/SOP-DDC
Contains the specific frameworks CD and neccessary accessoires which completes the ProCash/NDC-DDC products. ProAgent CD
ProAgent PARAC NT
PARAC is a parameter customis- CD ation utility which provides the Windows registry with parameters of the products. All defined parameters of each product are merged together and will be set into the registry in a predefined sequence. Contains ProTopas device frame- CD works and core components required for the application The AddOn Products are optional CD components (exp. ProChip/EMV) that can be installed with additional Registration Keys
4.2/21
---
July 2011
33
34
July 2011
ProBase/C Installation
ProBase/C Installation
Since ProCash/NDC - ProCash/DDC 2.0/00 the installation concept has been redesigned. As it is shown in table Product Overview on page 31, the CSC-W32 Operating System, T-SOP, Firmware, ProDevice (XFS) and drivers are separated in a new Product CD named ProBase/C.
ProBase/C needs to be installed on Wincor hardware systems only. ProBase/C should be installed in folder C:\ProBase only. Please do not change the destination folder in the input selection dialog of ProBase.
ProBase/C CD 1.1/20 is a non bootable medium and requires a ready installed Windows XP on the hard disk. Additional Windows device drivers have to be installed from the Driver Utility CD that is delivered together with the hardware system. If you want to install Windows XP, ProBase/C and application layer on a clean formatted hard disk, you have to use ProSetup for the installation.
Installation on existing Windows XP: ProBase/C can also be installed on an existing Windows XP operating system. The installation window automatically appear if you insert the ProBase/C or if you call AUTORUN.BAT from the CD root folder.
For the ProBase/C installation you need the Hardware Configuration Media (HW_CONF.INI) and minimum one Customizing Media where the customizing file PROBASE.CUS has to be included. You can use "Installation Disk Manager" for automatic creation of the Customizing Media. Refer to section Creation of Installation Media on page 45 for detailed description.
July 2011
35
ProBase/C Installation
CD
ProBase/C
CD
1.
Hardware Media
2.
Customization Media
Note: Instead of floppy diskettes you can use CDs, USB or HDD medias
Please refer to ProBase Installation 1.1/20 User manual for detailed descriptions how to install and customize the ProBase/C product. Detailed descriptions about ProSetup configuration are described in ProSetup XP for ProClassic Operators Guide.
36
July 2011
ProBase/C Installation
With each new ordered hardware system the specific Hardware Configuration Media will be delivered automatically from the factory. Service technicans have the possibility to create their own HW_CONF.INI with the utility HW_CREATE on the original J/Install CD. With HW_CREATE you can select the requested hardware system, printers, card reader and additional devices that differ from the standard configuration.
July 2011
37
ProBase/C Installation
38
July 2011
J/Install Installation
J/Install Installation
The J/Install CD contains the application product components that will be installed above ProBase/C on Wincor hardware systems. The core product and AddOn products can be installed only with a valid security key (REG_KEY.INI). This registration mechanism allows the installation of licensed software only. Different hardware systems and their customer specific variations presuppose specific configuration settings. Each customer has the possibility to create a customized configuration for different branches. Furthermore the product contents of the CD can be overloaded via an update configuration. The next figure clearifies the combination of CD, registration, customization and update. Please refer to J/Install User Guide to get detailed information about the installation concept and configuration possibilities.
Figure 3: J/Install Installation medias
CD
J/Install
2.
CD
1.
Registration Key Medias
Customization Media
3.
Update Medias
Note: Instead of floppy diskettes you can use CDs, USB or HDD medias
July 2011
39
J/Install Installation
The Registration Key Media is delivered from the factory and it is strictly prohibited to change it contents. The file REG_KEY.INI will be created with a generated random security key. Even if anybody modifies this file after the key generation from factory side, J/Install cannot install the products any more. Please contact the Wincor Nixdorf support center if anybody else has tried to change this file or if the disk is corrupted. E-mail can be sent to following address:
SoftwareSupport-BD.EMEA@wincor-nixdorf.com
The registration key file "REG_KEY.INI" on the Registration Key Media contains the product name and major version of the main product you have ordered. All sub products like, ProTopas Manager, XFSAddOn, PARAC, ..., etc. are defined in the component file "PRODUCT.INI". This file also is key generated as the REG_KEY.INI file on the registration key diskette or CD. You will find the file "PRODUCT.INI" on the J/Install CD in subfolder "INSTALL\PRODUCTS" separated for each product and release version.
40
July 2011
J/Install Installation
Installation of ProTect/One
Installation of ProTect/One
ProTect/One is used to secure the Windows logon procedure. Within ProTect/One you can create multiple users with different access rights to the Windows file system. This product will be installed together with the installation procedure of basic product ProCash/NDC and ProCash/DDC. If you like to install ProTect/One you have to order the ProTect/One Registration Key disk. If you insert the Registration Key Media together with the Registration Key Media of the basic product at the beginning of the J/Install installation, ProTect/One will be installed automatically. After successful installation following dialog window appears during the Windows logon procedure:
Please refer to the Protect/One V1.3 Product Manual for detailed descriptions about how to create multiple users and to set access rights for each user. You will find the manual in sub folder \DOC\ProTect_One on the J/Install CD.
July 2011
41
J/Install Installation
File Structure \ BMP\prondc.bmp or \ BMP\proddc.bmp \ VENDORS\ WN\XFS20\custom.wn WN\XFS30\custom.wn or NCR\XFS20\custom.ncr NCR\XFS30\custom.ncr or DIEBOLD\XFS20\ custom.dib DIEBOLD\XFS30\ custom.dib or DELARUE\XFS20\ custom.dlr DELARUE\XFS30\ custom.dlr or NAUTILUS\XFS20\ custom.nhy NAUTILUS\XFS30\ custom.nhy
Description Customer specific bitmap which is displayed when the part ProCash/NDC or ProCash/DDC is installed during the J/Install run. Vendor specific parameters: specific parameters for Wincor systems
The vendor specific files are automatically copied from the vendor specific sub folder to the root folder of the Customizing Disk.
42
July 2011
J/Install Installation
File Structure \ ADDON.PPF\ custom.emv custom.ccd custom.crs custom.rm2 custom.chq custom.p36 custom.web custom.rxe custom.rkl custom.fet custom.fwe custom.coi custom.coo custom.snd custom.flx \ custom.ppf
\ jinstall.cus
\ dialog.ctl
\ probase.cus
Description Specific parameters for AddOn products: ProChip/EMV ProCashIn/Online with CCDM ProCashIn/Online with CRS Recycling Module 2 (PC4000) ProChequeIn CashIn/Signature Web-Extensions Specific for CRSxe ProRKL FOnet (obsolete) FOnet WEB enabled configuration CoinIn CoinOut Specific for SlimCash Parameter settings for ProTopas/Flow-Extensions customer parac parameter file - contains basic parameters that are set during the PARAC run. All parameters defined in this file must be known by PARAC. The PCEDT (PARAC PARAMETER EDITOR) utility should be used to modify the file custom.ppf. customizing control file - contains sections of product names, versions and definitions for update diskettes. This file is automatically copied from the vendor specific sub folder from the J/Install CD to the root folder of the Customizing Disk. dialog control file - contains the dialog definition of the installation dialog for the purpose of presetting parameters during the J/Install run. This file is automatically copied from the vendor specific sub folder from the J/Install CD to the root folder of the Customizing Disk. customizing file for ProBase/C - contains parameters for CSCW32 and XFS services. This file is automatically copied from the J/Install CD to the root folder of the Customizing Disk.
July 2011
43
J/Install Installation
\ prosetup.par
\ POST\ update.zip
Description customizing file for ProSetup - contains global parameters and network settings. This file is automatically copied from the J/Install CD to the root folder of the Customizing Disk. parameter definition file for ProSetup - contains some environment variables and the link to the JInstall.xml script. Sub folder for UPDATE file(s) update file with additional parameter configuration files (INA files) and batch routines which are called during the installation process. The update.zip will be automatically extracted by during the JInstall installation process. Note: If you need to add additional customizing, you can add addditional ZIP files to the POST folder. They will be extracted in alphabetical order.
Please refer to the J/Install reference manual for detailed descriptions how to create customizing disks.
44
July 2011
J/Install Installation
July 2011
45
J/Install Installation
F1 short help infos product depended dynamic text. Program was called from folder INSTALL\PRONDC\R21.10
Vendor selection
The Installation Disk Manager has to be called directly from the J/Install CD. For the ProCash/DDC installation you have to start the executable program "DSKMANAG.EXE" from folder \INSTALL\PRODDC\R21.10. For ProCash/NDC you have to start it from \INSTALL\PRONDC\R21.10. See further steps on the next page ...
46
July 2011
After pressing the "Browse" button the following dialog appears where you can specify a hard disk or network directory where the customizing files will be copied. These folders can be used during installation when J/Install is requesting the Customizing Media.
If you have selected a floppy drive destination (A:) and you press the "OK" button after the vendor selection, you will be advised to get an empty formatted 1,44 MB floppy diskette.
If you have inserted the diskette correctly, the required files for the Customizing Media will be copied from the J/Install CD onto the floppy disk. If the copy process is completed, you are ready for the product installation with J/Install.
July 2011
47
J/Install Installation
The Installation Disk Manager (dsk_slim.exe) can be found on the J/Install installation CD in sub folder \INSTALL\PRONDC\R21.00 or \INSTALL\PRODDC\21.00. Please see also section The Installation Disk Manager on page 46 for details how to use the Installation Disk Manager.
48
July 2011
J/Install Installation
Installations on ProCash28x systems can be performed only via ProCash/NDC_28x or ProCash/DDC_28x registration key disks. If you are using other registration key disks, the J/Install installation will be aborted.
July 2011
49
J/Install Installation
Please refer to manual J/Install User Guide section "Operation without administrative rights (PRC section)" to get detailed information about relevant parameters for non administrator installations.
50
July 2011
J/Install Installation
NOTE:
If the pop up window has been confirmed, it does not come up any more after Windows logon.
July 2011
51
J/Install Installation
52
July 2011
Installation Steps
Installation Steps
Wincor Nixdorf hardware systems On Wincor hardware systems the J/Install installation can be performed as follows: Install Windows XP and additional drivers manually. Install from ProBase/C CD via call AUTORUN.BAT, but do NOT boot from CD. Install from J/Install CD. See brief description of Step 1 to Step 3.
Hardware systems of other vendors If you want to install the application on hardware of other vendors (NCR, DIEBOLD, DELARUE), it is mandatory to install first the vendor specific software (exp. Aptra, Agilis, etc.) before you start the J/Install installation.
July 2011
53
Step 3 - J/Install Installation WAN Services for Windows (V4R2S1) (CD media)
Installation Steps
(This CD installs the physical drivers for the EICON board) If SNA-SDLC (SNA_LU0) or SNA-QLLC is requested you need in addition: SNA Workstation 3.0 (CD media) For X.25 Native and TCP/IP all drivers are included on the J/Install CD.
54
July 2011
Installation Steps
3. After product selection the next J/Install Dialog asks for the Customizing Disk or Customizing folder:
Note:
The predefined folder C:\JINSTALL can be changed through the drive and/or folder where your customizing files can be located.
July 2011
55
Installation Steps
4. When J/Install has finished reading the Customizing Disk or Customizing folder, the following dialog asks for the Registration Key Disk(s):
Note:
The predefined folder C:\JINSTALL can be changed through the drive and/or folder where your customizing files can be located.
56
July 2011
Installation Steps
5. This dialog instructs you to insert the Update Disk(s). Alternatively you can select a subfolder on the harddisk or another medium where the ZIP compressed data can be located. Make shure that the ZIP file is stored under sub folder POST of the slected Update folder. You can have multiple Update Disks that you can insert sequentely after each Update Disk that has been processed. You will be asked after insertion of each Update Disk if you want to process more Update Disks. As minimum you have to insert the Update Disk that has been created by the Disk Manager:
July 2011
57
Installation Steps
6. This Dialog can be used to set specific device configurations or options for the line communication during the installation phase. If you already have set all required values in CUSTOM.PPF, you can ignore this dialog where you can enable "Configuration is already prepared":
If you select the item Configuration is already prepared or after you have finished specific configurations and you select All settings done ("Configuration is already prepared" will be replaced), the J/Install installation is processing the next dialog window.
This Parameter Configuration Dialog is build via a step table stored in file DIALOG.CTL located in the customisation disk. This step table can be tested separately with PCDialog. Refer to the J/Install user manual for detailed descriptions how to create your own installation dialog.
58
July 2011
Installation Steps
After J/Install has successfully finished the Installation you will see the installation finished screen. Please read the notes in the background around the dialog window of the screen.
July 2011
59
Installation Steps
If the J/Install installation fails, it is useful to provide the international support with all files from subfolder C:\PROEINFO in addition to SUPPORT.ZIP.
60
July 2011
Cash Dispenser Deposit module ProAgent Encryption Security Configuration already prepared (All settings done)
July 2011
61
62
July 2011
Parameters in CUSTOM.PPF
Parameters in CUSTOM.PPF
This chapter describes parameters which are customizable in the Parac Parameter File (PPF) CUSTOM.PPF. Parameters in "CUSTOM.PPF can be modified with the Parameter Configuration Editor PCEDT.EXE. All parameters which are not described in this section but exist in "CUSTOM.PPF" should not be modified or removed. On the customizing disk, the major CUSTOM.PPF file is located in the root of the diskette. Vendor specific parameters will be found in the vendor sub folder, specifically devided between WOSA XFS30 and XFS20 parameters under the "VENDORS" folder. Parameters that are used by the ADDON products are found in sub folder "ADDON.PPF". Configuration files in these sub folders do NOT have the file extension *.PPF. The parameters of the configuration files, which have another extension than *.PPF, are added and merged together to one single CUSTOM.PPF file that finally can be found in folder "C:\INSTALL\CUSTOM" on the harddisk after installation.
July 2011
63
[START_APPLICATION]
Parameters in CUSTOM.PPF
[START_APPLICATION]
This section describes the parameters which are used to specify the programs and framework list which are called by the restart manager of Protopas.
Value description: Each Parameter contains a program with execution parameters which are loaded in the specified order from left to right. Default value: CCBase,WosaCtrl,ApplPM,ProSop,ApplStart
64
July 2011
Parameters in CUSTOM.PPF
[STARTUP]
[STARTUP]
This section describes the parameters which are used to specify the frameworks path definition for the Repository Manager of Protopas. See Protopas Programmers Reference manual for detailed descriptions about Repository- and Restart Manager.
Communication framework
This parameter specifies which communication framework should be started. Parameter name: COM_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Protopas provides following communication frameworks: ComSnaSr.dll ComTcpIP.dll ComX25Ei.dll - SNA Server with EICON Card. - TCP/IP via Ethernet card. - X.25 Native with Eicon card.
July 2011
65
[STARTUP]
Parameters in CUSTOM.PPF
EPP framework
This parameter specifies the location of the EPP framework which has to be started. The EPP framework is the direct interface to the encryption services of WOSA for the EPP or EDM. Refer to Abschnitt Enable Triple DES operation on page 322 for detailed description about Triple DES activation. Parameter name: EPP_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
66
July 2011
Parameters in CUSTOM.PPF
[STARTUP]
July 2011
67
[STARTUP]
Parameters in CUSTOM.PPF
68
July 2011
Parameters in CUSTOM.PPF
[STARTUP]
Journal framework
This parameter specifies the location of the Journal framework which has to be started. Parameter name: JOURNAL_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
July 2011
69
[STARTUP]
Parameters in CUSTOM.PPF
Dialog framework
This parameter specifies the location of the Dialog framework which has to be started. Parameter name: DLG_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Value description: path location Default value (NDC):C:\PROTOPAS\BIN\ndcDiaFw.DLL Default value (DDC):C:\PROTOPAS\BIN\ddcDiaFw.DLL
Application framework
This parameter specifies the location of the Application framework which has to be started. Parameter name: APPLICATION_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Data framework
This parameter specifies the location of the Data framework which has to be started. Parameter name: APPL_DATA_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
70
July 2011
Parameters in CUSTOM.PPF
[STARTUP]
Variable framework
This parameter specifies the location of the Variable framework which has to be started. Parameter name: VARIABLE_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Converter framework
This parameter specifies the location of the Converter framework which has to be started. Parameter name: CONVERTER_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Presentation framework
This parameter specifies the location of the Presentation framework which has to be started. Parameter name: PRESS_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
July 2011
71
[STARTUP]
Parameters in CUSTOM.PPF
Protocol framework
This parameter specifies the location of the Protocol framework which has to be started. Parameter name: PROT1_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
72
July 2011
Parameters in CUSTOM.PPF
[STARTUP]
Value description: path location Default value (NDC):C:\PROTOPAS\BIN\CCFms20.DLL; C:\PROTOPAS\BIN\ndcPrtFw.DLL Default value (DDC):C:\PROTOPAS\BIN\CCFms20.DLL; C:\PROTOPAS\BIN\ddcPrtFw.DLL
Value description: path location Default value (NDC):C:\PROTOPAS\BIN\CCFms20.DLL; C:\PROTOPAS\BIN\ndcPrtFw.DLL Default value (DDC):C:\PROTOPAS\BIN\CCFms20.DLL; C:\PROTOPAS\BIN\ddcPrtFw.DLL Journal Spooler activation: To enable the Journal Spooler you have to insert the overlay framework between the Protopas basic framework and the NDC or DDC specific printer framework. See example entry for NDC in the following lines: C:\PROTOPAS\BIN\CCFms20.DLL;C:\PROTOPAS\BIN\CCJSpool.DLL; C:\PROTOPAS\BIN\ndcPrtFw.DLL
July 2011
73
[STARTUP]
Parameters in CUSTOM.PPF
Value description: path location Default value (NDC):C:\PROTOPAS\BIN\CCFms20.DLL; C:\PROTOPAS\BIN\ndcPrtFw.DLL Default value (DDC):C:\PROTOPAS\BIN\CCFms20.DLL; C:\PROTOPAS\BIN\ddcPrtFw.DLL
Synchronisation framework
This parameter specifies the location of the Synchronisation framework which has to be started. Parameter name: SYNC_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
74
July 2011
Parameters in CUSTOM.PPF
[STARTUP]
Deposit framework
This parameter specifies the location of the Deposit framework which has to be started. Parameter name: DEPOSIT_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
July 2011
75
[STARTUP]
Parameters in CUSTOM.PPF
Transaction framework
This parameter specifies the location of the Transaction framework which has to be started. Parameter name: TRANSACT_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Script framework
This parameter specifies the location of the Script framework which has to be started. Parameter name: SCRIPT_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Utility framework
This parameter specifies the location of the ProTopas Utility framework which has to be started. Parameter name: UTILFW_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
76
July 2011
Parameters in CUSTOM.PPF
[STARTUP]
Security framework
This parameter specifies the location of the Security framework which has to be started. Parameter name: SECURE_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
July 2011
77
Value description: disables or enables an automatic system restart Default value: 1" - automatic system restart option enabled
Value description: specifies the number of reboots the Restart Manager is allowed to perform Default value: 3"
78
July 2011
20" - cleares the actual reboot counter if the application longer than 20 minutes is up.
Value description: program path of SHOWBMP.EXE and path of the bitmap separated by a comma. Default value: C:\PROTOPAS\BIN\SHOWBMP.EXE, C:\PROTOPAS\BITMAPS\DCTMPOOS.BMP
July 2011
79
[CCPROTFW1]
Parameters in CUSTOM.PPF
[CCPROTFW1]
Message Protocol
This parameter defines whether the NCR Direct Connect (NDC) or Diebold Direct Connect (DDC) message protocol is in use. Parameter name: PROTOCOL Section in *.PPF: Valid range: [CCPROTFW1] NDC, DDC
Value description: NDC - defines the NCR protocol; DDC - defines the Diebold protocol Default value: depends on which protocol has to be used
Following Character Conversion tables are available: C:\PROTOPAS\CONF\CCVTABLE.FIL (ASCII-ASCII conversion default table) C:\PROTOPAS\CONF\CCVTABLE.ASC (ASCII-ASCII conversion table) C:\PROTOPAS\CONF\CCVTABLE.EBC (ASCII-EBCDICI conversion)
80
July 2011
Parameters in CUSTOM.PPF
[CCPROTFW1]
Value description: log file size in kilo bytes Default value: 200
July 2011
81
Communication
Parameters in CUSTOM.PPF
Communication
[SNA]
SNA Communication Framework This parameter is used to specify the SNA communication framework including the path location. This setting is stored in the Repository section of the Registry. Parameter name: COM_FRAME Section in *.PPF: Valid range: [STARTUP] 256 characters
Value description: specifies the location of the framework for the Repository manager Default value: C:\PROTOPAS\BIN\ComSnaSr.dll
Strip Function Management Header (FMH) This parameter is evaluated for a LU-LU session and can have the values either YES or NO. If it is YES a Function Management Header (FMH) which is a SNA specific prefix in a received message is stripped before it is passed to the communication framework user for further processing. If the value is NO a received FMH is not stripped. Parameter name: STRIPFMH Section in *.PPF: Valid range: [SNA_PROJECT] NO, YES
Value description: NO - not stripped, YES - Received FMH is stripped Default value: NO
82
July 2011
Communication
This parameter is a duration time in seconds. In case of a LU-LU session the meaning of this parameter depends on the setting of parameter SENDINITSELF. If this parameter has the value YES or OTHER, parameter OPENTIME means the maximum time within the LU-LU session must have been opened for data exchange after the communication framework Open() method was called. If INITSELF has the value NO, the parameter OPENTIME means the maximum time where the SSCP-LU session has to be opened after the Communication framework Open() method was called. The LU-LU session for data exchange may be established sometime after termination of the Open() method in this case. In PU case OPENTIME means the maximum waiting time where the SSCP-PU session has to be attached from the communication framework. The attachment succeeds if the SSCP-PU session was established. If the OPENTIME timer expires without the establishment of the corresponding SNA session, the Open() method returns with an error. Parameter name: OPENTIME Section in *.PPF: Valid range: [SNA] 0-255
Value description: integer value in seconds Default value: NAUTYPE This parameter can have the value either PU for a SSCP-PU session or LU for a LU-LU session. Parameter name: NAUTYPE Section in *.PPF: Valid range: [SNA_PROJECT] LU, PU 60
July 2011
83
Parameters in CUSTOM.PPF
This parameter is only evaluated for a LU-LU session. It is the name of the LU that is configurated in the IBM CM/2 respectively in the MS SNA Server. Parameter name: LUNAME Section in *.PPF: Valid range: [SNA_PROJECT] char string
Value description: represents the LU name of the SNA Server Default value: XXXLU
Communication response timer This is the waiting time in seconds for completion of a send request that is initiated by the Send() method of the communication framework. For a LU-LU session a Request Unit (RU) that contains the send data is sent to the PLU in the SNA host. If this RU requires a SNA acknowledgement (that depends on the parametrization of the BIND command from the PLU that opened the session), the PLU sends a SNA response for this RU to the SLU that is used by the communication framework. In the SSCP-PU session a response is always required for a RU that is sent from the PU to the SSCP. If sending of the RU and the optional receiving of a SNA response takes more time then the parameter value indicates then an error is returned by the Send() method. Parameter name: RSPTIMER Section in *.PPF: Valid range: [SNA_PROJECT] 0-255
84
July 2011
Communication
This parameter is used to set the size of the receivebuffer within the SNA communication framework in bytes. It should not be smaller than the largest size of a message from the application protocol. Parameter name: PROJECT_RECEIVE_BUFFER_SIZE Section in *.PPF: Valid range: [SNA_PROJECT] 0-4096
Value description: integer value Default value: OPMODE This parameter can be used to set a symbolic name that is used by the host for an internal configuration of the SNA connection. If the host does not require this parameter, its value has to consist of 8 blanks. Parameter name: OPMODE Section in *.PPF: Valid range: Value description: Default value: [SNA_PROJECT_INITSELF] maximum 8 digit character string 2048
Destination Logical Unit Name This parameter can be used to set a symbolic name of the Destination LU (DLU) that has to be known on the host side. The DLU name specifies the PLU on the host side that has to open the LU-LU session after the INITSELF command was sent. If the host does not require this parameter, its value has to consist of 8 blanks. Parameter name: DLUNAME Section in *.PPF: Valid range: Value description: Default value: [SNA_PROJECT_INITSELF] 8 digit character string
July 2011
85
Communication OPUID
Parameters in CUSTOM.PPF
This parameter can be used to enter a symbolic name that represents a user identification of the SLU that sends the INITSELF command. If the host does not require this parameter, its value has to consist of 8 blanks. Parameter name: OPUID Section in *.PPF: Valid range: Value description: Default value: OPPASS This parameter can be used to enter a symbolic name that represents the SNA host password for the SLU that sends the INITSELF command. If the host does not require this parameter, its value has to consist of 4 blanks. Parameter name: OPPASS Section in *.PPF: Valid range: [SNA_PROJECT_INITSELF] 4 digit charcater string [SNA_PROJECT_INITSELF] 8 digit character string
Value description: SNA host password Default value: OPLIB This parameter can be used to enter a symbolic name that represents user specific data of the SLU that sends the INITSELF command. The SNA host passes this data to the PLU that has to open the LU-LU session. If the host does not require this parameter, its value has to consist of 8 blanks. Parameter name: OPLIB Section in *.PPF: Valid range: [SNA_PROJECT_INITSELF] 8 digit character string
86
July 2011
Parameters in CUSTOM.PPF
Communication
[X25]
X.25 Communication Framework This parameter is used to specify the X.25 communication framework including the path location. This setting is stored in the Repository section of the Registry. Parameter name: COM_FRAME Section in *.PPF: Valid range: [STARTUP] 256 characters
Value description: specifies the location of the framework Default value: C:\PROTOPAS\BIN\ComX25Ei.dll
Number of Virtual Circuits This parameter is used to set the maximum number of simultaneously usable VCs. If it is omitted an internal default value of 1 is assumed. This number should not be larger than the number of VCs that is configured by the X.25 network for this line. Parameter name: CONTABSIZE Section in *.PPF: Valid range: [X25] 1 - 255
July 2011
87
Parameters in CUSTOM.PPF
This parameter is used to set a timer value in seconds for those X.25 communication frameworks that have configured the Short Hold Mode. If a X.25 connection is established by such a communication framework and there was no data traffic for the duration of this value, the VC is closed internally but the upper communication layers on both the local and the remote DTE are not informed about this event. Internally both communication partners change to listen mode and wait for a connection setup from the other side. If one of the both has to send something, it leaves its listen state and makes an active call to reestablish the connection. For the user of the X.25 communication framework, the connection is in online state the whole time although the VC may be offline internally after the Short Hold Mode timer had expired. If the value of this parameter is greater then 999, it is reset to 999. Parameter name: SHMDELAY Section in *.PPF: Valid range: [X25] 0-999
Waiting time for Call Accept This parameter is used to specify the waiting time for the processing of a X.25 CALL ACCEPT packet by the EICON card during the connection setup. If there was no reaction from the network within this time, an error is reported. The value can be set from 4 up to 999 seconds. Parameter name: NETTIME Section in *.PPF: Valid range: [X25] 4 - 999
88
July 2011
Communication
This parameter is used to set the waiting time for processing of a X.25 CALL REQUEST packet by the EICON card during the connection setup. If there was no reaction from the network within this time, an error is reported. The value can be set from 5 up to 180 seconds. Parameter name: OPENTIME Section in *.PPF: Valid range: [X25] 5 - 180
Waiting time for Clear Request This parameter is used to set the waiting time for processing of a X.25 CLEAR REQUEST packet by the EICON card during the connection release. If there was no reaction from the network within this time, an error is reported. The value can be set from 5 up to 180 seconds. Parameter name: CLOSETIME Section in *.PPF: Valid range: [X25] 5 - 180
July 2011
89
Communication
Parameters in CUSTOM.PPF
Number of calling retries to open X.25 connection The Open method of the communication framework tries at maximum many times to open the X.25 connection than the value of CALLRETRY indicates. If there was no connection established on all tries an error is reported. The value can be a maximum of 5 times. If the value is greater, it is reset to 5. Parameter name: CALLRETRY Section in *.PPF: Valid range: [X25] 0-5
Calling delay timer This is the waiting time between two connection tries in seconds. The value can be set up to 300. If the value is greater, it is reset to 300. Parameter name: CALLDELAY Section in *.PPF: Valid range: [X25] 0-300
Receive buffer size This parameter is used to set the size of the receivebuffer in bytes within the X.25 communication framework. It should not be smaller then the value of parameter MAXRECVSIZE. Parameter name: PROJECT_RECEIVE_BUFFER_SIZE Section in *.PPF: Valid range: [X25_PROJECT] 0-2048
90
July 2011
Communication
This parameter is used to set the index for the specified X.25 connection. The index points to an entry in the X.25 connection table that is administrated by the X.25 support DLL x25corei.dll. This entry contains all necessary administration data for the specified X.25 connection. The value can be omitted. In this case a default value of 1 is assumed. 1 is the lowest entry number and there can not be more entries in the X.25 connection table than the global parameter CONTABSIZE indicates. Parameter name: INDEX Section in *.PPF: Valid range: [X25_PROJECT] 0-99
Type of Virtual Circuit This parameter can have one of the values 0, 1 or 2. If the value is 0, the connection is opened actively by sending a X.25 CALL REQUEST packet to the remote DTE. If the value is 1, the connection is opened passively by changing to the listen mode and waiting for an INCOMING CALL packet from the remote DTE. If the value is 2, the connection is used as a PVC (Permanent Virtual Circuit). Since such a connection is permanent, there is no special need for opening a connection. Nevertheless a X.25 RESET packet is sent. This packet reinitialises counters and buffers of the existing VC and indicates to the remote DTE that the local DTE is operational. Parameter name: VCTYPE Section in *.PPF: Valid range: [X25_PROJECT] 0-2
Value description: 0 - active SVC, 1 - passive SVC, 2 - PVC Default value: 0 - active SVC
July 2011
91
Parameters in CUSTOM.PPF
This parameter is used to suppress the TLS trace. Parameter name: NOTRACE Section in *.PPF: Valid range: [X25_PROJECT] 0, 1
Value description: 0 - trace output is on, 1 - trace output is off Default value: 0
Buffer size in send direction This parameter is used to set the internal VC send buffer size in bytes that is evaluated by the X.25 support DLL x25corei.dll. The value can be up to 4096 bytes large. Parameter name: MAXSENDSIZE Section in *.PPF: Valid range: [X25_PROJECT] 0-2048
Buffer size in receive direction This parameter is used to set the internal VC receive buffer size in bytes that is evaluated by the X.25 support DLL x25corei.dll. The value can be up to 4096 bytes large. Parameter name: MAXRECVSIZE Section in *.PPF: Valid range: [X25_PROJECT] 0-2048
92
July 2011
Communication
This parameter is used to set the PVC number if a PVC connection is configured. The number has to concur with the PVC number setting on the EICON card. The EICON card settings can be viewed with the EICON card support software. Parameter name: PVCNO Section in *.PPF: Valid range: [X25_PROJECT] 0-255
Delivery control for send and receive direction This parameter can be used to activate a so called Delivery Procedure. If the X.25 network supports this procedure, every X.25 data packet is acknowledged by the remote DCE (that is the X.25 network node where the remote DTE is connected to) instead of the local DCE (that is the X.25 network node where the local DTE is connected to). This guarantees, that the data was transported correctly through the X.25 network but not (!) that it was processed correctly by the remote DTE. Parameter name: D_BIT_PROC Section in *.PPF: Valid range: [X25_PROJECT] 0, 1
July 2011
93
Parameters in CUSTOM.PPF
This parameter is used to activate Short Hold Mode for the local DTE. This parameter can be used only in SVC connections. Parameter name: SHMDELAY_FLAG Section in *.PPF: Valid range: [X25_PROJECT] 0, 1
Value description: 0 - no short hold mode, 1 - short hold mode is active Default value: 0
Short Hold Mode passive configuration This parameter is used to refine the behaviour of Short Hold Mode. It can take the value 0, 1 or 2. If the value is 0, every CALL CLEAR packet received from the EICON card is regarded as a Short Hold Mode CALL CLEAR. The communication framework changes into the listen mode and waits for an INCOMING CALL packet from the remote DTE. If the value is 1, during listen mode it is additionally checked whether the physical connection with the modem is active. If this connection is lost, an error is reported. If the value is 2 every CALL CLEAR is regarded as error and is reported to the communication framework user. This parameter is used only in SVC connections. Parameter name: SHM_PASSIVE Section in *.PPF: Valid range: [X25_PROJECT] 0-2
Value description: 0 - CALL CLEAR packets are handled as a Short Hold Mode CALL CLEAR. The communication framework changes to listen mode and waits for an INCOMING CALL from the remote DTE. 1 - Check physical line during listen mode. 2 - Every CALL CLEAR is reported as an error to the communication framework (SVC connections only). Default value: 1
94
July 2011
Communication
This parameter is used to set how the SVC or PVC Open() should be returned. If the value is 0, the Open() method returns immediately. If the value is 1, it blocks infinitely until the connection is established. For a SVC this means that an INCOMING CALL packet has arrived and for a PVC, that a RESET packet has arrived from the remote DTE. If the value is greater then 1 it indicates the number of seconds the Open() method waits for a connection establishment Parameter name: PASSIVE_START Section in *.PPF: Valid range: [X25_PROJECT] 0, 1, >1
Connection reconnect This parameter can be used to define how the communication framework behaves if a CALL CLEAR packet is received while data is sent. If the value is 0, an error is returned in the Send() method. If the value is 1, it is tried to reestablish the VC without error reporting to the communication framework user by the return code of the Send() method. This parameter is used only in SVC connections. Parameter name: SEND_RECONNECT Section in *.PPF: Valid range: [X25_PROJECT] 0, 1
July 2011
95
Communication
Parameters in CUSTOM.PPF
Diagnostic code setting for SHM clear cause This parameter is used to specify a diagnostic code for the SHM clear cause. The value of this parameter is a four characters long string of hexdigits. The first two digits from the left are the Cause Code, the last two digits are the Diagnostic Code that is sent in a CALL CLEAR packet for a Short Hold Mode VC for closing the line. Usually the user defined Cause Code is set to 80h. This parameter is used only in SVC connections. Parameter name: SHMCLRCAUSEDIAG Section in *.PPF: Valid range: [X25_PROJECT] 0000-FFFF
Closed user group selection This parameter is used to specify a closed user group number. It can have a value between 0 and 100. If it is between 0 and 99 it indicates the Closed User Group that the X.25 DTE is assigned to. A Closed User Group is a strictly isolated subnet from the X.25 net. Only users within the group can communicate with each other. If the value is 100, no Closed User Group is defined. The Closed User Group is a X.25 facility that is added to the facility field in the X.25 CALL REQUEST packet to the remote DTE to open the connection. This parameter is used only in SVC connections. Parameter name: CUGSELECTION Section in *.PPF: Valid range: [X25_PROJECT] 0-99, 100
Value description: 0 - 99 specifies a closed user group number 100 - no closed user group defined Default value: 100 - no closed user group defined
96
July 2011
Communication
This parameter is used to specify a Closed User Group with Outgoing Call that X.25 DTE is assigned to. The parameter can have a value between 0 and 100. If it is between 0 and 99 it indicates the Closed User Group with Outgoing Call that X.25 DTE is assigned to. A Closed User Group with Outgoing Call is a restricted subnet of a X.25 net. Users within the group can communicate with each other and can connect to addresses outside of this group. It is not possible to connect to a member of this group from outside of the group. If the value is 100, no Closed User Group with Outgoing Call is defined. The Closed User Group with Outgoing Call is a X.25 facility that is added to the facility field in the X.25 CALL REQUEST packet that is sent from the communication framework to the remote DTE to open the connection. This parameter is used only in SVC connections. Parameter name: CUGOUTSELECT Section in *.PPF: Valid range: [X25_PROJECT] 0 - 99, 100
Value description: 0 - 99 specifies the closed user group number 100 - no closed user group defined Default value: 100 - no closed user group defined
Add Reversed Charging Facility to Call Request packets This parameter is used to add reversed charging facilities for SVC active connections. The value be 0 or 1. If it is 1 the Reversed Charging Facility is added to the facility field of a X.25 CALL REQUEST packet that is sent from the communication framework to open the connection. The communication costs are burdened to the communication partner, if it accepts this facility. This parameter is used only in SVC connections. Parameter name: REVERSECHRG_ACT Section in *.PPF: Valid range: [X25_PROJECT] 0, 1
July 2011
97
Communication
Parameters in CUSTOM.PPF
Accept Reversed Charging Facility of incoming calls This parameter is used to add reversed charging facilities for SVC active connections. The value can be 0 or 1. If it is 1 the Reversed Charging Facility is accepted if it is set in the reversed charging facility field of a X.25 INCOMING CALL packet that was received from the remote DTE to open the connection. The communication costs are burdened to the local DTE account in this case. The parameter is used only in SVC connections. Parameter name: REVERSECHRG_PAS Section in *.PPF: Valid range: [X25_PROJECT] 0, 1
Value description: 0 - accept reversed charging facility 1 - ignore reversed charging facility Default value: 0 - ignore reversed charging facility
Add Call User Data to Call Request packets The parameter is used to add Call User Data in call request packets. The value of this parameter is a string of maximum 16 two-figured hexadecimal numbers separated by blanks. The data of this string defines the Call User Data to be added to a X.25 CALL REQUEST packet that is sent to the remote DTE. This parameter is used only in SVC connections. If no call user data is used, the value of this parameter is an empty string. Parameter name: CALLUSERDATA_A Section in *.PPF: Valid range: [X25_PROJECT] 00 00 00 00 - FF FF FF FF
Value description: call user data in hex notation Default value: 00 00 00 00 - no user data
98
July 2011
Communication
This parameter is used to define call user data to be checked for incoming calls. The value of this parameter is a string of maximum 16 two-figured hexadecimal numbers separated by blanks. The data of this string defines the Call User Data which are checked against the Call User Data in a X.25 INCOMING CALL packet that was received from the remote DTE. The VC is established only if the incoming Call User Data is equal to the parameter value. This parameter is used only in SVC connections. If no call user data is used, the value of this parameter is an empty string. Parameter name: CALLUSERDATA_P Section in *.PPF: Valid range: [X25_PROJECT] 00 00 00 00 - FF FF FF FF
Value description: call user data in hex notation Default value: 00 00 00 00 - no user data
Local station address This parameter is used to set the X.25 address of the local DTE. It can contain a maximum of 15 digits and a possible address extension of maximum 40 digits. This extension has to be separated from the address prefix by a period. Characters other than digits and the period are ignored. This value is used only for SVC connections. Parameter name: LOCALADR Section in *.PPF: Valid range: [X25_PROJECT] integer values max. 15 digits, inclusive address extension 40 digits
July 2011
99
Parameters in CUSTOM.PPF
There are a maximum of five alternative X.25 addresses of the remote DTE. An address not defined is indicated by an empty string for the corresponding parameter. Each address can contain a maximum of 15 digits and a maximum possible address extension of 40 digits. This extension has to be separated from the address prefix by a period. Characters other than digits, the period and asterisks are ignored. If the connection is opened actively, the remote addresses are checked in order from REMOTEDAR1 to REMOTEADR5 for a connection setup. In each probe the remote DTE address is added to the CALL REQUEST packet that is sent to the remote DTE. If the connection is opened passively, the remote address in the INCOMING CALL packet is checked against the alternative addresses in order from REMOTEADR1 to REMOTEADR5. Parameter names: REMOTEADRx [1] Section in *.PPF: Valid range: [X25_PROJECT] integer values max. 15 digits, inclusive address extension 40 digits
100
July 2011
Parameters in CUSTOM.PPF
Communication
[TCPIP]
TCP/IP Communication Framework This parameter is used to specify the TCP/IP communication framework inclusive of the path location. Parameter name: COM_FRAME Section in *.PPF: Valid range: [STARTUP] 256 characters
Value description: specifies the location of the framework Default value: C:\PROTOPAS\BIN\ComTcpIp.dll
Remote station (host) address This parameter is used to set the IP address of the remote station that it tries to connect to. Parameter names: REMOTEPEER REMOTEPEER_X[1] Section in *.PPF: Valid range: [TCPIP_PROJECT] integer values in format xxx.xxx.xxx
Value description: remote station IP address. If DNS is configured you can also enter a name instead of the adress number. Default value:
July 2011
101
Parameters in CUSTOM.PPF
This parameter is needed to specify the remote destination TCP port. Applications above the TCP/IP protocol stack that use TCP communication are identified by their TCP port. This is a WORD sized number that has to be unique for every application using the TCP layer. For a successful communication both client and server have to use the same port number. The port value should be greater than 1024 because ports below could be reserved for the so-called well known ports that are assigned to specific protocols for applications like telnet, ftp or smtp. Parameter name: PORTNUMBER Section in *.PPF: Valid range: [TCPIP_PROJECT] 00000 - 99999
Value description: 5 digit port number Default value: Keep Alive mode This parameter is used to activate keep alive mode. To improve the offline recognition, so-called KEEPALIVE packets can be exchanged over a TCP connection. By using KEEPALIVE packets, one communication partner signals the other that it is still operable. The value of this parameter can be either YES if the local socket sends KEEPALIVE packets to the remote socket or NO if the local socket does not send KEEPALIVE messages. This parameter can be omitted. In this case the default value NO is assumed internally. Parameter name: KEEPALIVES Section in *.PPF: Valid range: [TCPIP_PROJECT] NO, YES 99999
Value description: NO - keep alive mode off, YES - keep alive mode on Default value: YES
102
July 2011
Communication
This parameter is used to specify how long the Open() method waits for a successful connect. If there was no connection established within this time, the Open() method returns with an error code unequal to zero. In the client case the Open() method implicitly retries to establish the connection as many times as the value of the parameter CLIENTOPENRETRY indicates. Every try waits at most OPENTIMEOUT seconds. If no try could open the connection, an error code unequal to zero is returned. Parameter name: OPENTIMEOUT Section in *.PPF: Valid range: [TCPIP_PROJECT] 0 - 255
Connection retries This parameter specifies the maximum number of times the ATM tries to connect to the server. Parameter name: CLIENTOPENRETRY Section in *.PPF: Valid range: [TCPIP_PROJECT] 0 - 255
July 2011
103
Parameters in CUSTOM.PPF
This parameter sets the maximum waiting time the Send() Method waits for processing of the send data by the connected socket. If the data was not processed within this time, a code unequal to zero is returned. This value is necessary because the stream oriented socket can process send data in several send calls where in each call only a part of the message is sent. Parameter name: SENDTIMEOUT Section in *.PPF: Valid range: [TCPIP_PROJECT] 0 - 255
Close timeout timer This parameter sets the waiting time in seconds the Open() Method waits for closing of the TCP/IP connection. If the connection was not closed within this time, a value unequal to zero is returned. In the client case only the connected socket is invalidated. Parameter name: CLOSETIMEOUT Section in *.PPF: Valid range: [TCPIP_PROJECT] 0 - 255
Local port address configuration This parameter can be used to specify a specific local port adress used by TCPIP. If this parameter is set the ATM always is using this local port number. Parameter name: LOCALPORT Section in *.PPF: Valid range: [TCPIP_PROJECT] 0 - 999999
Value description: local port number used by TCPIP Default value: not set in registry and CUSTOM.PPF
104
July 2011
Communication
This parameter contains the absolute pathname of the DLL that processes the conversion between the byte stream delivered by the socket and the messages of the application protocol and vice versa. To identify message boundaries in a bytestream in most cases it is necessary to enhance the application protocol by a special intermediate protocol. The DLL identified by this parameter will be implemented in such a protocol specific enhancement. Parameter name: CODINGDLL Section in *.PPF: Valid range: [TCPIP_PROJECT] character string (path)
ProCash/NDC-DDC provides following coding DLLs: dcTcp2H.dll - to be used if the TCP/IP stream has a 2 Bytes binary header to specify the length of the packet excluding the header length. dcTcp4A.dll - to be used if the TCP/IP stream has a 4 Bytes ASCII header to specify the length of the packet excluding the header length. dcTcp4AI.dll - to be used if the TCP/IP stream has a 4 Bytes ASCII header to specify the length of the packet including the header length. dcTcp2HI.dll - to be used if the TCP/IP stream has a 2 Bytes binary header to specify the length of the packet including the header length. ccTcpEds.dll - to be used if no header is required in both directions.
July 2011
105
Parameters in CUSTOM.PPF
This parameter gives the size of a memory block that will be allocated within the Open() method. A pointer to this block is passed as a parameter to every public function of the DLL that is concerned with the protocol conversion between the bytestream and application message protocol. Since the memory block is local to the communication framework, it allows individual message processing, even if two TCP/IP communication framework objects have been created in the same address space. Parameter name: ADMINSIZE Section in *.PPF: Valid range: [TCPIP_PROJECT] 0 - 99999
106
July 2011
Parameters in CUSTOM.PPF
Communication
All parameters described in this section are located in the follwing Windows registry tree: [HKEY_LOCAL_MACHINE\ SYSTEM\CurrentControlSet\Services\Tcpip\Parameters] KeepAliveTime Parameter name: KeepAliveTime Valid range: 00000000-FFFFFFFF in milliseconds (REG_DWORD)
Value description: This parameter controls how often TCP attempts to verify that an idle connection is still intact by sending a keep alive packet. If the remote system is still reachable and functioning, it will acknowledge the keep alive transmission. Default value: This parameter is not set in the registry by default. The default value used by Windows is set to: 7200000 (two hours)
Value description: Specifies the maximum number of times that TCP/IP will attempt to deliver keep-alive traffic before marking a connection as down. Default value: This parameter is not set in the registry by default. The default value used by Windows is set to 20 tries.
July 2011
107
Parameters in CUSTOM.PPF
Value description: Specifies how often TCP/IP will generate keep-alive traffic. When TCP/IP determines that no activity has occurred on the connection within the specified time, it generates keep-alive traffic to probe the connection. After trying TcpKeepTries number of times to deliver the keep-alive traffic without success, it marks the connection as down. Default value: This parameter is not set in the registry by default. The default value used by Windows is 20 attempts.
Value description: This parameter determines the interval separating keep alive retransmissions until a response is received. Once a response has been received, the delay until the next keep alive transmission is again controlled by the value of KeepAliveTime. The connection will be end after the number of retransmissions specified by TcpMaxDataRetransmissions were unanswered. Default value: This parameter is not set in the registry by default. The default value used by Windows is 1 second.
108
July 2011
Parameters in CUSTOM.PPF TcpMaxDataRetransmissions Parameter name: TcpMaxDataRetransmissions Valid range: Number in milliseconds (REG_DWORD)
Communication
Value description: This parameter controls the number of times TCP will retransmit an individual data segment (non connect segment) before ending the connection. The retransmission timeout is doubled with each successive retransmission on a connection. It is reset when responses resume. The base timeout value is dynamically determined by the measured round-trip time on the connection. Default value: This parameter is not set in the registry by default. The default value used by Windows is 5 times.
Example configuration in Windows registry: [HKEY_LOCAL_MACHINE\ SYSTEM\CurrentControlSet\Services\Tcpip\Parameters] "KeepAliveTime"=dword:00003a98 "TcpKeepTries"=dword:0000000a "TcpKeepCnt"=dword:0000000a "TcpMaxDataRetransmissions"=dword:0000000a "KeepAliveInterval"=dword:00003a98 Description: Parameter "KeepAliveTime" is set to 15000 milliseconds. Parameter "TcpKeepTries" and "TcpKeepCnt" is set to 10. Parameter "KeepAliveInterval" is set to 15000 milliseconds. Parameter "TcpMaxDataRetransmissions" is set to 10.
July 2011
109
Communication
Parameters in CUSTOM.PPF
[SSL_PROJECT]
The following parameters can be set in CUSTOM.PFF under section [SSL_PROJECT].
For detailed descriptions of SSL configuration and additional parameters which are not defined via PARAC, refer to manual: ProTopas Host Protocol and Communication Frameworks Programming Guide Version 4.2/10
Remote station (host) address For a Client this parameter is a comma separated list with values, which the client tries to connect itself to. For a Server it is the address of the client which tries to connect. If the value is * any client will be accepted. The values can be represented as a legal IP address in format d1.d2.d3.d4. D1, d2, d3 and d4 can be configured from 0 up to 255. An alternative representation of these values is as a host name. It is passed to the DNS resolution. Parameter name: REMOTEPEER Section in *.PPF: Valid range: [SSL_PROJECT] comma separated list
110
July 2011
Communication
This parameter defines the remote endpoint at host site for the logical connection. Applications above the TCP/IP protocol stack which use TCP communication are identified by their ports. For a successful communication both client and server have to use the same port number. Parameter name: PORTNUMBER Section in *.PPF: Valid range: [SSL_PROJECT] 00000 - 99999
SSL Coding DLL location This is the absolute pathname of the DLL that processes the conversion between the bytestream delivered by the socket and the messages of the application protocol and vice versa. To identify message boundaries in a bytestream in most cases it is necessary to enhance the application protocol by a special intermediate protocol. The DLL identified by this parameter will implement such a protocol. The following chapter describes the DLL in detail. Parameter name: CODINGDLL Section in *.PPF: Valid range: [SSL_PROJECT] character string (path)
July 2011
111
Parameters in CUSTOM.PPF
This optional comma separated parameter specifies the protocol versions in order to enable them for the use of the connection. The default value is "Default". If this parameter does not exist or you use the default value, the client and the host will negotiate a protocol for the connection. Parameter name: PROTOCOLS Section in *.PPF: Valid range: Value description: The following table lists the valid protocol values: SSLv2SSL version 2 protocol SSLv2Hello SSLv3 and TLSv1 hellos encapsulated in a SSLv2 format SSLv3 SSL version 3 protocol TLSv1 TLS version 1 protocol TCPIP pure TCPIP connection Default [SSL_PROJECT]
Default value:
SSL Message length This parameter gives the size of a memory block which will be allocated within the Open() method. It is the number of bytes read at once from the TCP input stream. Parameter name: MAX_MESSAGE_LENGTH Section in *.PPF: Valid range: Value description: Default value: 8000 [SSL_PROJECT]
112
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_PARAMETER]
[LYNXCI_PARAMETER]
This section contains the NDC specific optional parameters which are downloaded from the host with the Enhanced Customization Table load command. Furthermore this section contains parameters where the Logical Unit Number (LUNO) and the four digit Configuration ID is set.
Value description: Option Code bits for each Option Number Default value: [1] see table 5 on the next page.
July 2011
113
Parameters in CUSTOM.PPF
Separate READY (B) status sent in response to Transaction Reply Auto return to previous mode from supply mode 12 digit amount buffer Auto voice (not supported) default off Date format for supervisor/journal messages MMDD(YY) (default condition) DDMM(YY) (YY)MMDD (YY)DDMM Roll width (Defines the number of receipt and journal columns used to print messages from the host. Default for NDC = 040 and for DDC = 099) Left print column (Defines the leftmost print column for receipt and journal messages. Default is 001) Vandal Guard Open Condition Open vandal guard when card detected (default condition) Open vandal guard when keyboard is enabled Track 1 format ISO format (default condition) VISA format ???? ???? Reserved for future use Diebold status reporting for vandal guard (not supported) Tamper Indicator Control option (not supported) Extended status control (not supported) Specific Command Reject option) Do not transmit Specific Command Reject (default condition) Transmit Specific Command Reject Card reader error thresholds (Default value is 010) Track 3 write error thresholds Codes reserved for future use Envelope dispener status option Do not send unsolicited dispenser messages (default condition) Send unsolicited envelope dispenser messages Codes reserved for future use Enable Audio Echo on Keyboard Do not echo the keyboard (default condition) Echo the keyboard, except in PIN states or * is pressed
114
July 2011
Parameters in CUSTOM.PPF
Codes reserved for future use Message Coordination Number range 31H-3FH (default condition) 31H-7EH Codes reserved for ATM/E private use
July 2011
115
Parameters in CUSTOM.PPF
Value description: The value of this parameter represents the activated bits of the Miscellaneous Features I. (See table 6 for available options). Default value: 0
[1]
116
July 2011
Parameters in CUSTOM.PPF
Value description: The value of this parameter represents the activated bits of the Miscellaneous Features II. (See table 7 for available options). Default value: 0
[1]
July 2011
117
Parameters in CUSTOM.PPF
Value description: The value of this parameter represents the activated bits of the Miscellaneous Features II. (See table 8 for available options). Default value: 0
[1]
118
July 2011
Parameters in CUSTOM.PPF
July 2011
119
[LYNXCI_TIMER]
Parameters in CUSTOM.PPF
[LYNXCI_TIMER]
This section contains timer parameters which are downloaded through the Configuration Parameters load or Enhanced Configuration Parameters load command. All settings provided in CUSTOM.PPF are default settings. They can be modified if the values will not be modified via the host download. Timer values of the "Configuration Parameters" load command are downloaded in ticks (1 tick = 0,8s). The timer values of the enhanced load are seconds. ProCash/NDC-DDC stores all timer values as seconds into the registry.
120
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_TIMER]
July 2011
121
[LYNXCI_TIMER]
Parameters in CUSTOM.PPF
122
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_TIMER]
July 2011
123
[LYNXCI_TIMER]
Parameters in CUSTOM.PPF
124
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_TIMER]
Unsupported timers
The following table lists downloadable timers which are not supported by ProCash/NDC-DDC:
July 2011
125
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
[LYNXCI_SCREEN]
Screen default foreground color
This parameter is used to set the default foreground color of the screens to be displayed. The parameter consists of the three RGB (Red, Green, Blue) components used in creating the specified color. Parameter name: SCREEN_FOREGROUND_COLOR Section in *.PPF: Valid range: [LYNXCI_SCREEN] 0-255, 0-255, 0-255
Value description: three integer values which contain the RGB components of the color. Default value: 255,255,255
The following table shows the RGB values for the 16 standard colors:
Table 10: RGB values for 16 standard colors
RED
0 0 0 0 170 170 170 170 85 85 85 85 255 255 255 255
GREEN
0 0 170 170 0 0 85 170 85 85 255 255 85 85 255 255
BLUE
0 170 0 170 0 170 0 170 85 255 85 255 85 255 85 255
COLOR black dark blue dark green dark cyan dark red dark magenta dark yellow light grey dark grey light blue light green light cyan light red light magenta light yellow white
126
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_SCREEN]
Value description: three integer values which contain the RGB components of the color. Default value: 0,0,0
July 2011
127
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
Value description: three characters in uppercase Default value: NCR - sets the NCR compatible layout
Blink rate
This parameter can be used to modify the default blink rate which is used for the blinking sequence defined in a downloaded screen. Parameter name: BLINK_RATE Section in *.PPF: Valid range: [LYNXCI_SCREEN] 200 - 9999
128
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_SCREEN]
Value description: path of the graphic file including the file name Default value: Example: "C:\PROTOPAS\BITMAPS\PICTURE.PCX"
[1]
XXXX represents the graphic number which is defined in the downloaded screen. The number can represent icons, logos, or picture sequences. The following table describes which kind of picture controls can be configured via parameter PICTURE_XXXX:
July 2011
129
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
Value description: the parameter value consists of a list of 6 comma separated parameters:
Position 0 1 Description path location of the Flash file delay time in milli seconds. Specifies how long the Flash animation remain displayed after the process has been terminated. This is useful to prevent screen flickery when after a Flash movie is following a JPG or BMP picture. Default if not specified: 0 Display priority of the running Flash process. This option can be used to specify the process priority. If you specify 1, the process has a lower priority as other processes. 0 - normal 1 - IDLE 2 - HIGH Default if not specified: 0 Specifies the window name (case sensitive) of the Flash movie. Default if not specified: ShockwaveFlash Display Options (bits): 1 - show Flash in normal mode (no Fullscreen stretch) 2 - display Background screen if configured via parameter PICTURE_BACKGROUND after Flash is displayed reserved file name of the Flash movie inclusive .EXE extension
3 4
5 6
XXXX represents the graphic number which is defined in the downloaded screen. The number can represent icons, logos, or picture sequences. See also Abschnitt Graphic file location on
page 129.
130
July 2011
[LYNXCI_SCREEN]
If you stop the application without rebooting the system, you have to kill a running flash movie separately. Please add following lines in FWKILL.BAT: c:\protopas\tools\kilflash.exe > c:\protopas\kilflash.bat call kilflash.bat
July 2011
131
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
Value description: path of the palette file including the file name Default value: Example: "C:\PROTOPAS\BITMAPS\DAC000.DAT"
[1]
XXX represents the palette file number which is appended to the graphic file name. PALETTE_DEFAULT can be used to set a basic color palette for all graphic files if you do not have specific palette files for each graphic.
[2]
ProCash/DDC provides following default DAC files: DAC000.DAT - contains the default color palette DAC001.DAT - contains color black.
132
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_SCREEN]
Value description: number of pixels the window is moved down from the top most position. Default value: 0
July 2011
133
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
Value description: number of pixels the window is moved from the left most position to the right. Default value: 0
Value description: path location of the graphic file Default value: Example: "" "C:\PROTOPAS\BITMAPS\EXAMPLE.PCX"
134
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_SCREEN]
Value description: 0 - play videos in original size 1 - play videos stretched in full screen mode Default value: not configured in Registry
Value description: specifies the substitution character Default value: not configured
July 2011
135
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
Value description: The first parameter specifies a graphic or video file extension that should be processed instead of the extension specified in the host download or specified via param. PICTURE_BACKGROUND or PICTURE_XXXX. The second parameter specifies the display method: 0 - use Presentation Framework of Protopas for Bitmaps 1 - use CCMCIPLY.EXE to play Videos repeatedly 3 - use CCMCIPLY.EXE to play Videos once Default value: Example: not configured in Registry The following parameter setting assigns a FLC extension to an AVI extension using display method of CCMCIPLY.EXE to play videos repeatedly: PICTURE_EXT_FLC = "AVI,1"
136
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_SCREEN]
Value description: 0 - Play AVI infinite 1 - Stop AVI after delay as specified in the screen Default value: not configured in Registry
Value description: 0 - No touch zone support in PIN entry states 1 - Enable touch zone support in PIN entry dialogs Default value: not configured in Registry
On Wincor Nixdorf ATMs this parameter works only if EPP hardware is installed or EDS is in use.
July 2011
137
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
Value description: specifies the FDK where the confirm key is assigned to. Default value: not configured in Registry
Value description: full path definition of the wave file. Default value: not configured in registry
138
July 2011
Parameters in CUSTOM.PPF
[LYNXCI_SCREEN]
Value description: full path definition of the wave file. Default value: not configured in registry
Value description: specifies the substitution character in PIN entry and Information Entry states Default value: Example entry: not configured in Registry, use X as substitution character SUBST_CHAR_SCREEN = *
July 2011
139
[LYNXCI_SCREEN]
Parameters in CUSTOM.PPF
Value description: specifies the screen number that is displayed instead of screen 003 or C03. Default value: not configured in registry
Note: If you have to emulate a Diebold MDS i series system, you need to specify value 002.
Value description: specifies the minimum PIN digits the consumer has to enter on the PIN pad. Default value: not configured in registry
140
July 2011
Parameters in CUSTOM.PPF
[SCREEN_XXX] [1]
[SCREEN_XXX] [1]
[1] XXX represents the screen number which is downloaded from host.
Foreground Color
This parameter can be used to set a specific foreground color for a downloaded screen. Parameter name: FOREGROUND_COLOR Section in *.PPF: Valid range: [SCREEN_XXX] 0-255, 0-255, 0-255
Value description: three integer values which contain the RGB components of the color. Default value: if the parameter is not set, the values in Registry section "SCREEN" are used.
Background Color
This parameter can be used to set a specific background color for a downloaded screen. Parameter name: BACKGROUND_COLOR Section in *.PPF: Valid range: [SCREEN_XXX] 0-255, 0-255, 0-255
Value description: three integer values which contain the RGB components of the color. Default value: if the parameter is not set, the values in Registry section "SCREEN" are used.
July 2011
141
[SCREEN_XXX] [1]
Parameters in CUSTOM.PPF
Value description: -1 - no next screen; next screen number Default value: -1 - no next screen
Value description: -1 - no time; timer value in milli seconds Default value: -1 - no time
142
July 2011
Parameters in CUSTOM.PPF
[SCREEN_XXX] [1]
Value description: number of pixels in horizontal direction Default value: If the parameter is not set, the values of Registry section "SCREEN" are used.
Value description: number of pixels in vertical direction Default value: If the parameter is not set, the values of Registry section "SCREEN" are used.
Screen contents
This parameter should be set in CUSTOM.PPF only if no screen contents are downloaded from host. You can use this parameter just in case if you like to configure a screen locally that is not downloaded from host. Parameter name: SCREEN_CONTENTS Section in *.PPF: Valid range: [SCREEN_XXX] valid ASCII screen sequences (NDC or DDC specific)
Value description: contains screen contents to be displayed Default value: not set in Registry
July 2011
143
[SCREEN_XXX] [1]
Parameters in CUSTOM.PPF
Value description: number of pixels the window is moved down from the top most position. Default value: 0
Value description: number of pixels the window is moved from the left most position to the right. Default value: 0
144
July 2011
Parameters in CUSTOM.PPF
[SCREEN_XXX] [1]
Value description: path location of the graphic file Default value: Example: "" "C:\PROTOPAS\BITMAPS\EXAMPLE.PCX"
July 2011
145
[SCREEN_XXX] [1]
Parameters in CUSTOM.PPF
Value description: 0 - suppress displaying downloaded screen contents 1 - yes, display contents Default value: 1 - yes, display contents
Value description: Specifies the left offset of the upper left corner of the input rectangle. Default value: not used (remarked)
146
July 2011
Parameters in CUSTOM.PPF Upper top offset of the input rectangle Parameter name: INPUT_FIELD_TOP Section in *.PPF: Valid range: [SCREEN_XXX] 0-9999 (pixel)
[SCREEN_XXX] [1]
Value description: Specifies the top offset of the upper left corner of the input rectangle. Default value: not used (remarked)
Lower right offset of the input rectangle Parameter name: INPUT_FIELD_RIGHT Section in *.PPF: Valid range: [SCREEN_XXX] 0-9999 (pixel)
Value description: Specifies the right offset of the lower right corner of the input rectangle. Default value: not used (remarked)
Lower bottom offset of the input rectangle Parameter name: INPUT_FIELD_BOTTOM Section in *.PPF: Valid range: [SCREEN_XXX] 0-9999 (pixel)
Value description: Specifies the bottom offset of the lower right corner of the input rectangle. Default value: not used (remarked)
July 2011
147
Parameters in CUSTOM.PPF
This parameter controls the character adjustment of the consumer input. Parameter name: INPUT_FIELD_ADJUST Section in *.PPF: Valid range: [SCREEN_XXX] 0, 1, 2
Value description: 0 - character input from left to right 1 - character input from right to left 3 - character input centered, characters are moving to right and to left Default value: not used (remarked)
It is very important that for the cursor configuration all five parameters as described above are set in the [SCREEN_XXX] section.
Configuration Example: You have set following values: INPUT_FIELD_LEFT = 0; INPUT_FIELD_TOP = 24; INPUT_FIELD_RIGHT = 32; INPUT_FIELD_BOTTOM = 456; INPUT_FIELD_ADJUST = 0;
Description: The input rectangle is definded on the left side starting with the first character at the left border on the second line. The input size is exactly two characters.
The offset values are dependent from the display resolution and the font size. If you have a display resolution of 640x480 and your font has the size and height of 16x24, (value / 16) = 1 character adjust for parameter xxx_LEFT or xxx_RIGHT, (value / 24) = 1 character adjust for parameter xxx_TOP or xxx_BOTTOM.
148
July 2011
Parameters FOREGROUND_COLOR BACKGROUND_COLOR TRANSPARENT_MODE PICTURE_BACKGROUND CHARACTER_WIDTH CHARACTER_HEIGHT VERTICAL_OFFSET HORIZONTAL_OFFSET INPUT_FIELD_LEFT Example:
If the host downloads screen 011 that contains "ESCL002", the screen contents are stored in registry section "..\LYNXCI\SCREEN\BANK_002\011".
Parameters needed in language bank sub sections can not be configured in CUSTOM.PPF used by PARAC. Please use the way via creating an *.INA file. See also section Vendor and AddOn depended configuration on page 288.
July 2011
149
Parameters in CUSTOM.PPF
Value description: Defines the message string for the journal printer Default value: see definitions in CUSTOM.PPF
[1]
XXXX represents a fixed four digit definition number which is related to the error map table (CCErrMap) together with DESTXXXX.
150
July 2011
The event and error message text can be prepared with some variables. Here is a short overview of some variables and their meaning:
Table 13: Variables and formats for event and error messages
Variable @2 @3 @4 @5 @6 #NL# $XXX$ %XXX% Description prints the current day in two integer digits prints the current month in two integer digits prints the current year in four integer digits prints the current time Output format dd mm yyyy hh:mm:ss
Inserts a three digit security number (000-999) ddd macro - initiates a new line defines a variable name from the variable framework (ccvarfw.dll) defines a variable name from the data dictonary framework (ccdatdic.dll) if it is loaded via FwLoadPM.exe variable variable
July 2011
151
Parameters in CUSTOM.PPF
XXXX represents a fixed four digit definition number which is related to the error map table (CCERRMAP) together with MSGXXXX.
152
July 2011
Parameters in CUSTOM.PPF
[HARDWARE_CONFIGURATION]
[HARDWARE_CONFIGURATION]
Hardware Configuration Parameters (NDC)
The following table describes the hardware device configuration which is sent in the NDC solicited status message Send Configuration Information.
Table 14: Hardware Configuration Parameters (NDC)
Parameter HW_CONF_0_PROD_CLASS HW_CONF_1_NOCONFIG HW_CONF_2_DISK HW_CONF_3_CARD_READER HW_CONF_4_CASH_HANDLER HW_CONF_5_DEPOSIT HW_CONF_6_REC_PRINTER HW_CONF_7_JRN_PRINTER HW_CONF_8_RESERVED HW_CONF_9_RESERVED HW_CONF_10_NIGHT_DEPOSIT HW_CONF_11_ENCRYPTOR HW_CONF_12_CAMERA HW_CONF_13_DOOR_ACCESS HW_CONF_14_FLEX_DISK HW_CONF_15_TAMPER_BINS HW_CONF_16_CARDHOLDER_KEYB HW_CONF_17_OPERATOR_KEYB HW_CONF_18_DISPLAY_VOICE HW_CONF_19_NOCONFIG HW_CONF_20_NOCONFIG HW_CONF_21_STATEMENT_PRT HW_CONF_22_SIG_DISPLAY HW_CONF_23_RESERVED HW_CONF_24_COIN_DISP HW_CONF_25_SYSTEM_DISPLAY HW_CONF_26_MED_ENT_IND Description Product Class No Configuration System Disk Card Reader/Writer Cash Handler Depository Receipt Printer Journal Printer Reserved Reserved Night Safe Depository Encryptor Security Camera Door Access Flex Disk Tamper Indicating Bins Cardholder Keyboard Operator Keyboard Cardholder Display/Voice No Configuration No Configuration Statement Printer Signage Display Reserved Coin Dispenser System Display Media Entry Indicators Default Value 11 7F 00 03 01 02 [1] 01 [1] 01 [1] 00 00 00 01 00 00 00 00 00 00 02 7F 7F 7F [1]
July 2011
153
[HARDWARE_CONFIGURATION]
Parameters in CUSTOM.PPF
HW_CONF_27_ENV_DISP HW_CONF_28_DOC_PROC_MOD HW_CONF_29_COIN_TAMP_IND HW_CONF_30_DOC_TAMP_IND HW_CONF_31_RESERVED HW_CONF_32_DIG_AUDIO_SERV HW_CONF_33_RESERVED HW_CONF_34_RESERVED HW_CONF_35_RESERVED HW_CONF_36_RESERVED HW_CONF_37_RESERVED
Envelope Dispenser Document Processing Module Coin Tamper Indication Document Tamper Indication Reserved Digital Audio Service Reserved Reserved Reserved Reserved Reserved
[1] - Depending on the available hardware, this value will be modified by utility "SETHWPPF.EXE" during installation.
Value description: 0 - logging off; 1 - NDC logging on; 2 - DDC logging on Default value: 0
154
July 2011
Parameters in CUSTOM.PPF
[HARDWARE_CONFIGURATION]
EXPANDED_HW_CONF_BYTE_0 02 EXPANDED_HW_CONF_BYTE_1 00 EXPANDED_HW_CONF_BYTE_2 00 [1] EXPANDED_HW_CONF_BYTE_3 00 EXPANDED_HW_CONF_BYTE_4 00 EXPANDED_HW_CONF_BYTE_5 00 EXPANDED_HW_CONF_BYTE_6 00 EXPANDED_HW_CONF_BYTE_7 00 [1] EXPANDED_HW_CONF_BYTE_8 00 EXPANDED_HW_CONF_BYTE_9 28
[1] - Depending on the available hardware, this value will be modified by utility "SETHWPPF.EXE" during installation. Note1: Note2: This field will be filled dynamically by application The two digit value represents one Byte where the left digit is the high part and the right digit the low part. The range of each digit is 30H to 3FH. The value itself has to be entered as an ASCII character value for the high part and the low part of the byte (see reference table).
HEX Value 30H 31H 32H 33H 34H 35H ASCII char 0 1 2 3 4 5 HEX Value 36H 37H 38H 39H 3AH 3BH ASCII char 6 7 8 9 : ; HEX Value 3CH 3DH 3EH 3FH ASCII char < = > ?
July 2011
155
[HARDWARE_CONFIGURATION]
Parameters in CUSTOM.PPF
MACing configuration
Send TVN and MAC in Transaction Request messages This parameter is used to set if the TVN (Time Variant Number) and MAC have to be sent in Transation Request messages. Parameter name: SEND_TVN_MAC Section in *.PPF: Valid range: [HARDWARE_CONFIGURATION] 0-1
Value description: 0 - do not send TVN and MAC 1 - TVN and MAC will be sent Default value: 0 - do not send TVN and MAC
Check TVN and MAC This parameter is used to set if the TVN (Time Variant Number) and the MAC have to be checked in Transaction Reply, State table or FIT Load messages. Parameter name: CHECK_TVN_MAC Section in *.PPF: Valid range: [HARDWARE_CONFIGURATION] 0-1
Value description: 0 - do not check TVN and MAC 1 - TVN and MAC will be checked Default value: 0 - do not check TVN and MAC
Send Machine Number This parameter is used to set if the Machine Number (Security Terminal Number) has to be sent in terminal to host messages. Parameter name: SEND_MACHINE_NO Section in *.PPF: Valid range: [HARDWARE_CONFIGURATION] 0-1
Value description: 0 - do not send the Machine number 1 - include the Machine number in the messages Default value: 156 0 - do not send the Machine Number July 2011
[HARDWARE_CONFIGURATION]
This parameter is used to set if the Machine Number (Security Terminal Number) has to be checked in Transaction Reply messages. Parameter name: CHECK_MACHINE_NO Section in *.PPF: Valid range: [HARDWARE_CONFIGURATION] 0-1
Value description: 0 - do not check the Machine number 1 - check the Machine number Default value: 0 - do not check the Machine Number
Send TVN and MAC in solicited status This parameter is used to set if the Time Variant Number and MAC have to be sent in solicited device status messages. Parameter name: SEND_TVN_MAC_SOL Section in *.PPF: Valid range: [HARDWARE_CONFIGURATION] 0-1
Value description: 0 - do not send TVN and MAC 1 - TVN and MAC will be sent Default value: 0 - do not send TVN and MAC
Field selected MACing This parameter is used to activate field selected MACing. The fields to MACed are defined in the Message Authentication Field Selection Load command. Parameter name: MAC_FLD_SELECTED Section in *.PPF: Valid range: [HARDWARE_CONFIGURATION] 0-1
Value description: 0 - Field selected MACing OFF 1 - Filed selected MACing ON Default value: 0 - Field selected MACing OFF (DDC) 1 - Field selected MACing ON (NDC)
July 2011
157
[HARDWARE_CONFIGURATION]
Parameters in CUSTOM.PPF
ASCII MACing activation in EBCDIC line environments This parameter is used to force MACing calculation in ASCII. This parameter is only needed if the line communication is EBCDIC and the MAC has to be calculated in ASCII. Parameter name: MAC_ASCII Section in *.PPF: Valid range: [HARDWARE_CONFIGURATION] 0-1
Value description: 0 - MAC calculation as received from line 1 - MAC calculation always in ASCII Default value: 0 - MAC calculation as received from line
Value description: 0 - Status codes entered in CCERRMAP.INA are modified by the application for solicited and unsolicited messages. 1 - M-Data or MDS i series status codes are replaced through STCLASS, STCODE, STWARN for solicited or unsolicited messages. (3 x 4 Bytes = 12 characters) 2 - Status codes entered in CCERRMAP.INA remain unchanged in solicited and unsolicited messages. Default value: 0 - Status codes entered in CCERRMAP.INA are modified by the application for solicited and unsolicited messages.
158
July 2011
Parameters in CUSTOM.PPF
[HARDWARE_CONFIGURATION]
Value description: 0 - stay online; 1 - go offline after reply timeout Default value: 0 - stay online
Value description: 0 - encoding off, hexa decimal field values 1 - BASE64 encoding enabled Default value: 0 - encoding off
July 2011
159
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
[1] XXX represents the protocol type which can be NDC or DDC.
Value description: 0 - use current fitness after exiting supervisor mode; 1 - clear fitness after exiting supervisor mode Default value: 1 - clear fitness after exiting supervisor mode
If the parameter is not set in the Registry, the hardware fitness is cleared after exiting supervisor mode (like value 1).
Resend Power Up
This parameter is used to set what time cycle the power up message should be repeated to the host. Parameter name: RESEND_POWER_UP Section in *.PPF: Valid range: [APPLICATION_XXX] 0-99999
160
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: time value in seconds. (0 = suspend mode is switched off) Default value: 30 - suspend mode timeout after 30 seconds
July 2011
161
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: GENERAL - Send door open message if one of the doors has been opened, and send close message if both doors are closed. SAFE - Send open/closed message if safe door has been opened/closed. OPERATOR - Send open/closed message if operator door has been opened/closed. Default value: GENERAL
Value description: 0 - do not enter SV mode >0 - enter SV mode after the specified time delay. Default value: 0 - option disabled
162
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
The following parameter activates queuing for unsolicited messages within transactions. If a transaction request message has been sent to the host, unsolicited messages will be queued until the ready response is sent after the host reply. Unsolicited sensor messages (doors, cassettes change) or device fault messages are sent to the host after the transaction ready message. Parameter name: Q_UNSOL_IN_TRAN_REQ Section in *.PPF: Valid range: [APPLICATION_XXX] 0, 1
Value description: 0 - message immediately sent to host. 1 - queue message within transactions and send it after transaction ready. Default value: 0 - NDC; 1 - DDC
The next parameter activates queuing of solicited messages during offline mode. Solicited messages unable to be sent to the host during offline mode are queued until the terminal is again online. Parameter name: Q_OFFLINE_TRAN_READY Section in *.PPF: Valid range: [APPLICATION_XXX] 0, 1
Value description: 0 - ignore solicited messages during offline. 1 - queue message during offline and sent it when online. Default value: 0 - NDC; 1 - DDC
July 2011
163
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: see table 6, table 7 and table 8 for detailed value description.
Value description: 0 - switch on/off ready indicator only 1- switch on/off logo light together with the ready indicator Default value: 0
164
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
[APPLICATION_XXX]
Value description: The values of each option can be added together if you want to set more than one option. Example: Value 3 sets "Separate Ready (B)" and "Auto return to previos mode from supply mode". Default value: 0 - No option is set
Refer to ProCash/NDC User Guide for detailed field description of the Configuration Parameters Load message (13). See also Abschnitt Optional Parameters (NDC) on page 113 of this manual.
July 2011
165
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: Sets the number of read/write errors which can occur before a message is sent to the network. Default values: 10 - for read errors; 3 - for write errors
Refer to ProCash/NDC- or ProCash/DDC User Guide for detailed description of parameter option "13" and "14" in the Enhanced Configuration Parameters (1A) and see also the parameter fields of the Configuration Parameters (13) load (Write Command III for DDC). See also Abschnitt Optional Parameters (NDC) on page 113 and of this manual.
Value description: 0 - return to "In Service" mode if previous mode was "In Service" before offline. 1 - enter "Out of Service" mode after reconnection Default value: 0
166
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: specifies the time in seconds the application waits for the "Go in service" command from host. Default value: 30
July 2011
167
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
All parameters can be configured in the same parameter syntax as follows: IndicatorType:Number,IndicatorType:Number,IndicatorType:Number, ... For the Customer Relays you have to enter keyword REL for IndicatorType. A positive value in range 1-4 of Number indicates to switch ON the specified Relay number. A negative value (preceding minus character) in range 1-4 of Number indicates to switch OFF (inverted logik) the specified Relay number. For Status Indicators of the Operator Panel you have to enter OPL for IndicatorType. Range 0-4 of Number (ON/OFF behaviour see Relay description) represents the control of the Status Indicators in following order:
OPL Status Indicators In Service Indicator Customer Indicator Cash Indicator Paper Indicator tech. Service Indicator
Number 0 1 2 3 4
EXAMPLE 1: Assume you like to switch ON the Customer Relay 2 and the Customer Indicator of the Operator Panel when the ATM mode is in service. In addition you like to configure to switch OFF the tech. Service Indicator of Operator Panel: Following parameter setting in CUSTOM.PPF is required: LED_IN_SERVICE = REL:2,OPL:0,OPL:-4
EXAMPLE 2: Assume you like to configure Customer Relay 3 and 4 and the tech. Service Indicator on the Operator Panel when the ATM mode is in Supervisor Mode. Following parameter setting in CUSTOM.PPF is required: LED_SVR_MODE = REL:3,REL:4,OPL:4
NOTE:
168
July 2011
Parameters in CUSTOM.PPF LED_IN_SERVICE (ATM is in service mode) Parameter name: LED_IN_SERVICE Section in *.PPF: Valid range: [APPLICATION_XXX]
[APPLICATION_XXX][1]
IndicatorType:Number,IndicatorType:Number, ...
Value description: specifies which Relay Indicator(s) and Operator Panel Indicator(s) should be switched on/off during in service mode. Default value: not configured in registry (internal default handling of transaction framework is used)
LED_CUSTOMER (transaction active) Parameter name: LED_CUSTOMER Section in *.PPF: Valid range: [APPLICATION_XXX] IndicatorType:Number,IndicatorType:Number, ...
Value description: specifies which Relay Indicator(s) and Operator Panel Indicator(s) should be switched on/off if a consumer transaction is active. Default value: not configured in registry (internal default handling of transaction framework is used)
LED_CASH (cash cassette(s) has/have low or out status) Parameter name: LED_CASH Section in *.PPF: Valid range: [APPLICATION_XXX] IndicatorType:Number,IndicatorType:Number, ...
Value description: specifies which Relay Indicator(s) and Operator Panel Indicator(s) should be switched on/off when the cash cassette(s) has/have a low or out status. Default value: not configured in registry (internal default handling of transaction framework is used)
July 2011
169
[APPLICATION_XXX][1] LED_PAPER (printer paper low) Parameter name: LED_PAPER Section in *.PPF: Valid range: [APPLICATION_XXX]
Parameters in CUSTOM.PPF
IndicatorType:Number,IndicatorType:Number, ...
Value description: specifies which Relay Indicator(s) and Operator Panel Indicator(s) should be switched on/off if the printers has/have paper low status. Default value: not configured in registry (internal default handling of transaction framework is used)
LED_SERVICE (technical service required) Parameter name: LED_SERVICE Section in *.PPF: Valid range: [APPLICATION_XXX] IndicatorType:Number,IndicatorType:Number, ...
Value description: specifies which Relay Indicator(s) and Operator Panel Indicator(s) should be switched on/off if technical service or maintanance is required for one or more ATM devices. Default value: not configured in registry (internal default handling of transaction framework is used)
LED_SVR_MODE (ATM in supervisor mode) Parameter name: LED_SVR_MODE Section in *.PPF: Valid range: [APPLICATION_XXX] IndicatorType:Number,IndicatorType:Number, ...
Value description: specifies which Relay Indicator(s) and Operator Panel Indicator(s) should be switched on/off when the ATM is in supervisor mode Default value: not configured in registry (internal default handling of transaction framework is used)
170
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
The LED configuration parameters are preset with following defaults if the parameters are not set in the registry:
Parameter LED_IN_SERVICE LED_CUSTOMER LED_CASH LED_PAPER LED_SERVICE LED_SVR_MODE Relay OPL OPL OPL OPL OPL Number 0 1 2 3 4 -
On Wincor Systems the RSI status can only be GREEN or YELLOW or RED. Multiple lights cannot be enabled. RSI is connected to the Relay output 1-3 of the Special Electronic. The colors Red, Yellow and Green are assigned to fixed Relay positions, RELAY1 = Red, RELAY2 = Yellow, RELAY3 = Green. To configure RSI you can use the same parameters (but with some restrictions), as used to configure Customer Relays (see also Abschnitt Configure Customer Relays 1 - 4 on page 167).
July 2011
171
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
All parameters can be configured in the same parameter syntax as follows: IndicatorType:Number,IndicatorType:Number,IndicatorType:Number, ... For RSI you have to enter keyword REL for IndicatorType. The value of Number has to be zero which enables the RSI processing. You have to set Status Indicators of the Operator Panel together with RSI lights. See Abschnitt Configure Customer Relays 1 - 4 on page 167 for detailed description about Status Indicator configuration of Operator Panel. EXAMPLE: The following parameters in CUSTOM.PPF configure RSI and the belonging Status Indicators of the Operator Panel. LED_IN_SERVICE = LED_CASH = LED_PAPER = LED_SERVICE = REL:0,OPL:0 REL:0,OPL:2 REL:0,OPL:3 REL:0,OPL:4
RSI Status GREEN (RELAY3) Parameter name: LED_IN_SERVICE Section in *.PPF: Valid range: [APPLICATION_XXX] REL:0,IndicatorType:Number, ...
Value description: enables green RSI for In Service mode and as an option Operator Panel Indicator(s). Default value: not configured in registry (internal default handling of transaction framework is used)
172
July 2011
Parameters in CUSTOM.PPF RSI Status YELLOW (RELAY2) Parameter name: LED_CASH LED_PAPER Section in *.PPF: Valid range: [APPLICATION_XXX] REL:0,IndicatorType:Number, ...
[APPLICATION_XXX][1]
Value description: enables yellow RSI for cash low/out and paper low status and as an option Operator Panel Indicator(s). Default value: not configured in registry (internal default handling of transaction framework is used)
RSI Status RED (RELAY1) Parameter name: LED_SERVICE Section in *.PPF: Valid range: [APPLICATION_XXX] REL:0,IndicatorType:Number, ...
Value description: enables red RSI if the ATM is offline, out of service or in supervisor mode and as an option Operator Panel Indicator(s). Default value: not configured in registry (internal default handling of transaction framework is used)
July 2011
173
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
For Multivendor environments on NCR Systems the Indicator Type has to be set to IndicatorType RSMNCR. Example: LED_CASH = RSMNCR
174
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
July 2011
175
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: The flash rate can be configured in multiple ways: The 1st way is to specify the flash rate equally for all devices.
Example 1: GUIDE_FLASH_RATE = "3" specifies quick flash for all devices.
The 2nd way specifies the flash rate individually for a specific device. The value position in the comma separated list automatically specifies the device where the flash value is assigned to. The positions are assigned to the devices as follows:
0 - Card Reader 2 - Notes Dispenser 4 - Receipt Printer 6 - Deposit Module 8 - Bill Acceptor 10 - Document Printer 12 - Scanner Module 14 - Coin Acceptor Out[1]
[1]
1 - Pin Pad 3 - Coin Dispenser 5 - Passbook Printer 7 - Cheque Module 9 - Envelope Dispenser 11 - Coin Acceptor 13 - Coin Acceptor Reject[1]
- Wincor only
Example 2:
GUIDE_FLASH_RATE = "3,0,0,1,0,0,0,0,0,0,0,0,2,0,0" Configures quick flash for the Card Reader, slow flash for the Coin Dispenser and medium flash for the Scanner Module.
Important Note:
Please make sure that the guide light control of all other software layers like XFS or the driver layer underneath are being switched off to prevent concurrent calls of these layers.
176
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: Positive value: If the ATM has been started and the line connection is online up to know the ATM mode is triggered. If the ATM mode changes to offline, the timer is started. If the ATM remains offline and the timer expires, the reboot flag is set. Dependency Restart Manager: - If parameter SHUTDOWN_ACTIVE is set to "1", a system reboot takes place. - If the value is "0" the application will be just killed. Negative value: Immediately if the ATM has been started, the connection is checked for online. The timer starts when the application is in offline mode. If the ATM mode does not change from offline to online within the specified time, the reboot flag is set. If ATM gets line connection after restart. The behavior is the same as described in the section above (Positive value). Dependency Restart Manager: - If parameter SHUTDOWN_ACTIVE is set to "1", a system reboot takes place. This cycle will be repeated until we get line connection and number of times configured in MAXREBOOT. - If the value of SHUTDOWN_ACTIVE is "0" the application will be just killed. Default value: not configured in registry
July 2011
177
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: 0 - Encryption key load with double length keys are rejected. Send command reject message to the host. 1 - Encryption key load with double length keys are accepted. Send ready message to the host. Default value: not configured in registry
Value description: 0 - General Purpose buffers are NOT zero filled. 1 - Preset General Purpose buffers with leading zeros. Default value: not configured in registry
178
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: specifies the cassette names for the reject cassette and for each single cash out cassette. Default value: [1] not configured in registry x = physical cassette number beginning with 1 for the first dispense cassette. The parameters JOU_NAME_CASS1, JOU_NAME_CASS2, JOU_NAME_CASS3 and JOU_NAME_CASS4 define the names of 4 cassettes.
Configuration Option 2: Parameter names: JOU_NAME_REJECT JOU_NAME_CASSN Section in *.PPF: Valid range: [APPLICATION_XXX] For parameter JOU_NAME_CASSN you have to include in addition to a unique cassette name the characters $N$ that are replaced with the physical cassette number. Range for parameter JOU_NAME_REJECT as defined in Configuration Option 1.
Value description: specifies the cassette names for the reject cassette and cash out cassettes. Default value: not configured in registry
July 2011
179
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Parameter names: JOU_TXT_REJECTS JOU_TXT_RETRACTS Section in *.PPF: Valid range: [APPLICATION_XXX] character string (max. 40 characters)
Value description: specifies the journal text that is logged on journal for the number of cash retracts and rejects. The counter with the size of 4 digits for each parameter will be appended to the new defined text separated with one space to the right. Default value: not configured in registry
180
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
ADRS options
This parameter can be used to set specific ADRS options to optimize the ADRS behaviour. By default ProCash/NDC and ProCash/DDC starts the ADRS run after each consumer transaction. If a consumer inserts his card, the application waits as long as a previous ADRS run has been finished. In error situations (cash dispenser time-outs, or shutter jams, dispenser resets, etc.) the waiting time to finish the ADRS run can cause a long delay time to the next FDK selection or PIN entry screen for a customer that has already inserted his card. Parameter names: ADRS_OPTIONS Section in *.PPF: Valid range: [APPLICATION_XXX] 0 - 15
Value description: 0 - wait until previous ADRS run has been finsihed after a consumer has inserted a card (can cause a delay during consumer input) 1 - Do NOT wait for a previous ADRS run. Proceed with the consumer transaction with the risk that the delay happens (through a dispenser problem) after the transaction reply has been received and a dispense function has been initiated. 2 - Do NOT allow a consumer transaction if after a previous ADRS run a cash dispenser error has not been repaired. Display OOS screen in this phase if the dispenser is still not operational. Repeat the ADRS run as long as the dispenser is not repaired. If the dispenser is again operational, stop ADRS run and allow further consumer transactions. 4 - Run ADRS additionally in Out of Service mode. This option can be ORed together with one of the other options. 8 - Run ADRS in OpenCustomerService() to force ADRS after SOP exit or if the ATM mode changes from offline to online and previous mode was In Service or the host sends a Go In Service command. This option can be ORed together with one of the other options.
Default value:
July 2011
181
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: 0 - 3 retries during in service mode (1 minute delay). >0 - number of repetitions the ADRS is repeated until the device is repaired. Default value: not configured in registry
Value description: 0 - Downloaded COM key is lost after system reboot. 1 - COM key is stored and available after system reboot. Default value: not configured - COM key is stored power secure
182
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: 0 - do not display card retain screen, if card is retained by the application (default). 1 - display retain screen if card was captured through the application and not by retain flage from host reply. Default value: not configured in registry
Value description: Bit order 0x01 -Allow print immediate in Supervisor mode 0x02 -Allow print immediate in In Service mode Default value: not configured in registry
July 2011
183
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: the parameter value consists of one or more Sensor definitions, where each Sensor definition is separated through a comma (,). Within each sensor definition, the mandatory and optional fields are separated through a colon (:):
POS 0 Optional Description Sensor number that represents the WOSA sensor type: Value Sensor Type 1 SIU_TAMPER 2 SIU_INTTAMPER 3 SIU_SEISMIC 10 SIU_INPUT1 11 SIU_INPUT2 12 SIU_INPUT3 13 SIU_INPUT4 X Device name that represents the device class that will be created in the Device Status Framework (dcDevsta.dll) Example: If you enter the name TAMPER_SENSOR, all device state changes will be assigned to this device name. The current sensor state can be received in method PREP_SENSOR_STATUS of the Message Control Framework (value: 1 = ON (alarm), 0 = OFF). Set opposite logic: If you append .1 after the device name the sensor status value is reported in the opposite way (value: 0 = ON (alarm), 1 = OFF). Example: TAMPER_SENSOR.1 Sensor State changes from OFF to ON (alarm active) and skimming device is connected (operational) 2 X 4 digit Journal (TOPMSG/CUSTMSG) message number. If configured the status change can be journalled to file or/and printer.
184
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
1. Specify StClass/StCodeDevStaDeviceName This field can be used to set a specific class and error code that can be set for a specific device name. If DeviceName is not specified, the device name of parameter position 1 is used. Example entry 1: 64340050 Example entry 2: 643A0060CCCdmFW Note: Please make sure that the error section exist in registry location: ..\Wincor Nixdorf\ProTopas\CurrentVersion\CCERRMAP 2. Specify DevstaDeviceName and Status The second option how to set this filed is to specify the device name and the the Status (Severity) that should be set for the current alarm state. The field consists of 3 dot separated fields. The first field is reserved and has to contain a bar (-), the second field specifies the device name and the third field specifies the status value. Example: -.CCCardFW.4
Name of the unsolicited message that should be sent in case if the sensor status has changed from OFF to ON Example: T2HUnsolicitedAlarmStateChange Sensor State changes from OFF to ON (alarm active) and the skimming device is disconnected or defective (ASKIM_STATE keyword is set in szExtras of XFS SIU30 service)
8 9
X X
4 digit Journal (TOPMSG/CUSTMSG) message number. If configured the status change can be journalled to file or/and printer. 1. Specify StClass/StCodeDevStaDeviceName This field can be used to set a specific class and error code that can be set for a specific device name. If DeviceName is not specified, the device name of parameter position 1 is used. Example entry 1: 64340050 Example entry 2: 643A0060CCCdmFW Note: Please make sure that the error section exist in registry location: ..\Wincor Nixdorf\ProTopas\CurrentVersion\CCERRMAP 2. Specify DevstaDeviceName and Status The second option how to set this filed is to specify the device name and the the Status (Severity) that should be set for the current alarm state. The field consists of 3 dot separated fields. The first field is reserved and has to contain a bar (-), the second field specifies the device name and the third field specifies the status value. Example: -.CCCardFW.4
10
Name of the unsolicited message that should be sent in case if the sensor status has changed from OFF to ON and the skimming device is disconnected or defective Example: T2HUnsolicitedAlarmStateChange
July 2011
185
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Sensor State changes from ON to OFF (alarm inactive) 5 6 X X 4 digit Journal (TOPMSG/CUSTMSG) message number. If configured the status change can be journalled to file or/and printer 1. Specify StClass/StCodeDevStaDeviceName This field can be used to set a specific class and error code that can be set for a specific device name. If DeviceName is not specified, the device name of parameter position 1 is used. Example entry 1: 64340050 Example entry 2: 643A0060CCCdmFW Note: Please make sure that the error section exist in registry location: ..\Wincor Nixdorf\ProTopas\CurrentVersion\CCERRMAP 2. Specify DevstaDeviceName and Status The second option how to set this filed is to specify the device name and the the Status (Severity) that should be set for the current alarm state. The field consists of 3 dot separated fields. The first field is reserved and has to contain a bar (-), the second field specifies the device name and the third field specifies the status value. Example: -.CCCardFW.4 7 X Name of the unsolicited message that should be sent in case if the sensor status has changed from ON to OFF Example: T2HUnsolicitedAlarmStateChange
186
July 2011
[APPLICATION_XXX][1]
"1:TAMPER_SENSOR:2000:-.CCCardFW.4:T2HUnsolicitedAlarmStateChange, 10:INPUT_SENSOR1:2001:-.CCCardFW.0:T2HUnsolicitedMyOwnDefinedMessage"
Example3:
"1:TAMPER_SENSOR:2000:64340050:T2HUnsolicitedAlarmStateChange, 10:INPUT_SENSOR1:2001:64340051:T2HUnsolicitedMyOwnDefinedMessage"
Example4:
"1:TAMPER_SENSOR:2000:643A0060CCCdmFW:T2HUnsolicitedAlarmStateChange, 10:INPUT_SENSOR1:2001:643A0061CCCdmFW:T2HUnsolicitedMyOwnDefinedMessage"
Anti Skimming module connection on Wincor ATMs: The Anti Skimming module is connected to contact "Reserve In 2" of the special electronic. For activation of this sensor, following registry parameter settings are required: [HKEY_LOCAL_MACHINE\SOFTWARE\Wincor Nixdorf\CSC-W32\CurrentVersion\CSCSEL] "RSRVI2"="ANTI_SKIMMING" "MAGDOOR3"="ANTI_SKIMMING" Alternatively: Card reader mouthpiece connection on Wincor ATMs: As an alternative solution to the anti skimming module, a specific mouthpiece can be connected to the "Reserve In 2" contact of the special electronic. For activation of this sensor, following registry parameter settings are required: [HKEY_LOCAL_MACHINE\SOFTWARE\Wincor Nixdorf\CSC-W32\CurrentVersion\CSCSEL] "RSRVI2"="ID_ENTRY" ProDevice (WOSA) uses sensor type WFS_SIU_TAMPER (1) for status indication. Please refer to "Generation Tools" User Guide CSC-W32 2.1/80 or higher for detailed information. Refer also to ProDevice CEN document "Part 10: Sensors and Indicators Unit Device Class Interface" and "Part4: Identification Card Device Class Interface".
Note:
If WOSA parameter "CheckSkimming" is configured in section HKEY_CLASSES_ROOT\WOSA/ XFS_ROOT\PHYSICAL_SERVICES\SSI and skimming is active, a running card insert job will be cancelled. The card reader state is set to not operational and an unsolicited card reader message with a fatal status is sent to the host.
Anti Skimming module defective detection on Wincor ATMs: Since release 2.1/10 the ALARM_SENSORS parameter can be configured with POS 8-10. Refer to the table of the Value description. POS 8-10 can be used if the application should react on disconnect conditions of the Skimming Module. The disconnect condition will be detected through the next alarm ON event. This feature is supported for XFS sensor type SIU_TAMPER only. Dependency on XFS: $MOD$ 110401 5112 PSSIU30.DLL 3.10 or higher The PSSIU30 service sets keyword ASKIM_STATE with an 8 digit hex value that reflects the status bits of the skimming interface. Example: ASKIM_STATE = 0x01000051
Example4:
The following just configures the applicationn reactions on disconnect: "ALARM_SENSORS"="1:MY_SENSOR:::::::2011:64340048.CCCardFW.4:T2HUnsolicitedMySkimming" Note: For the journal log entry, variable expression $DCVAR_APPL_ASKIM_STATE$ can be used, if the ASKIM_STATE value should be logged.
July 2011
187
Parameters in CUSTOM.PPF
The following table describes the "Active" and "Inactive" status that is set as initial status after application start, depending on how the current status of the XFS sensor device is set. Depending on the "ALARM_SENSORS" parameter configuration, an unsolicited alarm message can be sent under following conditions described in the table.
WOSA XFS Sensor Type SIU_TAMPER ( 1) SIU_INTTAMPER (2) SIU_SEISMIC (3) SIU_INPUT1 (10) SIU_INPUT2 (11) SIU_INPUT2 (12) SIU_INPUT2 (13)
dcDevSta Sensor Status INACTIVE (0) INACTIVE (0) INACTIVE (0) INACTIVE (0) INACTIVE (0) INACTIVE (0) INACTIVE (0)
dcDevSta Sensor Status (negative) ACTIVE (1) ACTIVE (1) ACTIVE (1) ACTIVE (1) ACTIVE (1) ACTIVE (1) ACTIVE (1)
Example1: SIU_INPUT1
ALARM_SENSORS = "10:INPUT_SENSOR1:2000::T2HUnsolicitedOnMessage,2001::T2HUnsolicitedOffMessage" Description: In case the SIU_INPUT status has status OFF, the journal message 2001 is generated and the unsolicited message "T2HUnsolicitedOffMessage" is sent to the host. If this message contains a device definition of a dcDevSta device, the Sensor Status is set depending on the configuration in POS 1 of the parameter.
Example2: SIU_TAMPER
ALARM_SENSORS = "1:INPUT_SENSOR1:2000::T2HUnsolicitedOnMessage,2001::T2HUnsolicitedOffMessage" Description: In case the SIU_TAMPER status has status ON, the journal message 2000 is generated and the unsolicited message "T2HUnsolicitedOnMessage" is sent to the host. If this message contains a device definition of a dcDevSta device, the Sensor Status is set depending on the configuration in POS 1 of the parameter.
Note:
If the negative option is configured, only the sensor status of the dcDevSta device is changed to the opposite status.
188
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: 0 - use state index 0 if receipt already delivered in the reply function (form feed (FF) included in printer data). Use state index 2 if receipt will be deliverd in the close state. 1 - use state index 0 only if receipt could be printed and delivered but not if reply DDC FID H or D is used in host reply. Default value: not configured in registry
Value description: 0 - use close timer only if the next state is a 000 state specified in the close state (J). 1 - use close timer always Default value: not configured in registry, default is 0
July 2011
189
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: Positive value: delay as long as the Transaction Request dialog returns, but maximum deleay as specified. Negative value: delay the specified time in any case Default value: not configured, default is 0
Value description: the value specifies the time in seconds how long the screen of FID Z should be displayed. Default value: not configured, delay time is 0
190
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: 0 - standard PAN handling 1 - specific PAN handling for ANSI PIN block. Use PANLN and PANDX. Skip field separator und take next PAN digits up to the number of digits specified by PANLN. Default value: not configured, use standard PAN handling
Value description: 0 - disable boot switch monitoring 1 - boot switch monitoring enabled Default value: not configured, (default = 1)
July 2011
191
[APPLICATION_XXX][1]
Parameters in CUSTOM.PPF
Value description: 0 - disable safe door monitoring 1 - enable safe door monitoring Default value: not configured, (default = 1)
Value description: 0 - connection attempts without delay 1 - 9999 delay time between each connection attempt Default value: not configured, (default = 0)
192
July 2011
Parameters in CUSTOM.PPF
[APPLICATION_XXX][1]
Value description: 0 - not configured 1 - 65535 delay time in seconds Default value: Important Note: not configured, (default = 0) Power Save Mode is supported only on CMD-V4 with firmware that supports ECO mode.
July 2011
193
Parameters in CUSTOM.PPF
CAS is supported with ProTopas/SOP-DDC. To use CAS, parameter SYNCHRONIZE_IMMEDIATE has to be set to "N" in configuration file CCSOPSTEP.INA. To set the default CAS screens in registry you have to call the batch routine CAS_SCR.BAT located in "C:\PROTOPAS\CONF".
194
July 2011
Parameters in CUSTOM.PPF
July 2011
195
Parameters in CUSTOM.PPF
196
July 2011
Parameters in CUSTOM.PPF
July 2011
197
Parameters in CUSTOM.PPF
Value description: 0 - Do not check CAS for deposit module within a withdrawal transaction. 1 - Check CAS for deposit module within a withdrawal transaction. Default value: not configured - Check CAS for deposit module within a withdrawal transaction.
198
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
[CASH_DISPENSER]
Number of logical cassettes
This parameter specifies the number of logical cassettes. Parameter name: NUM_LOG_CASS Section in *.PPF: Valid range: [CASH_DISPENSER] 0-4 (for NDC); 0-8 (for DDC)
Value description: integer value sets the number of logical cassettes. Default value: 0
X represents the logical cassette position from 1 to 4 for NDC and up to 8 for DDC, where 1 - 8 are assigned to denomination A - H.
July 2011
199
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
X represents the logical cassette position from 1 to 4 for NDC and up to 8 for DDC, where 1 - 8 are assigned to denomination A - H.
Value description: represents the number of notes loaded count. Default value: [1]
X represents the logical cassette position from 1 to 4 for NDC and up to 8 for DDC, where 1 - 8 are assigned to denomination A - H.
200
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
[CASH_DISPENSER] 0 - 31
4 8 16
Default value:
July 2011
201
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: initial number of notes for each cassette which is logged on Default value: 0
The initial configured counter is ignored if the actual counter of the cassette has a higher value.
This parameter should be used only if the host and operators do not care about the local calculated cash counters. If a host or other ATM monitoring programs like ProAgent ask for the local counters they will get wrong cash counters.
202
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Value description: 0 - send message for each physical inserted cassette 1 - send low message only if the whole denomination becomes low [1]. Default value: DDC: 0, NDC: not configured
[1] - If in a DDC environment parameter SEND_CASSETTE_LOW_ALWAYS is not configured, the low message is sent after each transaction. If you like to send the low message only once, you have to configure SEND_CASSETTE_LOW_ALWAYS = 0.
Value description: 0 - top to bottom algorithm 1 - empty cassettes equally Default value: 0
July 2011
203
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - cash counters remain after cassettes removal 1 - cash counters are set to zero after cassettes removal Default value: 0
The cash counters for removed cassettes in the SOP functions are still available !!
204
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Value description: 0 1-
2-
4 -
8 -
12 -
Default value:
DDC: not configured NDC: 1 - send low message after each transaction
July 2011
205
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - Counting of money present errors disabled >0 - After how many times the application should stop the dispense operation if it has received the same error in the money present operation of previous cash out transactions. Default value: 0 - Counting of money present errors disabled
206
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Value description: number of dispense errors after the cash dispenser will be set to fatal (severity 4) Default value: not configured in registry, internal default is 10
July 2011
207
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - Send transaction ready immediately when presenting the cash. Send unsolicited status message after cash retract if the money was not taken by the consumer during the time-out period. 1 - Send ready after money has been taken. Send solicited message after cash present consumer time-out. Default value: not set in registry
Value description: 0 - Retract is initiated by the terminal after present timeout. After retract the terminal generates a solicited message. 1 - Retract is NOT initiated by the terminal, but a solicited message is sent to the host and the terminal waits for a new host function command message. Default value: not configured in registry
208
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Value description: 0 - Disabled, send lower case denomination ID in solicited cash dispenser status message for fatal cassettes. 1 - Enabled, send missing denomination ID @ in solicited cash dispenser status message for fatal cassettes. Missing status also effects to Hardware Configuration status and Enhanced Supply Counters status message. Default value: Disabled, not configured in registry.
July 2011
209
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - Dispense below zero disabled. Do not use any more those cassettes where the counter "Number of notes remaining in cassette" has reached zero. 1 - Dispense below zero enabled. Allow dispensing for those cassettes which have still money available in the cassette, but cash counter is < 0. Default value: 0 - Dispense below zero disabled.
Default value:
210
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
ProCash/DDC
If this parameter is enabled, following standard protocol characteristics of ProCash/DDC are changed: Cassettes in sol./unsol. cash dispenser device fault messages are reported in logical order as configured in ..\LYNXPAR\CASH_DISPENSER and NOT as physically inserted. The available cassettes, which will be assigned to a logical type are searched from top to bottom. Physical cassettes that are not configured as a logical type are skipped. Only the first 4 physical cassette types (top to bottom search) that match with the configured logical types are taken. Remaining physical cassettes are ignored. The 912 cassette specific dispense error code will be calculated in logical order. The four denomination IDs in the Hardware Configuration message are reported in logically. Cassettes supply counters in Supply Counters and Enhanced Supply Counters messages are sent in logical order (four logical types only).
ProCash/NDC
For ProCash/NDC following characteristics are changed: TI Sensor messages of the cassettes are reported logically and NOT as physically inserted. If multiple physical cassette types are assigned to one logical type, the sensor status changes only from IN to OUT if all physical cassettes of the same type are removed. Parameter name: LOGICAL_MAPPING Section in *.PPF: Valid range: [CASH_DISPENSER] 0, 1
Value description: 0 - Logical mapping off (4 or less cassettes) 1 - Logical mapping on (needed on 6 cassettes ATMs) Default value: not configured - Logical mapping off (4 or less cassettes)
July 2011
211
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - shutter status check is OFF after money was taken 1 - shutter status check is ON after money was taken Default value: not configured, shutter status check is ON
Value description: 0 - send always lower case letters for cassettes it cannot be dispensed from, even the supply is GOOD. 1 - send lower case letters only if the supply status of a cassette is LOW or OUT. Default value: not configured, send always lower case letters for cassettes that have dispense problems.
212
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Value description: 0 - perform synchrous retract and send solicited message, but do NOT display an additional screen. 010 - 999 - behaviour as value 0 and display the configured screen. Default value: not configured, perform the retract operation asynchronously without sending a device status message.
Value description: 0 - "TAKE CASH" screen is displayed when money is accessible after present. 1 - "TAKE CASH" screen is shown before the present is issued Default value: not configured, default is 0
July 2011
213
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - leave status of device Cash dispenser unchanged 1 - set device Cash dispenser to severity 4 (fatal) Default value: not configured
214
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Dispense retries
This parameter can be used to specify how many dispense retries should be performed if the dispense function returns with an error. Parameter name: DISPENSE_RETRIES Section in *.PPF: Valid range: [CASH_DISPENSER] 0 - 99
Value description: 0 - no retries, one dispense call only >0 - set number of dispense retries Default value: not configured, 4 dispense tries is done by default
Value description: 0 - no retries, one dispense call only >0 - set number of dispense retries Default value: not configured, 3 retries is done by default
Example: Assume parameter DISPENSE_RETRIES is set to 5 and HWERR_DISPENSE_RETRIES is set to 1. In case the dispense operation returns with HARDWARE_ERROR (-14) the dispense operation stops after the first retry. If HWERR_DISPENSE_RETRIES is not set, 5 dispense retries would be done.
July 2011
215
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - no exponent correction, the value from WOSA is used 1 - exponent value will be adjusted for NDC and DDC Default value: 1
Value description: -1
0 1 - 99 Default value: -1
216
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Value description: time in seconds at what time a single dispense operation should return. The value n should be greater than the line communication time-out timer specified in the CSC-W32 layer. Default value: not configured
July 2011
217
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: 0 - retract logging off 1 - retract logging on, optionally recycling on RM3 Default value: 1
Enable Retract Recycling on RM3: The following parameter has to be set in PROBASE.CUS:
prodevice.spec30.CRS30.retractRecycleModeCashOut = ALL_OR_NOTHING
Dependency: If retract recycling is enabled on ProCash/NDC you have to set parameter SEND_SOL_RETRACT = 1 in CUSTOM.PPF.
218
July 2011
Parameters in CUSTOM.PPF
[CASH_DISPENSER]
Value description: integer value sets the money low limit. Default value: 50
Number of maximum bills to be rejected This WOSA parameter specifies how many bills are allowed to be stored in the rejected cassette. If the limit has been reached, the WOSA status of the reject cassette changes to WFS_CDM_STATCUFULL (overfilled). Parameter name: REJECTCASSFULL Section in *.WN: Valid range: [CDM30] 0 - 9999
Value description: specifies how many bills are allowed to be rejected Default value: 0 - value not checked, rejects allowed up to physical limit
July 2011
219
[CASH_DISPENSER]
Parameters in CUSTOM.PPF
Value description: integer value sets the money low limit. Default value: 50
If you want change the value after installation it is very important to delete the file C:\WOSASSP\CONF\CASSDATA.BIN. After that you have to do a new init of all cassettes via SOP.
Number of maximum bills to be rejected This WOSA parameter specifies how many bills are allowed to be stored in the rejected cassette. If the limit has been reached, the WOSA status of the reject cassette changes to WFS_CDM_STATCUFULL (overfilled). Parameter name: REJECTCASSFULL Section in *.WN: Valid range: [CASH_DISPENSER] 0 - 9999
Value description: specifies how many bills are allowed to be rejected Default value: 0 - value not checked, rejects allowed up to physical limit
220
July 2011
[CASH_DISPENSER]
This parameter specifies how many cash retracts can be performed by the cash dispenser. If the specified limit has been reached the dispenser will be locked. Parameter name: MAXRETRACT Section in *.WN: Valid range: [CASH_DISPENSER] -1; 0 - 99 sets defined number of retracts (hardware dependent). The money of the second retract remain on the stacker. On ProCash Compact ATMs without a retract tray the number of allowed retracts is one. The money remains on the stacker area and has to be removed manually by the operator. no retract operations number of retracts allowed
Value description: -1
0 1 - 99 Default value: -1
This parameter is just an initial value after installation for the first time when the application will be started and the WOSA data file C:\WOSASSP\CONF\CASSDATA.BIN does not exist. NOTE: After installation the change of this value is only allowed via SOP function.
July 2011
221
[COIN_DISPENSER]
Parameters in CUSTOM.PPF
[COIN_DISPENSER]
Number of coin hoppers
This parameter specifies the maximum number of coin hoppers available for the application to use, when the host requests for a coin dispense. Parameter name: NUM_LOG_HOPPERS Section in *.PPF: Valid range: [COIN_DISPENSER] 0-4 (for NDC); 0-8 (for DDC)
Value description: integer value sets the number of logical coin hoppers. Default value: 0
Value description: represents the currency of one coin hopper in the specified position. Default value: [1] .
X represents the coin hopper position from 1 to 4 for NDC and up to 8 for DDC, where 1 - 8 are assigned to denomination A - H.
222
July 2011
Parameters in CUSTOM.PPF
[COIN_DISPENSER]
X represents the logical cassette position from 1 to 4 for NDC and up to 8 for DDC, where 1 - 8 are assigned to denomination A - H.
Value description: 0 - no option set 1 - always try to dispense coins even if only partial dispense is possible 2 - Dispense from coin hoppers with status LOW. 4 - Dispense from coin hoppers where the minimum coin threshold is not specified. This threshold can be configured via XFS parameter MINIMUMITEMS of section COUT30 in CUSTOM.WN The values are optional bits and can be set in any combination as required Default value: 2 - Dispense from coin hoppers with status LOW
July 2011
223
[COIN_DISPENSER]
Parameters in CUSTOM.PPF
Value description: integer value sets the number of logical coin hoppers. Default value: not configured (use 4 by default)
224
July 2011
Parameters in CUSTOM.PPF
[DEPOSIT]
[DEPOSIT]
Options to dispense envelopes
This parameter is used to specify when an envelope should be dispensed to the customer. Envelopes can be either dispensed during the envelope "C" state or later when the terminal has received the deposit transaction reply function. In combination to the dispense options you can configure specific screens via parameter DISPENSE_SCREEN (see description on the next page) that can be displayed during the envelope dispense operation. In addition this parameter can be used to disable the envelope dispenser device. Parameter name: DISPENSE_ENVELOPE Section in *.PPF: Valid range: [DEPOSIT] 0, 1, 2, 3 Dispense envelope in deposit host reply function. Dispense envelope in "C" state. dispense envelope in "C" state but not in reply function. Disable envelope dispenser device. Envelopes will not be dispensed and envelope dispenser status messages are not sent.
Default value:
Refer to parameter description of parameter DISPENSE_SCREEN Abschnitt Screen to be displayed during envelope dispense on page 226.
July 2011
225
[DEPOSIT]
Parameters in CUSTOM.PPF
Value description: The following table illustrates the behavior of dispensing envelopes in combination with parameter DISPENSE_ENVELOPE and parameter DISPENSE_SCREEN.
O[1]
0
S[2]
""
DESCRIPTION
Envelope will be dispensed in deposit reply function. No specifc screen will be displayed. Typically the "Please Wait" screen of the transaction request state remains displayed. Envelope will be dispensed in deposit reply function. Screen of host reply function is displayed Envelope will be dispensed in deposit reply function. Displays specific screen "nnn" instead of downloaded screen defined in the deposit transaction reply function. Envelope is dispensed asynchronously during processing the "C" state, no specifc screen is displayed but state flow continues. Envelope is dispensed during processing the "C" state but state flow continues and screen of host reply function will be displayed if the envelope was not already taken. Envelope is dispensed during processing the "C" state, but state flow continues. Displays a specific screen "nnn" in deposit reply function if the envelope was not already taken by the customer. Envelope is dispensed asynchronously during processing the "C" state, no specifc screen is displayed but state flow continues (behaviour as option 1). Envelope is dispensed during processing the "C" state but state flow continues and screen of host reply function is displayed (behaviour as option 1). Envelope is dispensed during processing the "C" state, displays specific screen "nnn" and waits until the envelope has been taken during processing the "C" state. State flow continues when the envelope has been taken or captured after timeout. Envelopes will not be dispensed and no screen is displayed
0 0
HOST nnn
1 1 1
2 2 2
---
[1] = value of parameter DISPENSE_ENVELOPE [2] = value of parameter DISPENSE_SCREEN Default value: ""
226
July 2011
Parameters in CUSTOM.PPF
[DEPOSIT]
Value description: specifies the screen number of the screen that should be displayed during an envelope dispense. Default value: not configured
Value description: 0 - no, deposit transaction cannot be canceled 1 - yes, deposit transaction can be canceled Default value: 1
July 2011
227
[DEPOSIT]
Parameters in CUSTOM.PPF
Value description: 0 - do not print on retracted envelopes 1 - print data on retracted envelopes Default value: not configured, data on retracted envelopes will be printed.
Value description: you can use the same character definition as for receipt, journal or document printers (defined in CUSTOM.PPF). Default value: not configured
228
July 2011
Parameters in CUSTOM.PPF
[DEPOSIT]
Value description: 0 - no entry splitting, job returns when envelope is in safe 1 - entry splitting enabled, job returns immediately when the envelope has been inserted. Default value: 0 - no entry splitting
Value description: 0 - prepare dispense OFF 1 - prepare dispense ON Default value: 0 - prepare dispense OFF
July 2011
229
[CARD_READER]
Parameters in CUSTOM.PPF
[CARD_READER]
Default track read definitions
The following parameters are used to set which ID card tracks should be preread after the card has been inserted independent of settings defined in the Card Read State (A or T). Parameter names: DEFAULT_READ_TRACK1 DEFAULT_READ_TRACK2 DEFAULT_READ_TRACK3 Section in *.PPF: Valid range: [CARD_READER] 0, 1
Value description: 0 - pre-read off; 1 - pre-read on Default values: DEFAULT_READ_TRACK1 = 0 DEFAULT_READ_TRACK2 = 0 DEFAULT_READ_TRACK3 = 0
Value description: 0 - read chip data only if specified in the read conditions of the Card Read State. 1 - after card insertion read chip data in any case. (not supported for NCR smart DIP readers) 2 - contact chip, but do not read magnetic track data on insertion. Default values: not configured - read chip data only if specified in the read conditions of the Card Read State.
230
July 2011
Parameters in CUSTOM.PPF
[CARD_READER]
Value description: zero value - wake up after half eject time positive values - time after eject timer start negative values - time before eject timer end Default value: 0
For DIP readers this wake up function has to be switched off (value 9999), because insert/eject operations with a remaining card in a DIP reader will cause undefined error situations
Value description: screen number of screen to be displayed Default value: "" - no separate screen is not displayed
July 2011
231
[CARD_READER]
Parameters in CUSTOM.PPF
Value description: 0 - tracks are read during insert (motorized readers) 1 - tracks are read during removal (SWIPE readers)
Value description: 0 - application goes immediately OOS if the card reader is not operational. >0 - sets the number of reset retries before the application goes OOS Default: 0 - not configured
232
July 2011
Parameters in CUSTOM.PPF
[CARD_READER]
Value description: sets a jam threshold, an unsol. message will be sent when the threshold is exceeded. Default: 0 - not configured, unsolicited message will never be sent
Value description: specifies the screen that is displayed in the described situation Default: "" - not configured
July 2011
233
[BARCODE]
Parameters in CUSTOM.PPF
[BARCODE]
The following parameters are used to set up the barcode reader.
Value description:
234
July 2011
Parameters in CUSTOM.PPF
[OPERATOR_SCREENS]
[OPERATOR_SCREENS]
Printer header for Operator screens
These parameters can be used to set predefined macro sequences as a header for operator screens of the SOP user exit functions to be printed on the journal or/and receipt printer. This permits the setting of a special CPI or/and LPI size and additional presettings for the operator screens Parameter names: PRINTER_HEADER_RECEIPT PRINTER_HEADER_JOURNAL PRINTER_HEADER_DOCUMENT Section in *.PPF: Valid range: [OPERATOR_SCREENS] valid macro sequences or/and text
Value description: the macro sequences must be available by CSCW32 and be supported by the printer. Default value: #NCT##CPI15##LPI6# (Sets standard character set, CPI15 and LPI6)
If the parameter(s) does/do not exist in the registry, the default setting is CPI15 and LPI6. If the parameter(s) is/are empty the last actual setting is used.
July 2011
235
[JOURNALPRINTER]
Parameters in CUSTOM.PPF
[JOURNALPRINTER]
Set journal destination on paper
This parameter is used to set the journal output on paper of the journal printer. This parameter has to be set to zero if no journal printer is physically connected and not configured in the registry. Parameter name: PAPER_JOURNAL Section in *.PPF: Valid range: [JOURNALPRINTER] 0, 1
Value description: 0 - Printing on journal printer disabled 1 - Printing on journal printer enabled Default value: 1 - Printing on journal printer enabled
Value description: integer value sets number of characters per inch Default value: 15
Value description: integer value sets number of lines per inch Default value: 236 6 July 2011
Parameters in CUSTOM.PPF
[JOURNALPRINTER]
Double Width
This parameter is used to specify if the printer should print the characters in double width by default. Parameter names: DOUBLE_WIDTH Section in *.PPF: Valid range: [JOURNALPRINTER] 0, 1
Condensed Print
This parameter is used to specify if the printer should print the characters in condensed mode by default. Parameter names: CONDENSED Section in *.PPF: Valid range: [JOURNALPRINTER] 0, 1
July 2011
237
[JOURNALPRINTER]
Parameters in CUSTOM.PPF
Electronic journal
This parameter is used to set the electronic journal log destination for host print data. Depending on the setting of the parameters TOP_JOURNAL_PATH and CUST_JOURNAL_PATH in section [ELECTRONIC_JOURNAL], the host print data can be stored optional into the journal files of the specified path locations. Parameter name: ELECTRONIC_JOURNAL Section in *.PPF: Valid range: [JOURNALPRINTER] 0-3
Value description: 0 - no logging of host print data 1 - log host print data to TOPMSG destination 2 - log host print data to CUSTMSG destination 3 - log host print data to both destinations Default value: 0 - no electronic journal log
Value description: 0 - send original journal printer error message 1 - send spooler active message Default value: not configured - send spooler active message
238
July 2011
Parameters in CUSTOM.PPF
[JOURNALPRINTER]
Value description: 0 - The printer highest severity condition is WARNING (2) and highest supply condition is LOW (2). 1 - use original journal printer severity and supply status. Fall down to FATAL (4) and supply OUT (3) Default value: not configured
Value description: 0 - send printer error to the host only if the journal print job fails. 1 - send paper out message on paper out supply status. Default value: not configured - send printer error to the host only if the journal print job fails.
July 2011
239
[JOURNALPRINTER]
Parameters in CUSTOM.PPF
Value description: NDC font type character, which is already, or has to be new specified via parameter JOURNAL_FONT_TYPE in the JOURNAL_FONT_XXX [2] section. Refer to Abschnitt Font type on page 258. [1] NNN represents the codepage number specified via ESC% [2] XXX represents the font section number
Example: Assume ESC%850 is included in the host print data for the journal printer. If you specify CP_JOURNAL_FONT_TYPE_850 = "2", all font parameters in the JOURNAL_FONT_XXX section are selected where parameter setting JOURNAL_FONT_TYPE = "2" is found.
Value description: 0 - print journal host data through function ID 1 - print journal host data prior function IDs Default value: not configured, print journal host data through function ID.
240
July 2011
Parameters in CUSTOM.PPF
[JOURNALPRINTER]
Value description: hard disk free space low threshold. If the value is zero, the hard disk space is not checked. Default value: not configured, hard disk free space is not checked.
Value description: 0 - do not send unsolicted messages if file writing fails 1 - send unsolicited journal message if journal data cannot be stored into the file. Default value: not configured - do not send journal error messages
July 2011
241
[JOURNALPRINTER]
Parameters in CUSTOM.PPF
Value description: specifies the path and filename for EJU or SAF. Important Note: Please make sure that all sub directories exist if the file will be configured in a sub folder of the hard disk. Default value: Example entry: not configured - EJU or SAF disabled C:\JOURNAL\EJU_SAF.JRN
Value description: specifies the file size in kilobytes plus additional 5 KB header size. Default value: not configured - size 0, EJU or SAF disabled
242
July 2011
Parameters in CUSTOM.PPF
[JOURNALPRINTER]
Value description: 0 - NCR conversion off (default) 1 - NCR conversion on Default value: not configured
Value description: 0 - character range 20-7F hex (default) 1 - extended character range 20-FF hex Default value: not configured
July 2011
243
[ELECTRONIC_JOURNAL]
Parameters in CUSTOM.PPF
[ELECTRONIC_JOURNAL]
Maximum journal files
These two parameters are used to specify the journal file creation cycle for the TOPMSG and CUSTMSG journal files. It specifies for how many days a new journal file should be new created. (Note: These parameters replace PPF parameter MAX_JOURNAL_FILES (registry parameter MAX_JFILES)). Parameter names: TOP_MAX_FILES CUST_MAX_FILES Section in *.PPF: Valid range: [ELECTRONIC_JOURNAL] 0 - 549 (maximum 1.5 years)
Value description: The string can contain valid printer macros or single ASCII characters in range 20H - 7FH. Default value: ""
The following example entry initialize the journal printer with CPI15 and LPI8 during a printer reset initiated by the journal spooler framework. Example: SPOOLER_RESET = "#CPI15##LPI8#"
244
July 2011
Parameters in CUSTOM.PPF
[ELECTRONIC_JOURNAL]
Value description: time in what cycle the spooler checks if spooler data exist Default value: 2
Value description: number of collected print jobs before the spooler starts printing Default value: 10
Value description: spool file size in kilobytes Default value: not configured - size of 2000 kilobytes is used
July 2011
245
[ELECTRONIC_JOURNAL]
Parameters in CUSTOM.PPF
Value description: unprinted spool data size in kilobytes Default value: not configured - size of 1000 kilobytes is used
246
July 2011
Parameters in CUSTOM.PPF
[RECEIPTPRINTER]
[RECEIPTPRINTER]
Receipt printer CPI setting
This parameter is used to set the CPI size for the receipt printer. Parameter name: CPI Section in *.PPF: Valid range: [RECEIPTPRINTER] 8, 10, 12, 15, 17, 25
Value description: integer value sets number of characters per inch Default value: 15
Value description: integer value sets number of lines per inch Default value: 6
Value description: 0 - standard character set; 1 - user defined character set Default value: 0
July 2011
247
[RECEIPTPRINTER]
Parameters in CUSTOM.PPF
Double Width
This parameter is used to specify if the printer should print the characters in double width by default. Parameter names: DOUBLE_WIDTH Section in *.PPF: Valid range: [RECEIPTPRINTER] 0, 1
Condensed Print
This parameter is used to specify if the printer should print the characters in condensed mode by default. Parameter names: CONDENSED Section in *.PPF: Valid range: [RECEIPTPRINTER] 0, 1
248
July 2011
Parameters in CUSTOM.PPF
[RECEIPTPRINTER]
Value description: macros and characters can be used as init sequences or to print header lines in front of the host print data. Default value: Example: The following entry sets Variable Receipt length (macro #VLM#) and two Line Feeds (macro #LF#) for every receipt. RECEIPT_PAGE_HEADER = #VLM##LF##LF# no value
Value description: appends or inserts print data or macros to the print raw data stream of host print data. Default value: not configured
July 2011
249
[RECEIPTPRINTER]
Parameters in CUSTOM.PPF
Value description: specifies the line where the footer will be appended. Default value: not configured
Value description: number of time in milli seconds the guide light is blinking on receipt eject. Default value: 5000 - blinking time of 5 seconds
250
July 2011
Parameters in CUSTOM.PPF
[RECEIPTPRINTER]
Value description: enables host and R01 data merging via software algorithm. Default value: not configured
Value description: NDC font type character, which is already, or has to be new specified via parameter RECEIPT_FONT_TYPE in the RECEIPT_FONT_XXX [2] section. Refer to Abschnitt Font type on page 258. [1] NNN represents the codepage number specified via ESC% [2] XXX represents the font section number
Example: Assume ESC%850 is included in the host print data for the receipt printer. If you specify CP_RECEIPT_FONT_TYPE_850 = "2", all font parameters in the RECEIPT_FONT_XXX section are selected where parameter setting RECEIPT_FONT_TYPE = "2" is found.
July 2011
251
[RECEIPTPRINTER]
Parameters in CUSTOM.PPF
Value description: 0 - do not append formfeed (FF). 1 - append formfeed (FF) to host printer data for each host reply. Default value: 0
Value description: 0 - send printer error to the host only if the receipt print job fails. 1 - send paper out message on paper out supply status. Default value: not configured - send printer error to the host only if the receipt print job fails.
252
July 2011
Parameters in CUSTOM.PPF
[RECEIPTPRINTER]
Value description: The bit options can be set in any combination you like. Default value: not configured - all options are off
July 2011
253
[DOCUMENTPRINTER]
Parameters in CUSTOM.PPF
[DOCUMENTPRINTER]
Document printer CPI setting
This parameter is used to set the CPI size for the document printer. Parameter name: CPI Section in *.PPF: Valid range: [DOCUMENTPRINTER] 8, 10, 12, 15, 17, 25
Value description: integer value sets number of characters per inch Default value: 15
Value description: integer value sets number of lines per inch Default value: 6
Value description: 0 - standard character set; 1 - user defined character set Default value: 0
254
July 2011
Parameters in CUSTOM.PPF
[DOCUMENTPRINTER]
Double Width
This parameter is used to specify if the printer should print the characters in double width by default. Parameter names: DOUBLE_WIDTH Section in *.PPF: Valid range: [JOURNALPRINTER] 0, 1
Condensed Print
This parameter is used to specify if the printer should print the characters in condensed mode by default. Parameter names: CONDENSED Section in *.PPF: Valid range: [JOURNALPRINTER] 0, 1
Value description: macros and characters can be used as init sequences or to print header lines in front of the host print data. Default value: no value
July 2011
255
[DOCUMENTPRINTER]
Parameters in CUSTOM.PPF
Value description: appends or inserts print data or macros to the print raw data stream of host print data. Default value: not configured
Value description: specifies the line where the footer will be inserted. Default value: not configured
256
July 2011
Parameters in CUSTOM.PPF
[DOCUMENTPRINTER]
Value description: specifies how many documents can be collected in the collection tray prior to delivery. Default value: 10
July 2011
257
Parameters in CUSTOM.PPF
Font type
This parameter is used to specify which NDC or DDC font type should be used for this font section Parameter names: JOURNAL_FONT_TYPE RECEIPT_FONT_TYPE DOCUMENT_FONT_TYPE Section in *.PPF: [JOURNAL_FONT_XXX] [1] [RECEIPT_FONT_XXX] [DOCUMENT_FONT_XXX] 1, 2, >, ?, 7, B (NDC) 1, A, V, X, S, Y (DDC)
Valid range:
258
July 2011
Parameters in CUSTOM.PPF
The following tables show what Font type is used by ProNDC or ProDDC depending on which character set is selected by the NDC or DDC protocol:
Font type 1 2 7 > ? B Character set defined by NDC Single Alpha 1 Single Alpha 2 Single Alpha 3 Double Alpha 1 Double Alpha 2 Double Alpha 3 Sequence ESC(1 ESC(2 ESC(7 ESC(> ESC(? ESC(B
Font type 1 A V X S Y
Character set defined by DDC Standard char set Alternate (user) char set VT chars from standard char set VT chars from alternate (user) char set Second alternate (user) char set VT chars from second alternate (user) char set
July 2011
259
Parameters in CUSTOM.PPF
Double Width
This parameter is used to specify if the printer should print the characters in double width for the selected font. Parameter names: JOURNAL_DOUBLE_WIDTH RECEIPT_DOUBLE_WIDTH DOCUMENT_DOUBLE_WIDTH Section in *.PPF: [JOURNAL_FONT_XXX] [1] [RECEIPT_FONT_XXX] [DOCUMENT_FONT_XXX] 0, 1
Valid range:
Value description: 0 - Double Width off, 1 - Double width on, 2 - unchanged [1] XXX represents the font section number from 001-006
Condensed Print
This parameter is used to specify if the printer should print the characters in condensed mode for the selected font. Parameter names: JOURNAL_CONDENSED RECEIPT_CONDENSED DOCUMENT_CONDENSED Section in *.PPF: [JOURNAL_FONT_XXX] [1] [RECEIPT_FONT_XXX] [DOCUMENT_FONT_XXX] 0, 1
Valid range:
Value description: 0 - Condensed off, 1 - Condensed on, 2 - unchanged [1] XXX represents the font section number from 001-006
260
July 2011
Parameters in CUSTOM.PPF
Valid range:
Value description: 0 - print from standard character set 1 - print from user defined character set 2 - unchanged, stay in current character set [1] XXX represents the font section number from 001-006
Valid range:
Value description: Character string that will be inserted in front of the print data. The character string can be one or multiple macros or/and additional text. [1] XXX represents the font section number from 001-006
July 2011
261
Parameters in CUSTOM.PPF
Value description: low and high part of the character table can have a maximum of 127 hex values which represents 127 characters. Each character position can be defined in the range from (00H-FFH) [1] XXX represents the font section number from 001-006
262
July 2011
Parameters in CUSTOM.PPF
Value description: specifies the Windows printer name Default value: ""
Value description: specifies the Windows printer name Default value: ""
July 2011
263
Parameters in CUSTOM.PPF
[VIEWER_FONT]
Number of screen fonts
This parameter specifies the number of fonts to be used by ProCash/NDC. Parameter name: TABLE_ENTRIES Section in *.PPF: Valid range: [VIEWER_FONT] 0, 9
Font name
The following parameter is used to specify the NDC or DDC font name which is used by ProCash/NDC or ProCash/DDC. Parameter name: NAME Section in *.PPF: Valid range: [VIEWER_FONT_XXX] [1] char value eight digits maximum in uppercase letters. This name has to match exactly with the name specified within the Windows font file (*.FON).
Value description: NDC or DDC font name Default values: [1] See table Default NDC font names and table Default DDC font names
See default settings of table Default NDC font names and table Default DDC font names on the next page.
264
July 2011
Parameters in CUSTOM.PPF
Table 16: Default NDC font names
SECTION [VIEWER_FONT_001] [VIEWER_FONT_002] [VIEWER_FONT_003] [VIEWER_FONT_004] [VIEWER_FONT_005] [VIEWER_FONT_006] [VIEWER_FONT_007] [VIEWER_FONT_008] [VIEWER_FONT_009] NAME NDC-SA1 NDC-DA1 NDC-SA2 NDC-DA1 NDC-G1 NDC-G2 NDC-G3 NDC-SARA NDC-DARA FONT FILE NAME NDC-SA1.FON NDC-DA1.FON NDC-SA2.FON NDC-DA1.FON NDC-G1.FON NDC-G2.FON NDC-G3.FON NDC-SARA.FON NDC-DARA.FON
[VIEWER_FONT]
NDC font description Single Alpha 1 Double Alpha 1 Single Alpha 2 Double Alpha 2 Graphic 1 Graphic 2 Graphic 3 Single Arabic Double Arabic
July 2011
265
[VIEWER_FONT]
Parameters in CUSTOM.PPF
Font size
The following parameter is used to specify the font size for NDC and DDC fonts in pixels. Parameter name: SIZE Section in *.PPF: Valid range: [VIEWER_FONT_XXX] [1] See table 18 and table 19 on page 267
Value description: font size in pixels. The value depends on the created font. The value for fixed size fonts has to match exactly with the size of the Windows font. Default values: [1] See table 18 and table 19 on page 268
Font height
The following parameter is used to specify the font size for NDC and DDC in pixels. Parameter name: HEIGHT Section in *.PPF: Valid range: [VIEWER_FONT_XXX] [1] See table 18 and table 19 on page 268
Value description: font height in pixels. The value depends on the created font. The value for fixed size fonts has to match exactly with the size of the Windows font. Default values: [1] See and on
266
July 2011
Parameters in CUSTOM.PPF
NAME DDC-NORM DDC-HELV DDC-ROLL DDC-ENGL DDC-CENT DDC-CHN4 DDC-CHN5 DDC-CHN6 DDC-CHN7 DDC-8X12 DDC-8X16 DDC-RUSS DDC-RUS4 DDC-THAI DDC-ARAB
July 2011
267
Parameters in CUSTOM.PPF
Table 19: NDC resolution dependent values for "SIZE" and "HEIGHT"
NAME NDC-SA1 NDC-DA1 NDC-SA2 NDC-DA1 NDC-G1 NDC-G2 NDC-G3 NDC-SARA NDC-DARA
The values of "SIZE" and "HEIGHT" will be automatically set during J/Install installation or if you register NT fonts via the "Configuration Manager". Refer to Abschnitt Resolution dependent WINNT Font installation on page 272.
268
July 2011
Parameters in CUSTOM.PPF
Value description: one character for NDC or two characters for DDC Default values: [1] See table Standard NDC and DDC font identifiers
See also ProCash/NDC and ProCash/DDC User Guide section Screens for detailed descriptions about screen control sequences.
July 2011
269
Parameters in CUSTOM.PPF
Value description: 0 - single, 1 - double Default values: [1] See table Default settings for NDC and DDC fonts
270
July 2011
Parameters in CUSTOM.PPF
Value description: 0 - proportional off, 1 - proportional on Default values: [1] 0 - proportional off
July 2011
271
Refer to section Font and Graphic utilities on page 380 for detailed description CPYNTFNT.EXE.
272
July 2011
Parameters in CUSTOM.PPF
IMPORTANT: Depending on the selected Display Resolution you have to set the correct SIZE and HEIGHT within the Windows fonts. See table DDC resolution dependent values for "SIZE" and "HEIGHT" on page 267 and table NDC resolution dependent values for "SIZE" and "HEIGHT" on page 268. The values of "SIZE" and "HEIGHT" in configuration file "CUSTOM.PPF" are set automatically via utility "CPYNTFNT.EXE". If you are using "FONTEDIT.EXE" you have to check the value of "Nominal Vert. Resolution" and "Nominal Horiz. Resolution" in menu "Fonts" function "Header". The value must be 96 for all resolutions.
July 2011
273
Parameters in CUSTOM.PPF
Value description: specifies the ProAgent Server station name (usually the computer name) or the TCP/IP address of the server. Default value: ""
Parameter name: PORT Sections in *.PPF: [PRIMARYSERVER] [SECONDARYSERVER] Valid range: 00000 - 99999 (any valid port number)
Value description: specifies the ProAgent Server port number the Agent tries to connect to. Default values: 18988
274
July 2011
Parameters in CUSTOM.PPF
Value description: This entry is the name which displayed on the ProAgent Server desktop window if the Agent is connected with the server. Default value: ""
July 2011
275
EMV parameters
Parameters in CUSTOM.PPF
EMV parameters
The following sections describe some important parameters that can be set in configuration file CUSTOM.PPF.
Completion Objects
This parameter specifies the default Data Object list (list of TAGs) to be used in Solicited Status Message extension, Last Transaction Status Extension and Logical EMV error messages. Parameter name: COMPLETION_OBJECTS Sections in *.PPF: [LYNXCI_EMV] Valid range: ASCII character string (max. 64)
Contact Threshold
This parameter specifies after how many failed contact attempts an unsolicited error message should be sent up to the network. Parameter name: CONTACT_THRESHOLD Sections in *.PPF: [LYNXCI_EMV] Valid range: 0 - 99
276
July 2011
Parameters in CUSTOM.PPF
EMV parameters
Language support
The following parameter specifies a list of supported languages. Parameter name: LANGUAGE_SUPPORTED Sections in *.PPF: [LYNXCI_EMV] Valid range: ASCII character string (max 64)
Value description: the string can contain multiple two digit language codes. Default value: Example: "" "endefrsp" represents the languages "English" (en), "German" (de), "France" (fr), "Spain" (sp).
Value description: Two numeric digits with a preceding backslash represents one byte (example entry: \11\22\33\44\55\66). Default value: not configured
July 2011
277
EMV parameters
Parameters in CUSTOM.PPF
Value description: Two numeric digits with a preceding backslash represents one byte (example entry: \11\22). Default value: not configured
Value description: Two numeric digits with a preceding backslash represents one byte (example entry: \11\22). Default value: not configured
278
July 2011
Parameters in CUSTOM.PPF
EMV parameters
Value description: Two numeric digits with a preceding backslash represents one byte (example entry: \11\22\33). Default value: not configured in CUSTOM.PPF, but set to default value \60\48\20 in registry during installation.
Value description: Two numeric digits with a preceding backslash represents one byte (example entry: \11). Default value: not configured in CUSTOM.PPF, but set to default value \14 in registry during installation.
July 2011
279
EMV parameters
Parameters in CUSTOM.PPF
Value description: Two numeric digits with a preceding backslash represents one byte (example entry: \11\22\33\44\55). Default value: not configured in CUSTOM.PPF, but set to default value \80\00\B0\53\FF in registry during installation.
280
July 2011
Parameters in CUSTOM.PPF
Value description: specifies the number of physical units provided by the NCR or Diebold WOSA. Default value: set to 4 on NCR or Diebold systems
Value description: physical cassette unit name Default NCR: PHYS_NAME_1 = Unit 1 (top) PHYS_NAME_2 = Unit 2 (next to top) PHYS_NAME_3 = Unit 3 (next to bottom) PHYS_NAME_4 = Unit 4 (bottom)
Default DIEBOLD: PHYS_NAME_1 = BIN1 PHYS_NAME_2 = BIN2 PHYS_NAME_3 = BIN3 PHYS_NAME_4 = BIN4 [1] - X = physical unit number
July 2011
281
Parameters in CUSTOM.PPF
Value description: specifies the limit of maximum number of rejected notes. Default value: 300
282
July 2011
Parameters in CUSTOM.PPF
Value description: 0 - Test dispense switched off 1 - Dispense from all cassettes with the same currency. Reject the bundle at the end (reject is called through SOP). 2 - Dispense from each single cassette and reject each single note after each singel dispense. Default value: 1 for Diebold systems, all others not configured 0
Value description: 0 - logical number of remaining notes not devided 1 - devide logical number of remaining notes Default value: not configured
July 2011
283
Parameters in CUSTOM.PPF
284
July 2011
Parameter Management
Parameter Management
The PARAC run
During the J/Install installation process, but after installation of PARAC/NT, an automatic call is initiated to the PARAC interface to preset the Windows registry with default parameter definitions for each product. The following graphics show four pop up windows which are indicating the progress of the update steps. The last window shows the PARAC return code. If PARAC returns with an error code (other than 0 or 7), an error description in red color appears in the second line of the last pop up window.
Figure 4: PARAC Start window
July 2011
285
Parameter Management
The fourth pop up window is a PARAC error window with an example error return code. All finish pop up windows with return codes other than 0 or 7 come up with a second line in red color as a short description of the error. (The only exception is return code 7. This is only a warning: Missing parameter restored).
Figure 7: PARAC Finish window with error return code
286
July 2011
Parameter Management
Please refer to the PCEDT User Manual for detailed function description.
July 2011
287
Parameter Management
After J/Install installation the sub folders like \BAS, \BATCH, etc. located in "C:\PROTOPAS\CONF" will not be used any more during the runtime.
288
July 2011
Parameter Management
July 2011
289
Parameter Management
ProCash/NDC parameters
The following table gives a short description about the configuration files and batch routines that are compressed in file update.z on the Update Disk:
Table 22: List of files in sub folder \BAS
FILE NAME CONV-ALL.BAT DESCRIPTION Batch program which is called during the installation. The batch program updates the registry with all INA files of directory C:\PROTPAS\CONF using the batch files described in this table. After the call this file will be renamed to CONV-ALL.OK 1. Calls KCONF.EXE to convert *.INA files to *.RCK 2. Calls CCRCCONV.EXE which uses *.RCK CONV.BAT can be used to update one particular INA file if you call CONV.BAT with one INA file as the parameter (without extension). Example: CONV ccerrmap Parameters of CSC-W32 error codes and NDC/DDC error mapping table Rear balancing step table (header only) Parameter definition for macro settings in the printer INIT phase (see Protopas "Programmers Reference" for detailed description) Calls KCONF and CCRCCONV to update parameters from PRTMACRO.INA. Parameters for automatic logon Calls KCONF and CCRCCONV to update parameters from LOGON.INA. Parameters to be set for CSCW32. Calls KCONF and CCRCCONV to update parameters from CSCW32.INA. Parameters to be set for SMI30 Calls KCONF and CCRCCONV to update parameters from SMI30.INA Parameters to be set for the ProAgent. Calls KCONF and CCRCCONV to update parameters from PROVIEW.INA. Parameters for CDM service of Protopas Calls KCONF and CCRCCONV to update parameters from CCCDMFW.INA. Parameters of NDC message protocol Calls KCONF and CCRCCONV to update parameters from NDC.INA. Used by Configuration Manager only Connection to the Configuration Manager to call it from the Start Menu Variable definitions needed for the data dictionary framework Dialog definitions for ProTopas/SOP-NDC Step definitions and common parameters for ProTopas/SOP-NDC SOP Text definitions for ProTopas/SOP-NDC Calls KCONF and CCRCCONV to update parameters of *.CFG files Parameters needed for GDI printing Calls KCONF and CCRCCONV to update parameters from GDI_PRT.INA Key definitions for FDKs, EPP and PIN Pad Secure Key Entry configuration for ProTopas/SOP-NDC
CONV.BAT
CCERRMAP.INA LYNXSOP.INA PRTMACRO.INA PRTMACRO.BAT LOGON.INA LOGON.BAT CSCW32.INA CSCW32.BAT SMI30.INA SMI30.BAT PROVIEW.INA PROVIEW.BAT CCCDMFW.INA CCCDMFW.BAT NDC.INA NDC.BAT CCERRDIF.BAT CFGMANAG.LNK DATADICT.INA NDCSOPDIA.CFG NDCSOPSTP.CFG NDCSOPTXT.CFG CCSOPSTEP.BAT GDI_PRT.INA GDI_PRT.BAT WOSAKEYS.INA NDCSOPSKE.INA
290
July 2011
Parameter Management
NDCSOPSKE.BAT UNI-CHAR.REG
Calls KCONF and CCRCCONV to update parameters from NDCSOPSKE.INA Default character sets for Unicode journal logging
July 2011
291
Parameter Management
Specific dialog configuration for CCDM of ProTopas/SOP-NDC Specific step configuration for CCDM of ProTopas/SOP-NDC Specific Text configuration for CCDM of ProTopas/SOP-NDC Specific dialog configuration for CRS + CCDM of ProTopas/SOP-NDC Specific step configuration for CRS + CCDM of ProTopas/SOP-NDC Specific Text configuration for CRS + CCDM of ProTopas/SOP-NDC Calls KCONF and CCRCCONV to update parameters of *.CFG files CashIn step table (script) for ProTopas CashIn transaction framework Parameters with CRS extensions of NDC message protocol
292
July 2011
Parameter Management
July 2011
293
Parameter Management
Specific set of error class files for RM2 (PC4000) Specific set of error class files for cash dispenser Specific set of error class files for CRS (PC3100)
294
July 2011
Parameter Management
July 2011
295
Parameter Management
Main batch file calls addonchk.exe with definition file WOSA.DEF Definition file for addonchk.exe Batch file to set Repository Manager entry CCCard30.dll Batch file to set Repository Manager entry CoinOu20.dll Batch file to set Repository Manager entry CCCard20.dll Batch file to set Repository Manager entry CCCdm20L.dll Batch file to set Repository Manager entry CCCdm30.dll Batch file to set Repository Manager entry CoinOu30.dll Batch file to set Repository Manager entry CCDepo20.dll Batch file to set Repository Manager entry CCCdepo30.dll Batch file to set Repository Manager entry CCEpp20.dll Batch file to set Repository Manager entry CCOpl20.dll Batch file to set Repository Manager entry CCEpp30.dll Batch file to set Repository Manager entry CCFms20.dll Batch file to set Repository Manager entry CCPrt30.dll Batch file to set Repository Manager entry CCFms20.dll Batch file to set Repository Manager entry CCPrt30.dll Batch file to set Repository Manager entry CCFms20.dll Batch file to set Repository Manager entry CCPrt30.dll Batch file to set Repository Manager entry CCSel20.dll Batch file to set Repository Manager entry CCSel30.dll Batch file to set Repository Manager entry CCCard20.dll Batch file to set Repository Manager entry CCOpl30.dll Definition file for ATM.BAT Definition file for CDM30.BAT Definition file for COUT.BAT Definition file for COUT30.BAT Definition file for DEP.BAT Definition file for DEP30.BAT Definition file for EPP.BAT Definition file for IDC30.BAT Definition file for OPP.BAT Definition file for PIN30.BAT Definition file for PRD.BAT Definition file for PRD30.BAT Definition file for PRJ.BAT Definition file for PRJ30.BAT Definition file for PRR.BAT Definition file for PRR30.BAT Definition file for SIU.BAT Definition file for SIU30.BAT
PRR.BAT PRR30.BAT
SIU.BAT SIU30.BAT SSI.BAT TTU30.BAT ATM.SRV CDM30.SRV COUT.SRV COUT30.SRV DEP.SRV DEP30.SRV EPP.SRV IDC30.SRV OPP.SRV PIN30.SRV PRD.SRV PRD30.SRV PRJ.SRV PRJ30.SRV PRR.SRV PRR30.SRV SIU.SRV SIU30.SRV
296
July 2011
Parameter Management
SSI.SRV TTU30.SRV
July 2011
297
Parameter Management
298
July 2011
Parameter Management
July 2011
299
Parameter Management
ProCash/DDC parameters
The following table gives a short description about the configuration files and batch routines that are compressed in file update.z from the Update Disk:
Table 45: List of files in sub folder \BAS
FILE NAME CONV-ALL.BAT DESCRIPTION Batch program which is called during the installation. The batch program updates the registry with all INA files of directory C:\PROTPAS\CONF using the batch files described in this table. After the call this file will be renamed to CONV-ALL.OK 1. Calls KCONF.EXE to convert *.INA files to *.RCK 2. Calls CCRCCONV.EXE which uses *.RCK CONV.BAT can be used to update one particular INA file if you call CONV.BAT with one INA file as the parameter (without extension). Example: CONV ccerrmap Parameters of CSC-W32 error codes and NDC/DDC error mapping table Rear balancing step table (header only) Parameter definition for macro settings in the printer INIT phase (see Protopas "Programmers Reference" for detailed description) Calls KCONF and CCRCCONV to update parameters from PRTMACRO.INA. Parameters for automatic logon Calls KCONF and CCRCCONV to update parameters from LOGON.INA. Parameters to be set for CSCW32. Calls KCONF and CCRCCONV to update parameters from CSCW32.INA. Parameters to be set for SMI30 Calls KCONF and CCRCCONV to update parameters from SMI30.INA Parameters to be set for the ProAgent. Calls KCONF and CCRCCONV to update parameters from PROVIEW.INA. Parameters for CDM service of Protopas Calls KCONF and CCRCCONV to update parameters from CCCDMFW.INA. Parameters of DDC message protocol Calls KCONF and CCRCCONV to update parameters from DDC.INA. Default screens for Countinous Availability (CAS) for DDC Calls KCONF and CCRCCONV to update parameters from CAS_SCR.INA. Used by Configuration Manager only Connection to the Configuration Manager to call it from the Start Menu Variable definitions needed for the data dictionary framework Dialog definitions for ProTopas/SOP-DDC Step definitions and common parameters for ProTopas/SOP-DDC SOP Text definitions for ProTopas/SOP-DDC Calls KCONF and CCRCCONV to update parameters of *.CFG files Parameters needed for GDI printing Calls KCONF and CCRCCONV to update parameters from GDI_PRT.INA Key definitions for FDKs, EPP and PIN Pad
CONV.BAT
CCERRMAP.INA LYNXSOP.INA PRTMACRO.INA PRTMACRO.BAT LOGON.INA LOGON.BAT CSCW32.INA CSCW32.BAT SMI30.INA SMI30.BAT PROVIEW.INA PROVIEW.BAT CCCDMFW.INA CCCDMFW.BAT DDC.INA DDC.BAT CAS_SCR.INA CAS_SCR.BAT CCERRDIF.BAT CFGMANAG.LNK DATADICT.INA DDCSOPDIA.CFG DDCSOPSTP.CFG DDCSOPTXT.CFG CCSOPSTEP.BAT GDI_PRT.INA GDI_PRT.BAT WOSAKEYS.INA
300
July 2011
Parameter Management
Secure Key Entry configuration for ProTopas/SOP-DDC Calls KCONF and CCRCCONV to update parameters from DDCSOPSKE.INA Default character sets for Unicode journal logging
July 2011
301
Parameter Management
Specific dialog configuration for CCDM of ProTopas/SOP-DDC Specific step configuration for CCDM of ProTopas/SOP-DDC Specific Text configuration for CCDM of ProTopas/SOP-DDC Specific dialog configuration for CRS + CCDM of ProTopas/SOP-DDC Specific step configuration for CRS + CCDM of ProTopas/SOP-DDC Specific Text configuration for CRS + CCDM of ProTopas/SOP-DDC Calls KCONF and CCRCCONV to update parameters of *.CFG files CashIn step table (script) for ProTopas CashIn transaction framework
302
July 2011
Parameter Management
ACTIVEX.INA WEB_ONL.REG
Parameters for ActiveX controls of WEB-Extensions Additional parameters required for WEB-Extensions
July 2011
303
Parameter Management
Specific dispenser settings required on diebold hardware platforms Specific error mapping table required for Diebold WOSA Specific SOP modifications for ProTopas/SOP-DDC for Diebold Specific macro mappig table rewquired for Diebold WOSA Specific modifications for Diebold WOSA
PRR.BAT PRR30.BAT
SIU.BAT SIU30.BAT SSI.BAT
304
July 2011
Parameter Management
TTU30.BAT ATM.SRV CDM30.SRV COUT.SRV COUT30.SRV DEP.SRV DEP30.SRV EPP.SRV IDC30.SRV OPP.SRV PIN30.SRV PRD.SRV PRD30.SRV PRJ.SRV PRJ30.SRV PRR.SRV PRR30.SRV SIU.SRV SIU30.SRV SSI.SRV TTU30.SRV
Batch file to set Repository Manager entry CCOpl30.dll Definition file for ATM.BAT Definition file for CDM30.BAT Definition file for COUT.BAT Definition file for COUT30.BAT Definition file for DEP.BAT Definition file for DEP30.BAT Definition file for EPP.BAT Definition file for IDC30.BAT Definition file for OPP.BAT Definition file for PIN30.BAT Definition file for PRD.BAT Definition file for PRD30.BAT Definition file for PRJ.BAT Definition file for PRJ30.BAT Definition file for PRR.BAT Definition file for PRR30.BAT Definition file for SIU.BAT Definition file for SIU30.BAT Definition file for SSI.BAT Definition file for TTU30.BAT
July 2011
305
Parameter Management
Batch file that calls CCRCCONV to set parameters of FONETCFG.INA Batch file that calls CCRCCONV to set parameters of FONETCRD.INA Batch file that creates a display resolution dependent FONETDIA.INA, which is used by CCRCCONV to set parameters required for the High Level Dialog Batch file that calls CCRCCONV to set parameters of FONETDIC.INA Batch file that calls CCRCCONV to set parameters of FONETFDK.INA Batch file that calls CCRCCONV to set parameters of FONETKEY.INA Batch file that calls CCRCCONV to set parameters of FONETMSG.INA Batch file that calls CCRCCONV to set parameters of FONETPBM.INA Batch file that calls CCRCCONV to set parameters of FONETREC.INA Batch file that calls CCRCCONV to set parameters of FONETSMI.INA Batch file that calls CCRCCONV to set parameters of FONETSTP.INA Miscellaneous FOnet parameters Card table parameters used by FOnet Data Dictionary Property parameters used by FOnet Function Display Key (FDK) mapping Parameters for High Level Dialog Specific EPP PinKey parameters required for FOnet TOPMSG and CUSTMSG journal message parameters used by FOnet Specific parameters for receipt print outs Parameters used by FOnet to build consumer receipts Step table Parameters of step table CASHIN_STEP2, MAINSCRIPT, NBO_CASHOUT, SINGLE_TA
306
July 2011
Parameter Management
July 2011
307
Parameter Management
Batch file that calls CCRCCONV to set parameters of FRM2STP.INA Specific step table Parameters of step table CASHIN_STEP2 for RM2 Batch file that creates a display resolution dependent FRM2DIA.INA, which is used by CCRCCONV to set parameters required for the High Level Dialog RM2 dialog configuration for 640x480 resolution RM2 dialog configuration for 800x600 resolution RM2 dialog configuration for 1024x768 resolution Specific settings of SMI device parameters required on cash in systems
308
July 2011
Parameter Management
DESCRIPTION CSC-W32 or LYNX Error class and error code section Transaction Device status (see underlined Note) Error Severity Maintenance Status Maintenance Data (see section Variables in M-Data status field on page 312) Reboot flag. System reboots if this error occurs and flag is 1 See section [TOPMSG] in CUSTOM.PPF for definition Diebold 911 or 912 status code Diebold MDS i series status (see section Variables in MDS i series status: on page 311 Error short description. This description can be journaled (TOPMSG) via variable $DCMC_DEVICE_ERROR_INFO$
For ProCash/NDC the TD-Status of solicited cash dispenser status messages can be modified by the application during runtime. In case the number of notes dispensed field is ZERO, the TD-Status is set to 2 and for Card before Cash (FC A) the value is set to 4. (CCERRMAP entry of TD_STATUS remain unchanged). See ProCashNDC or ProCash/DDC User Guide for detailed descriptions of NDC or DDC status fields. The CSC-W32 error codes are described in the System Messages manual of CSC-W32. Refer also to manual Error Mapping Cross Reference Tables for NDC and DDC status codes.
July 2011
309
Parameter Management
Note:
The different status codes have to be configured as a comma separated list, where the first 911/912 error code in the list corresponds to the first MDS status code, the second 911/912 error code to the second MDS status code, and so on. It is only allowed to configure all 4 error codes or just 1 error code.
310
July 2011
Parameter Management
Example 1: money low If denomination D and E are low, ProCash/DDC sends following MDS status: 000D901:2D:08:01 Example 2: money out If denomination C and F are low, ProCash/DDC sends following MDS status: 000D901:3D:04:02 Example 3: pick error
If the second physical cassette has a pick error, ProCash/DDC sends following MDS status: 000D901:3F:31:38
July 2011
311
Parameter Management
If for example the third cassette gets an error during a dispense, ProCash/DDC replaces the B7 to 19. The DDC912 error code ?0195 is sent to the host.
"PP" can be replaced with the pick error code for all four cassette types. Depending on which position the error occurs only the error code of one cassette type will be sent to the network. All other fields are set to zero.
312
July 2011
Parameter Management
Please refer to the "System Messages" manual of CSC-W32 for detailed error description of error CSC-W32 error classes.
The following table illustrates which CSC-W32 and XFS error classes are currently assigned to the internal generated device class.
Table 68: CSC-W32 and XFS class assign table
CSC-W32 class 0005 (V.24 comm.) 0003 (USB comm.) 0005 (V.24 comm.) 0032 (global PRT class 0003 (USB comm.) 0005 (V.24 comm.) 0032 (global PRT class) 0003 (USB comm.) 0005 (V.24 comm.) 0032 (global PRT class) 0003 (USB comm.) 0005 (V.24 comm.) 0003 (USB comm.) 0005 (V.24 comm.) 0003 (USB comm.) 0003 (USB comm.) 0005 (V.24 comm.) 0018 (CDM basic error) 001D (CDM extended error) 0003 (USB comm.) 0004 (IEEE 1394 class) 0005 (V.24 comm.) 0003 (USB comm.) 0004 (IEEE 1394 class) 0005 (V.24 comm.) 005A (RM2) 005E (RM2) Assigned Class 0008 AA08 0033 AA48 0038 AA45 0039 AA39 0018 AA18 0017 AA17 AA18_CIN 0018_CIN 0018_CIN 001D_CIN CC1A BB1A EE1A DD1A AA1A FF1A 005A_CIN 005E_CIN Cash dispenser (CDM) Deposit module CRS (CashIn) Document printer Receipt printer Device description Card Reader Journal printer
CCDM (CashIn)
July 2011
313
Parameter Management
00B9 (XFS 2.0 CDM errors) 6752 (XFS 3.0 CDM errors) 6751 (XFS 3.0 CRS errors)
Error Suppression
During the runtime ist can happen that one of the application level generates error codes which have no influence to the device operation. Those errors are just non relevant warnings. To prevent confusions by the service operators the Device Status Framework (dcDevSta.dll) ignors error A200 (Software Error) of class 0018 (class Cash Dispenser). Furthermore for specific errors you can configure in CCERRMAP.INA to suppress sending a message to the host and displaying the error on the SOP panel if you set parameter SEVERITY = "0" and TD_STATUS = "0". For ProCash/DDC you can suppress sending an error to the host if you set parameter DDC_STATUS = "" (as empty value) in the requested error section.
314
July 2011
Parameter Management
The value 0C for parameter PREP_FIELD_22 represents denomination C and D in the hardware configuration status info.
July 2011
315
Parameter Management
The first denomination (CURRENCY_1 and VALUE_1) indicates the HI denomination. The second denomination (CURRENCY_2 and VALUE_2) indicates the LO denomination (the currency and value entry are examples only). To enable the full Diebold 911 compatible mode you have to set parameter DDC_NINE_ELEVEN_DENOM, and you need to configure CURRENCY_3, CURRENCY_4 and VALUE_3, VALUE_4. Please refer to section Diebold 911 compatible HI and LO denomination mode on page 317 for details.
316
July 2011
Parameter Management
Value description: 0 - compatible mode disabled 1 - compatible mode enabled Default value: not configured
If the parameter DDC_NINE_ELEVEN_DENOM is set, the parameters CURRENCY_x and VALUE_x of section [CASH_DISENSER] have to be set as follows: Section in *.PPF: [CASH_DISPENSER] NUM_LOG_CASS = 4 CURRENCY_3 = "USD" VALUE_3 = 10 CURRENCY_4 = "USD" VALUE_4 = 20
Parameters:
July 2011
317
Parameter Management
X = represents the number that has to correspond to parameter REPLY_ID_X, where FID 8 is configured.
318
July 2011
Parameter Management
Macro activation Parameter name: Value Range: Value description: Default value: MACRO_TABLE_ACTIVE 0, 1 Activates or deactivates the user defined macro table. 0
July 2011
319
Printer initialisation via macro tables Macro interpretation Parameter name: Value Range: Value description:
Parameter Management
HALF_DOUBLE_NUMBER_SIGNS 0, 1 0 - two ## are reduced to one # or #MACRO# is interpreted as a macro; 1 - two ## characters are printed has normal characters and will not be interpreted as a macro.
This parameter usually has to be enabled if the Protopas environment is running on an NCR or Diebold ATM where no CSCW32 application is installed. Default value: 0
Printer INIT Parameter name: Value Range: Value description: INIT any legal macro name This parameter can be used to send additional macro sequences to the printer during printer initialisation in the startup phase. ""
Default value:
Example: If you like to enable variable receipt length and no black dot mark recognition for the Receipt printer, you have to set the following: [Wincor Nixdorf\ProTopas\CurrentVersion\CCOPEN\RECEIPT] INIT = #VLM##MRKC#
320
July 2011
Parameter Management
"USERINIT" is any macro name. The value are the control sequences supported by ND9A or ND9E. 1b2b01 = data request 1b583400 = cancel 1b76 = send status to application
Now the parameter "USERINIT" has to be set as macro #USERINIT# in section: [Wincor Nixdorf\ProTopas\CurrentVersion\CCOPEN\RECEIPT] INIT = "#USERINIT#"
July 2011
321
Parameter Management
322
July 2011
Parameter Management
July 2011
323
Parameter Management
Automatic Installation
GDI Windows printer can be automatically installed via J/Install installation. For printers, which can operate as GDI Windows printer or in raw print mode (see table), you have to specify the GDI mode in configuration file CUSTOM.CUS. Refer to section GDI Windows name for receipt printer on page 263 and section GDI Windows name for document printer on page 263 for detailed description how to enable GDI windows printer. Pure GDI printer like ND9G are installed automatically as a Windows printer.
324
July 2011
Parameter Management
July 2011
325
Parameter Management
Parameter fields
The parameters in table Card less transaction parameters on page 325 except the parameter IDLE_TIMEOUT (see description in section Timeout parameter on page 327), use following parameter values: Each parameter value comma separated is a separate parameter.
Table 71: Card less parameter fields
Field Range Index 0 1 2 3 VAR VAR VAR VAR Size VAR VAR VAR VAR Description Track1 data (without start/end sentinel) Track2 data (without start/end sentinel) Track3 data (without start/end sentinel) PIN block buffer - This field can contain the PIN number in clear text format. The PIN should NOT be padded. - If the field is empty, no PIN buffer is sent to the host, unless one of the following state is a PIN entry state where a PIN number has been entered. Good next state number Cancel exit next state Start transaction flag 0 - using card data which are already loaded (if it isn't set in the Parameter value list, will be used the default) 1 - using card data which are set in Track1, Track2, ... (default)
4 5 6
3 3 1
326
July 2011
Parameter Management
Timeout parameter
The parameter IDLE_TIMEOUT can be used to configure a specific timeout handling during a card less transaction. This parameter should be configured only if card less transaction processing should be enabled in the middle of a transaction. These parameters specify the parameter values for the timeout handling how long this card less transaction should be taken. Each parameter value comma separated is a separate parameter. If this parameter is not set, no timeout will be used.
Example:
IDLE_TIMEOUT = "30,555"
Parameter name: CARDLESS_PARALLEL_FDK_CARD_EXIT Section in Registry: ..\LYXPAR\APPLICATION or ..\LYNXCI\SCREEN\xxx Valid range: "sss,eee"
July 2011
327
Parameter Management
Parameter name: KEY_LEFT_0_CHARS Registry Key: Valid range: [HKEY_LOCAL_MACHINE\SOFTWARE\Wincor Nixdorf\ ProTopas\CurrentVersion\LYNXCI\SCREEN] character string
Value description: specifies the digits to be padded Default value: Example value: - not configured 00
Parameter name: KEY_RIGHT_0_CHARS Registry Key: Valid range: [HKEY_LOCAL_MACHINE\SOFTWARE\Wincor Nixdorf\ ProTopas\CurrentVersion\LYNXCI\SCREEN] character string
Value description: specifies the digits to be padded Default value: Example value: - not configured 000
328
July 2011
Parameter Management
Dependent parameters
The following parameters are required to assign the key code 5 for the left side key from the 0 key. Usually on Wincor Nixdorf systems for this key the decimal key code is assigned be default. Please refer to the vendor specific documentation how to assign key codes to EPP keys. Parameter name: PINKEY_11 Registry Key: Valid range: [HKEY_LOCAL_MACHINE\SOFTWARE\Wincor Nixdorf\ ProTopas\CurrentVersion\WOSAKEYS\ASC_KEY] numeric values
Value description: specifies the key code for the left side key Default value: Example value: - not configured 5
Value description: specifies the cursor character for the input position on the consumer display. Default value: Example value: - not configured <
July 2011
329
Parameter Management
Value description: specifies the cursor character for the input position on the consumer display. Default value: Example value: - not configured <
Value description: specifies the character sequence to display on the consumer screen. The curser can be moved to the next position to the right after each key press within the allowed input time specified via parameter ALPHA_TIMER. Default value: - not configured
330
July 2011
Parameter Management
The following parameters specify the character sequences for the keys 0 - 9 on the EPP: "ALPHA_0_SEQ"="0_+-" "ALPHA_1_SEQ"="1QZ" "ALPHA_2_SEQ"="2ABC" "ALPHA_3_SEQ"="3DEF" "ALPHA_4_SEQ"="4GHI" "ALPHA_5_SEQ"="5JKL" "ALPHA_6_SEQ"="6MNO" "ALPHA_7_SEQ"="7PRS" "ALPHA_8_SEQ"="8TUV" "ALPHA_9_SEQ"="9WXY"
Value description: 0 - clear input field and start input from the left hand side if maximum digits in input field has been reached 1 - ignore further inputs if amount buffer field is full 2 - ignore further inputs if numeric buffer field is full 4 - clear the last input in amount entry state using the clear key 8 - clear the last input in information entry state using the clear key 16 - do not show leading zeros in amount entry state Default value: 0 - not configured
July 2011
331
Parameter Management
Value description: 0 - no options configured 1 - ignore horizontal and vertical offset when displaying a picture as cursor @@ 2 - auto end numeric input when length reached 4 - do not add extra space when switching to G font (DDC only) 16 - disable alphanumeric entry Default value: 0 - no options configured
332
July 2011
Parameter Management
Value description: specifies for which state the input timer restart handling is enabled. Default value: 15 - input restart enabled for all states
July 2011
333
Parameter Management
Modem Interface DLL The following parameter specifies the path and filename of the framework that communicates with the modem interface. Parameter name: COM50_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
334
July 2011
The following parameter specifies the path and filename of the framework that communicates with the serial interface protocol. Parameter name: COM51_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
Communication Yield DLL The following parameter specifies the path and filename of the communication yield framework. Parameter names: COM52_FRAME COM53_FRAME COM54_FRAME Section in *.PPF: Valid range: [STARTUP] character string (path)
July 2011
335
Parameter Management
Value description: Each Parameter contains a program with execution parameters which are loaded in the specified order from left to right. Default value: C:\PROTOPAS\BIN\FwLoadPm.EXE,4,1,21,,, CCCommProtocol1 CCCommunication50 CCCommunication51 CCCommunication52 CCCommunication53 CCCommunication54"
336
July 2011
Parameter Management
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value:
Modem initialisation command Parameter name: MODEM_CMD_CONFIG Section in *.PPF: [MODEM_COMMANDS] [MODEM_EVENTS] [MODEM_PROJECT] [MODEM_PROJECT_ALTERNATE] character string (path)
Valid range:
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: AT&F1E1X3M1
July 2011
337
Configure Dial Up communication Serial interface line attributes Parameter name: SERIAL_LINEATTR Section in *.PPF:
Parameter Management
Valid range:
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: 57600,N,8,1
Serial interface port name Parameter name: SERIAL_PORTNAME Section in *.PPF: [SERIAL_COMMANDS] [SERIAL_EVENTS] [SERIAL_PROJECT] [SERIAL_PROJECT_ALTERNATE] character string (path)
Valid range:
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: COM1
338
July 2011
Parameter Management
Project settings
COM channel The following parameter specifies modem communication channel. Parameter name: COM_CHANNEL Sections in *.PPF: [PROTOCOL_PROJECT] Valid range: character string (path)
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: Protocol channel The following parameter specifies protocol channel. Parameter name: PROT_CHANNEL Sections in *.PPF: [PROTOCOL_PROJECT] Valid range: character string (path) 50
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: Protocol type The following parameter specifies the protocol type. Parameter name: COMM_PROTOCOL Sections in *.PPF: [PROTOCOL_PROJECT] Valid range: character string (path) 1
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: VS2
July 2011
339
Configure Dial Up communication Route ID This parameter specifies the Route ID. Parameter name: ROUTE_ID Sections in *.PPF: [PROTOCOL_PROJECT] Valid range: character string (path)
Parameter Management
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: Terminal ID This parameter is used to configure a Terminal ID. Parameter name: TERMINAL_ID Sections in *.PPF: [PROTOCOL_PROJECT] Valid range: character string (path) HANCO
Value description: Refer to ProTopas "Host Protocol and Communication Frameworks" Programming Guide for detailed description Default value: 99999999
340
July 2011
Activation with ProTect/One: If you are using ProTect/One you have to extend the SECURITY.SEC file. Please refer to the documentation of ProTect/One for details.
July 2011
341
342
July 2011
$UPDATE$.Z The compressed file $UPDATE$.Z can be created with ICOMP.EXE. You need to call ICOMP.EXE with option "subdirectories included". The modules have to be compressed in the same directory structure as on the harddrive. CUSTOM.PPF The configuration file CUSTOM.PPF can be created or modified with PCedt.exe $UPDATE$.REG WINNT Registry configuration file, called via REGEDIT -S in "startupappl.bat". To the example above the diskette consists of following files: SOPCOPY.TXT $UPDATE$.Z CUSTOM.PPF $UPDATE$.REG
July 2011
343
The automatic PARAC call, the call of REGEDIT and the extraction routine are defined in batch file STARTUPAPPL.BAT located in \PROTOPAS\BIN folder.
This software update procedure via ProTopas/SOP has the advantage that no additional keyboard is required for updating parameters or new software modules which are common for rear load systems.
344
July 2011
July 2011
345
346
July 2011
July 2011
347
6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434
0017 0018 0019 0020 0021 0022 0023 0024 0025 0026 0027 0028 0029 002A 002B 002C 002D 002E 002F 0030 0031 0032 0033 0034 0035 0036 0037 0038 0039 003A 003B 003C 003D 003E 003F 0040
1051 1501 1031 1029 1039 1039 1039 1039 1039 1039 1039 1039 1031 1029 1029 1023 1023 1035 1035 1039 1039 1039 1039 1039 1039 1032 1033 1033 1039 1031 1033 1033 1033 1033 1500 1033
Paper low on document printer Try to dispense with money in transport Card write attempt but no data to write Cash dispenser shutter error Deposit bin missing Deposit jam Deposit envelope jam during dispense Deposit no envelopes available Deposit printer failure Deposit wrong envelope size Deposit shutter not closed Deposit bin is overfilled Card Reader bin is overfilled CAS: dialog (907) timeout while service dispenser CAS: dialog (907) cancel while service dispenser CAS: dialog (906) timeout while service deposit module CAS: dialog (906) cancel while service deposit module CAS: dialog (907) timeout while service statement printer CAS: dialog (907) cancel while service statement printer Envelope dispenser low Envelope dispenser empty Envelope dispenser error Envelope dispenser jam Envelope dispenser shutter not close Envelope dispenser shutter not open Statement capture bin full Journal paper nearly empty Receipt paper nearly empty Shutter not close or money jam, no dispense operation Card manipulation detected while waiting for card Journal printer error, spooler active Journal printer ok, reprint started Journal printer ok, reprint finished Journal printer error, spooler error GetPIN error, PIN dialog was cancelled via command Receipt paper jam or paper empty
348
July 2011
6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434 6434
0041 0042 0043 0044 0045 0046 0047 0048 0049 004A 004B 004C 004D 004F 0050 0051 0052 0053 0054 0055 0056 0057
1033 1031 1033 1031 1031 1031 1031 1031 1031 1031 1031 1031 1031 1031 1061 1061 1061 1061 1061 1061 1061 1061
Journal paper jam or paper empty Card was captured after jam Hard disk free space low (warning) / out (error) Card write attempted but track for writing not installed Card write command failed Card trap active (Lebanese Loop) Mouth piece removed (vandalism) Card reader skimming active Too many consecutive card jams Shutter not close and cash tray not empty, dispense operation declined Shutter not close but cash tray empty, dispense operation declined Shutter closed but cash tray not empty, dispense operation declined Shutter closed, cash tray empty, but transport way not free, dispense operation declined DIP Card not taken CoinOut hopper low or out CoinOut low condition not set CoinOut hopper empty, no dispense attempted CoinOut module inoperative before dispense CoinOut hopper low, no dispense attempted CoinOut dispense error, but coins dispensed CoinOut dispense error, hopper jam, but partial dispense possible CoinOut dispense fatal error, no coins dispensed
July 2011
349
350
July 2011
The following table lists ProTopas return codes from the Cash Dispenser device Framework which are mapped to the hexadecimal error codes assigned to class 643A.
Table 75: Cash Dispenser return code table
Class CDM return Code 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A 643A -331 -330 -324 -323 -322 -321 -320 -317 -316 -315 -314 -313 -312 -311 -310 -309 -308 -307 -306 -305 -304 -303 -302 -301 -300 -14 -13 Error Code [1] FEB5 FEB6 FEBC FEBD FEBE FEBF FEC0 FEC3 FEC4 FEC5 FEC6 FEC7 FEC8 FEC9 FECA FECB FECC FECD FECE FECF FED0 FED1 FED2 FED3 FED4 FFF2 FFF3 TOPMSG Number 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 1029 Description
Order not allowed Shutter not closed Present job active No items to present Unknown present error Error in bills presentation Denomination error No documents (no bills) Invalid cash unit Shutter closed Shutter open Shutter not open Invalid retract Safe door open Position locked Invalid position Documents, bills left in transport Too many documents dispensed Dispenser is not able to dispense (door open or error with reject cassette) No currency mix Invalid mix type Invalid denomination Cash unit error Invalid teller ID Invalid currency Cash dispenser general hardware error, cannot dispense Cash dispenser device not ready, cannot dispense
July 2011
351
[1]
This error code can be interpreted as a WARNING or ERROR class by the ProCash/NDC or ProCash/DDC application.
352
July 2011
USER NAME SEL_FRAME BARCODE_FRAME JOURNAL_FRAME SERVICE_FRAME OPL_FRAME APPLICATION_FRAME CDM_FRAME COINOUT_FRAME APPL_DATA_FRAME SMI_FRAME DLG_FRAME COM_FRAME SEC_FRAME CARD_FRAME EPP_FRAME DIALOG_FRAME SCRIPT_FRAME CONVERTER_FRAME SYNC_FRAME JOURNAL_FRAME MSGCTRL1_FRAME RECPRT_FRAME PROT1_FRAME PRESS_FRAME DEVSTA_FRAME DEPOSIT_FRAME TRANSACT_FRAME USEREXIT_FRAME VARIABLE_FRAME SECURE_FRAME DOCPRT_FRAME CCSOP_DIALOG
July 2011
353
354
July 2011
July 2011
355
356
July 2011
USER NAME EXPANDED_HW_CONF_BYTE_0 EXPANDED_HW_CONF_BYTE_1 EXPANDED_HW_CONF_BYTE_2 EXPANDED_HW_CONF_BYTE_3 EXPANDED_HW_CONF_BYTE_4 EXPANDED_HW_CONF_BYTE_5 EXPANDED_HW_CONF_BYTE_6 EXPANDED_HW_CONF_BYTE_7 EXPANDED_HW_CONF_BYTE_8 EXPANDED_HW_CONF_BYTE_9 EXPANDED_HW_CONF_BYTE_10 EXPANDED_HW_CONF_BYTE_11 EXPANDED_HW_CONF_BYTE_12 EXPANDED_HW_CONF_BYTE_13 EXPANDED_HW_CONF_BYTE_14 EXPANDED_HW_CONF_BYTE_15 DOUBLE_EXPANDED_HW_CONF_BYTE_16 DOUBLE_EXPANDED_HW_CONF_BYTE_17 DOUBLE_EXPANDED_HW_CONF_BYTE_18 SEND_TVN_MAC CHECK_TVN_MAC SEND_MACHINE_NO CHECK_MACHINE_NO SEND_TVN_MAC_SOL MAC_FLD_SELECTED MAC_ASCII STATUS_CODE_HANDLING RKL_ENCODING
July 2011
357
USER NAME HW_CONF_0_PROD_CLASS HW_CONF_1_NOCONFIG HW_CONF_2_DISK HW_CONF_3_CARD_READER HW_CONF_4_CASH_HANDLER HW_CONF_5_PPD HW_CONF_6_REC_PRINTER HW_CONF_7_JRN_PRINTER HW_CONF_8_RESERVED HW_CONF_9_RESERVED HW_CONF_10_NIGHT_DEPOSIT HW_CONF_11_ENCRYPTOR HW_CONF_12_CAMERA HW_CONF_13_DOOR_ACCESS HW_CONF_14_FLEX_DISK HW_CONF_15_TAMPER_BINS HW_CONF_16_CARDHOLDER_KEYB HW_CONF_17_OPERATOR_KEYB HW_CONF_18_DISPLAY_VOICE HW_CONF_19_NOCONFIG HW_CONF_20_NOCONFIG HW_CONF_21_STATEMENT_PRT HW_CONF_22_SIG_DISPLAY HW_CONF_23_RESERVED HW_CONF_24_COIN_DISP HW_CONF_25_SYSTEM_DISPLAY HW_CONF_26_MED_ENT_IND HW_CONF_27_ENV_DISP HW_CONF_28_DOC_PROC_MOD HW_CONF_29_COIN_TAMP_IND HW_CONF_30_DOC_TAMP_IND HW_CONF_31_RESERVED HW_CONF_32_DIG_AUDIO_SERV HW_CONF_33_RESERVED HW_CONF_34_RESERVED
358
July 2011
HW_CONF_35_RESERVED HW_CONF_36_RESERVED HW_CONF_37_RESERVED MESSAGE_LOGGING SEND_TVN_MAC CHECK_TVN_MAC SEND_MACHINE_NO CHECK_MACHINE_NO SEND_TVN_MAC_SOL MAC_FLD_SELECTED MAC_ASCII STATUS_CODE_HANDLING GO_OFFLINE_AFTER_TIMEOUT
HW_CONF_35_RESERVED HW_CONF_36_RESERVED HW_CONF_37_RESERVED MESSAGE_LOGGING SEND_TVN_MAC CHECK_TVN_MAC SEND_MACHINE_NO CHECK_MACHINE_NO SEND_TVN_MAC_SOL MAC_FLD_SELECTED MAC_ASCII STATUS_CODE_HANDLING GO_OFFLINE_AFTER_TIMEOUT
July 2011
359
360
July 2011
July 2011
361
DEFAULT_NUM_NOTES_2 DEFAULT_NUM_NOTES_3 DEFAULT_NUM_NOTES_4 DEFAULT_NUM_NOTES_5 DEFAULT_NUM_NOTES_6 DEFAULT_NUM_NOTES_7 DEFAULT_NUM_NOTES_8 AUTO_LOGON_CASSETTES AUTO_LOGON_IN_SOP AUTO_LOGON_NOTES DENOMINATION_LOW_MSG CLEAR_MISS_COUNTER DISPENSE_ALGO SEND_CASSETTE_LOW_ALWAYS MAX_PRESENT_ERRORS SEND_SOL_RETRACT SOLICITED_IF_RETRACT_INHIBIT CAS_WAIT_TIME FATAL_CASS_AS_MISSING DISPENSE_BELOW_ZERO LOGICAL_MAPPING DENOM_ID_UPPERCASE CHECK_STATUS_AFTER_MONEY_TAKEN CASH_RETRACT_SCREEN PRESENT_FAILURE_SCREEN NUM_PHYS_NAMES PHYS_NAME_X DISPENSE_RETRIES PRESENT_TIMER MAX_REJECT_NOTES REJECT_FATAL_STATUS MV_TESTDISPENSE EQUAL_PHYS_CASS_COUNTERS CHECK_FATAL_BEFORE_DISPENSE MAX_DISPENSE_ERRORS HWERR_DISPENSE_RETRIES EXPONENT_CORRECTION DISPLAY_PRESENT_SCREEN PHYS_GOOD_NOTES MAX_DISPENSE_TIME DO_CIN_RETRACT
DEFAULT_NUM_NOTES_2 DEFAULT_NUM_NOTES_3 DEFAULT_NUM_NOTES_4 DEFAULT_NUM_NOTES_5 DEFAULT_NUM_NOTES_6 DEFAULT_NUM_NOTES_7 DEFAULT_NUM_NOTES_8 AUTO_LOGON_CASSETTES AUTO_LOGON_IN_SOP AUTO_LOGON_NOTES DENOMINATION_LOW_MSG CLEAR_MISS_COUNTER DISPENSE_ALGO SEND_CASSETTE_LOW_ALWAYS MAX_PRESENT_ERRORS SEND_SOL_RETRACT SOL_RETRACT_INHIBIT CAS_WAIT_TIME FATAL_CASS_AS_MISSING DISPENSE_BELOW_0 LOGICAL_MAPPING DENOM_ID_UPPERCASE CHECK_STATUS_AFTER_MONEY_TAKEN CASH_RETRACT_SCREEN PRESENT_FAILURE_SCREEN NUM_PHYS_NAMES PHYS_NAME_X DISPENSE_RETRIES PRESENT_TIMER MAX_REJECT_NOTES REJECT_FATAL_STATUS MV_TESTDISPENSE EQUAL_PHYS_CASS_COUNTERS CHECK_FATAL_BEFORE_DISPENSE MAX_DISPENSE_ERRORS HWERR_DISPENSE_RETRIES EXPONENT_CORRECTION DISPLAY_PRESENT_SCREEN PHYS_GOOD_NOTES MAX_DISPENSE_TIME DO_CIN_RETRACT
362
July 2011
XFS20
USER AREA in"CUSTOM.WN" [CASH_DISPENSER] USER NAME REJECTCASSFULL MAXRETRACT MINIMUMBILLS REGISTRY LOCATION [HKEY_CLASSES_ROOT\WOSA/XFS_ROOT\ PHYSICAL_SERVICES\ATM] REGISTRY PARAMETER RejectCassFull MaxRetract MinimumBills
XFS30
USER AREA in"CUSTOM.PPF" [CDM30] USER NAME REJECTCASSFULL MINIMUMITEMS REGISTRY LOCATION [HKEY_LOCAL_MACHINE\SOFTWARE\ PHYSICAL_SERVICES\CDM30] REGISTRY PARAMETER RejectCassFull MinimumItems
ProTopas
USER AREA in"CUSTOM.PPF" [CCCDMFW] USER NAME MAXRETRACT REGISTRY LOCATION [HKEY_LOCAL_MACHINE\SOFTWARE\Wincor Nixdorf\ CurrentVersion\CCOPEN\CCCdmFW] REGISTRY PARAMETER MaxRetract
July 2011
363
ACCEPT_CODE_FORMAT
364
July 2011
July 2011
365
366
July 2011
July 2011
367
368
July 2011
July 2011
369
370
July 2011
USER NAME CALLDELAY CORESYNC CONTABSIZE CALLRETRY POLLTIME CLOSETIME SHMDELAY NETTIME OPENTIME
July 2011
371
USER NAME PROJECT_RECEIVE_BUFFER_SIZE SHMCLRCAUSEDIAG MAXSENDSIZE SHM_PASSIVE CUGSELECTION D_BIT_PROC REMRESCAUSEDIAG OFFRESCAUSEDIAG VCTYPE PASSIVE_START CALLUSERDATA_P NOTRACE MAXRECVSIZE PVCNO CALLUSERDATA_A CUGOUTSELECT INDEX SEND_RECONNECT REVERSECHRG_PAS SHMDELAY_FLAG REVERSECHRG_ACT LOCALADR REMOTEADR1 REMOTEADR2 REMOTEADR3 REMOTEADR4 REMOTEADR5
372
July 2011
USER NAME REMOTEPEER REMOTEPEER_X KEEPALIVES TRANSPORTSIZE CLOSETIMEOUT CLIENTOPENRETRY CODINGDLL TYPE PORTNUMBER ADMINSIZE OPENTIMEOUT SENDTIMEOUT LOCALPORT
July 2011
373
374
July 2011
July 2011
375
376
July 2011
July 2011
377
378
July 2011
July 2011
379
The following graphic shows the main screen with one loaded NDC font named "NDC-SA1.FON".
380
July 2011
Fon2asc.exe is used to extract WINNT font files to ASCII matrix font files. The ASCII file can be used to modify or enhance characters of a font file via any standard text editor. The modificated file can be reconverted to the *.FON format via ASC2FON.EXE. The ASCII file must have following header parameter: Font Width Height - sets the font name which must match (case sensitive) with parameter "NAME" of section [VIEWER_FONT_XXX] - sets the character width - sets the character Height.
Character XX
- sets the character ASCII position (XX represents the hex value of the position) and must exist for each defined character.
Syntax:
FON2ASC fontfile > ASCIIfile
ASC2FON.EXE Asc2Fon.exe converts ASCII matrix font files to WINNT font files. The file name of the new font file is the same as the name specified behind the header parameter Font of the ASCII file but included with extension *.FON. Syntax:
ASC2FON ASCIIfile
July 2011
381
Cpyntfnt.exe detects the current Windows display resolution than it copies and registers fonts of the detected resolution in the Windows environment. Font files (*.FON) will be automatically copied from directory C:\PROTOPAS\FONTS\XXX (XXX stands for 640x480, 800x600, 1024x768) to the \WINNT\FONTS directory. Afterwards they will be automatically registered for immediate access. Furthermore you can enable copying resolution dependent Bitmaps or Icons from the C:\PROTOPAS\BITMAPS\XXX resolution sub folder to C:\PROTOPAS\BITMAPS. The register and copy processes are protocolled in log file "CPYNTFNT.INF" located in C:\PROTOPAS. Optionally this tool registers GDI printer fonts that are required for GDI print operation. Syntax:
CPYNTFNT [-R] [-B] [-0] [-1] [-2] [-G] [fontfile]
Options: -R -B -G -W -F -0 -1 -2 fontfile Enables font installation with automatic detection Enables copying Bitmaps or Icons in the selected or detected resolution. Registers all GDI printer fonts located in C:\PROTOPAS\FONTS\GDI_PRT Registers all kind of windows fonts located in C:\PROTOPAS\FONTS\WEB Enables copying resolution depended Bitmaps used by FOnet. Sets resolution 640x480 Sets resolution 800x600 Sets resolution 1024x768 Registers a single font in the selected or detected resolution.
The call without parameter -0, -1 or -2 (CPYNTFNT -R) enables automatic detect. The resolution of the current Windows display setting is used.
This utility is called by the "Configuration Manager" where you can use font registration via an user friendly dialog window. See main menu "Update" and sub menu "Install Fonts and Bitmaps".
382
July 2011
ASC2ICN is used to convert an ASCII icon file into a *.icn file. Syntax:
ASC2ICN sourcefile [destfile]
If destfile is not specified, $tmp$.icn is used or ASC2ICN -I destfile with stdin as the input
ICN2ASC.EXE Description: Icn2asc.exe can be used to extract ICN icon files to ASCII matrix files for modifiations. Syntax: ICN2ASC.EXE ICNfile > destfile EXAMPLE:
ICN2ASC.EXE 0000.ICN > 0000.txt
If you change the 'X's of the matrix file to 0 - F (1 digit hex value) you get the specific color for the modified pixels. See also Table 7-3 Color table for the color definitions.
July 2011
383
ASC2PCC is used to convert an ASCII icon file into a *.PCC or *.PCX file. Syntax:
ASC2PCC [-V] [-Wwidth] [-Hheight] [-Ttop] [-Lleft] sourcefile [destfile]
If destfile is not specified, $tmp$.pcc is used or ASC2PCC -I [-V] destfile with stdin as the input.
384
July 2011
This Utility can be used to create own Windows fonts that can be used for screen display and GDI printing. Please press F1 button for detailed help description how to use this tool.
July 2011
385
Analyzing utilities
Analyzing utilities
PROTLOG.EXE ProtLog.exe analyzes the messages of the log file CCProt.LOG and inserts structured descriptions of the message types and its fields. Syntax:
PROTLOG CCProt.LOG > destinationfile
Options: -D -S -L analyzes ProCash/DDC messages (DIEBOLD) extracts messages for simulation extracts download messages only (3...) useful for ndc-sim.dll
Prt-Dof.exe can be used with the dot matrix printers ND71, ND98, ND9A and the new series printers ND9x, TH21, TH22, TP06, TP07 and TH30 printers. IMPORTANT NOTE: If the TP07 is installed as a GDI Windows printer, user defined characters cannot be loaded into TP07.
Syntax:
prt-dof <DEVICE ID> filename.dof [-Z]
386
July 2011
Installation and Configuration ToolsFont tools for journal and receipt printer Option: This option is needed if you get time-out errors from CSC-W32 because of large printer data. If this option is in use, the CSC-W32 command TraPrint is called for each singe line. Without -Z option only one single TraPrint command is called for the whole contents of the DOF file. Important Note: You also have to create the DOF file with -Z option if you use utility ASC-DOF.EXE or ND9C-DOF.EXE. NOTE: Do NOT use the -Z option for TP06 and TP07. -Z
The DEVICE ID must be the logical name of the printer used by CSCW32. The names which are typically used are JOURNAL1 for the journal printer and BON1 for the receipt printer.
The CSCW32 environment must be installed ! Structure and description of a download file for needle printers ND71 and ND9x:
All escape sequences must be entered in hex format !!!!! Creation of an user-defined character file: The file must be in the following format:
First line: /h 1b26024141 Next lines: /h 0900001f80200044008000440020001f800000
You can use any text editor you wish. First line: In the first line you must enter the load command ESC &, then set 02 for 2 bytes (9 needles for each column) The next two digits specify the start position; the last two digits specify the last character. For example the entry 4141 means: Load one character to position 41H.
July 2011
387
Font tools for journal and receipt printersInstallation and Configuration Too Next lines: The next lines are the pixel control of each character. You can create 95 userdefined characters from hex position 20H to 7EH in any style you like. ND71: ND9x: Note: Use 9 columns for 10 and 12 cpi; 7 columns for 15 cpi. Use 5 columns for 10, 12 and 25 cpi; 7 columns for 15 cpi. Thermal printers ND9C, ND99, TP06, TP07, TH21, TH22 and TH30 need different formats. Those formats are described in following sections.
When the bits are set in the desired positions, you should count in the following way. For example in column two byte 1, the bits 0, 1, 2, 3, 4 are set. Count 1+2+4+8+16 = 31 decimal = 1FH. In byte 2 only bit 7 is used. That means 128 in decimal and 80H. The needle control code is 1F80 for column two.
388
July 2011
Installation and Configuration ToolsFont tools for journal and receipt printer
Two needles may not be set directly after another in the horizontal line. The printer will, however, correct that itself. code = set /h before each command line col = how many columns 1b = byte 1 2b = byte 2
1 2 3 4 5 6 7 8 9
code col 1b2b 1b2b 1b2b 1b2b 1b2b 1b2b 1b2b 1b2b 1b2b --------------------------------------------------------/h 09 0000 1f80 2000 4400 8000 4400 2000 1f80 0000
For the ND9x printers the number of columns (col) must be specified only for the first character. Example 2: Creation of the character 'A' with 7 columns:
Columns Needle Needle Needle Needle Needle Needle Needle Needle Needle 1 2 3 4 5 6 7 8 9 Byte1 Byte1 Byte1 Byte1 Byte1 Byte1 Byte1 Byte1 Byte2 7 6 5 4 3 2 1 0 7 1 2 3 4 5 6 7 ------------------0 0 0 1 0 0 0 0 0 1 0 1 0 0 0 1 0 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 1 0 0 1 0 1 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 1 0
1 2 3 4 5 6 7 code col 1b2b 1b2b 1b2b 1b2b 1b2b 1b2b 1b2b ---------------------------------------------/h 07 0000 3f80 4000 8400 4000 3f80 0000
Userdefined character sets can be activated via macro #CCT#. Standard character sets can be set via macro #NCT#.
July 2011
389
Font tools for journal and receipt printersInstallation and Configuration Too ASC2DOF.EXE Asc2dof.exe converts characters which are created in an ASCII matrix file to the hexa decimal byte definition of the *.DOF (DownLoadFile) which can be used to load them with prt-dof.exe. The style of the ASCII files are the same as the screen font files which are stored in C:\PROTOPAS\TOOLS\FONTS. The only change is the number of columns and lines (needles) represented in the file as "Width" and "Height". "Height" is divided in two bytes. The first byte has the range from line 1-8 and the second byte is the ninth line. This results in Height 9 for a two byte character definition. The needle printer ND71 permits 9 and 7 columns and the printers ND98/ND9A/ND9E permit 5 and 7 columns. This utility cannot be used for ND9C. See section Font and Logo tools for printers on page 392 for ND9C utilities. Syntax:
ASC2DOF [-Z] ASCIIfile > DOFfile
Example:
ASC2DOF ND98_7 > ND98_7.DOF
390
July 2011
Installation and Configuration ToolsFont tools for journal and receipt printer Example: Creation of character 'A' in 7 and 5 columns: Structure of the ASCII file with 7 columns characters: Font 7 columns Width 7 Height 9 Character 41 ..X.X.. .X...X. X.....X X.....X X.X.X.X X.....X X.....X ....... ....... After conversion with asc2dof.exe:
/h 41 3e00400088000000880040003e00/h 41 7e008800880088007e00
Structure of the ASCII file with 5 columns characters: Font 5 columns Width 5 Height 9 Character 41 .XXX. X...X X...X X...X XXXXX X...X X...X ..... .....
The number 41 is the hexadecimal position which is defined in the ASCII file before. This is not needed for the downloading process. For the character downloading process you need to add the ESC & loading command and the number of columns as described in section "Structure and description of the download file".
July 2011
391
Dof2asc.exe can be used to convert hexadecimal font files (*.dof), which are used to load characters into the printer with utility prt-dof.exe, to an ASCII matrix file. The matrix file can be edited with any standard editor. Syntax:
DOF2ASC [-Z] doffile > filename
Example:
DOF2ASC ND9A.DOF > ND9A.ASC
This utility cannot be used for ND9C printer. For the ND9C printer you have to use dof-nd9c.exe or nd9c-dof.exe. See section Font and Logo tools for printers on page 392.
392
July 2011
Font files with extension *.FNT are standard fonts which are loaded in the standard area of the printer. Fonts for the userdefined area can be created with the ASCII to DOF utilities and must be loaded via PRT-DOF.EXE.
July 2011
393
Contents example of LD_ND99.CFG for printer ND99: [FONTS] C:\PROBASE\CSCW32\FRM\FONT10.SWF C:\PROBASE\CSCW32\FRM\FONT12.SWF C:\PROBASE\CSCW32\FRM\FONT15.SWF C:\PROBASE\CSCW32\FRM\FONT17.SWF [LOGOS] C:\PROBASE\CSCW32\FRM\LOGO1.LOG C:\PROBASE\CSCW32\FRM\LOGO2.LOG
The space for Logos and Fonts are limited and can be read from the test printout of the ND99. If a font or Logo reaches the maximum space during the load process, it will not be recognised during the load. But it can be verified after the load if you make a test printout where you can see how many Fonts and Logos are successfully loaded. ND99 logos can be controlled via macros #LOGO1# - #LOGO9#. User defined Fonts can be activated via macro #CCT#. Standard Fonts can be set via macro #NCT#. Contents example of LD_ND9X.CFG for printers ND9C, ND9D, ND9E, TH30: [FONTS] C:\PROBASE\CSCW32\FRM\FIRMW.MOD C:\PROBASE\CSCW32\FRM\FONT_437.FNT [LOGOS] C:\PROBASE\CSCW32\FRM\LOGO1.BMP C:\PROBASE\CSCW32\FRM\LOGO2.BMP For ND9X printers logos can be controlled via macro #LOGO1# With ldnd9x.exe you are able to load 4 Fonts and 10 Logos. ATTENTION: If you need to load new firmware please make 100% sure that the firmware file (*.MOD) you have configured is the right one for the printer type you have connected. Wrong FW destroys the printer. For (*.FNT) files it is the same.
394
July 2011
Function description of LDND9X: The loader can be started from any directory you like but it needs the CSCW32 environment. When you call the program it checks first if the file LD_ND99.CFG (option -ND99) or LD_ND9X.CFG (option -ND9X) exist. Then it shows the number of Fonts or Logos depending on which loading process is selected (See parameter options for load and delete options). If option -ND99 is in use, the next step deletes all existing fonts or Logos first before the load for the new fonts or Logos will be started. If option -ND9X is used, the deleting process is skipped and the loading process starts immediately. Each process will be displayed on screen to show information whether the load is successfully finished or if parts of the process fail. Syntax call:
LDND9X
Options: -ND99 -ND9X -TP07 -TP06 -L -G -D -E -J need to be set for ND99 printer need to be set for ND9C, ND9D, ND9E or TH30 printers need to be set for TP07 receipt printer (non GDI mode) need to be set for TP06 journal printer (requires option -J too) deletes and loads Fonts deletes and loads Logos (not supported for TH30) deletes Fonts only (ND99 only) deletes Logos only (ND99 only) specifies device JOURNAL1
NOTE1: NOTE2:
Logo loading via this utility is supported for ND99, ND9C, TP07 and TP06 printer. For TP07 only option -G (loading a LOGO) is supported. For TP06 only options -G together with -J are supported. As example for a 450 x 100 BMP, the printed size corresponds to 5,5cm * 1cm. The TP07 and TP06 printers support loading of one Logo only. Therefore only macros #LOGO# or #LOGO1# are supported for the logo print.
July 2011
395
Nd99logo.exe extracts binary logo files of ND99 into an ASCII matrix file. This text file can be modified with any standard text editor. This utility is useful to make modifications for some pixels of an existing logo to obtain a better logo quality. The typical way to create Logos will be to draw a PCX graphic with a graphic program. This utility can help you to tune your Logo. Syntax:
ND99LOGO logofile > filename
The ASCII file must have the following header parameter: Logo Type: Logo Width: Logo Height: Logo Name: - specifies the logo number which is used by the macro #LOGO1# - #LOGO9#. - specifies the width of the Logo in bytes. 1 byte represents eight pixels in one line. - specifies the Logo height. The number of lines represents the Logo height. - the file name of the logo (8.3 format) must be entered there. The name will be printed in the test printout of ND99.
The Width and Height parameter should be in the range of 70 (560 pixel) and 200 (lines). This depends on the available memory of the ND99.
ASC2LOGO.EXE Asc2logo.exe converts ASCII logo files to the binary logo format for ND99 printers. See also utility ND99LOGO.EXE for the structure of the ASCII logo file format. Syntax:
ASC2LOGO ASCIIfile logofile
396
July 2011
Pcx2asc.exe is used to convert *.pcc or *.pcx files into ASCII matrix files. This ASCII file can be used as a source file for the conversion of ASC2LOGO.EXE to a logo file format for the ND99 printer.
The header parameter must be changed to the format as described by utility ND99LOGO.EXE. It is important that the value of parameter Width is divided by eight if you need it for the logo conversion, because of the 1 byte steps for the logo width (1 byte represents eight pixels). Syntax:
PCX2ASC [-D] [-E] [-W] sourcefile
Options: -D -E On CGF icons double horizontal pixels. On VGA icons compress every 2 lines (24 -> 12 lines) On CGF icons double lines 5 and 9 (12 -> 14 lines). On VGA icons do not compress lines 9 and 17 if -D option is set (24 -> 14 lines) Set horizontal size in characters.
-Wsize
ND99-ASC.EXE Description: Nd99-asc.exe extracts characters stored in *.swf format to ASCII format which can be modified by the customer. Syntax:
ND99-ASC FONTfile > ASCII file
Example:
ND99-ASC ARIAL10.SWF >ARIAL10
July 2011
397
Asc-nd99.exe converts extracted characters stored in ASCII format back to the *.swf format which has to be used to download the font to the ND99 printer. Syntax:
ASC-ND99 ASCIIfile FONTfile
Example:
ASC-ND99 ARIAL10 ARIAL10.SWF
DOF-ND9C.EXE Description: Dof-nd9c.exe can be used to convert hexadecimal font files (*.dof) to an ASCII matrix file. The ASCII matrix file can be edited with any standard text editor. The ND9C and TH30 printer can load 5 character sizes: 10, 12, 14, 16, 20 with fixed Height = 22 pixels. The TH21 or TH22 needs three sizes: 10, 13, 18 with the fixed Height = 24 pixels. Syntax:
DOF-ND9C [-Z] FONTfile > ASCIIfile
Example:
DOF-ND9C USR_CPI12.DOF > USR_CPI12.ASC
If you have a printer that has a firmware version loaded older than December 1999 the load sequence is /h 1b26 instead of /h 1c26. DOF-ND9C.EXE supports /h 1b26 and /h 1c26 within a DOF file.
Use utility PRT-DOF.EXE to load the hexa decimal contents of a DOF file into the ND9C, TH30 and TH21 or TH22 printer.
398
July 2011
Nd9c-dof.exe converts characters from an ASCII matrix file to the hexa decimal byte definition of the *.DOF (DownLoadFile), which can be used to load them with prt-dof.exe. Use utility dof-nd9c.exe to reconvert characters from the hexadecimal format of a DOF file to an ASCII matrix format. The ND9C printer needs five sizes to be loaded: Width = 10, 12, 14, 16, 20. The Height is fixed and always 22 pixels. The TH21 or TH22 needs three sizes: 10, 13, 18 with fixed height of 24 pixels. This makes shure that for all cpi sizes the characters are able to be printed. Parameter "Character" represents the character postion. The range of the character positions is between 21H - 7FH. Position 20H (SPACE) is not allowed to be overloaded. This utility can be used for TH21, TH22 or TH30 as well. Syntax:
ND9C-DOF [-Z] ASCIIfile > FONTfile
Example:
ND9C-DOF USR_CPI12.ASC > USR_CPI12.DOF
Example contents of an ASCII matrix file (character B) for the ND9C printer:
Width 16 Height 22 Character 42 .XXXXXXXXX...... .XXXXXXXXXX..... ..XX.....XXX.... ..XX.....XXX.... ..XX......XXX... ..XX......XXX... ..XX.....XXX.... ..XX.....XXX.... ..XXXXXXXX...... ..XXXXXXXX...... ..XX.....XXX.... ..XX.....XXX.... ..XX......XXX... ..XX......XXX... ..XX.....XXX.... ..XX.....XXX.... .XXXXXXXXXX..... .XXXXXXXXX...... ................ ................ ................ ................
User defined character sets can be deleted via ESC (1B 27) with sequence "/h 1b27" using utility PRT-DOF.EXE. (Supported with firmware since Dec. 1999)
If you have a printer that has a firmware version loaded older than December 1999 the old load sequence /h 1b26 has to be used instead of /h 1c26. ND9C-DOF.EXE always converts to /h 1c26. July 2011 399
Example:
ND9E-DOF STDLOGO.ASC > STDLOGO.DOF
How to Load one logo: You can load two different kinds of logos either standard or extended format: Standard format: Width: 144; Height: 104 (13 lines x 8 pixel or smaller) Extendend format: Width: 200; Height: 144 (18 lines x 8 pixel or smaller) Step1: Create a 16 color PCX graphic in Z-Soft Paintbrush format for standard logo within range 144 x104 or extended logo within 200 x 144 (width x height). Use utility PCX2ASC.EXE to convert the PCX graphic to an ASCII file. Use utility ND9E-DOF.EXE to convert the ASCII matrix file to a DOF that contains hexa decimal sequences for the printer. Use utility PRT-DOF.EXE to load the DOF contents into the printer. See also detailed descriptions of PRT-DOF.EXE and PCX2ASC.EXE in the previous sections.
How to print the logo: The hexa decimal sequence to print the logo is 1b6f. This sequence can be inserted in a DOF file as: /h 1b6f0d0a0c To print the logo via the application you can define an own macro in section "..\CCOPEN\CCPRTFW\RECEIPT_MACROS" like MYLOGO = \1b\6f that can be configured via parameter RECEIPT_PAGE_HEADER = #MYLOGO# in CUSTOM.PPF.
400
July 2011
If the TP07 is installed as a GDI Windows printer, user defined characters cannot be loaded into TP07.
Options: -N must be set for 7x9 or 9x9 fonts needed for dot matrix printers NP06 or NP07.
Example 1:
DOF-RJ03 USR10x17.DOF > USR10x17.ASC
Example 2:
DOF-RJ03 -N USR7x9.DOF > USR7x9.ASC
July 2011
401
Rj03-dof.exe converts characters from an ASCII matrix file to the hexa decimal byte definition of the *.DOF (DownLoadFile), which can be used to load them with prt-dof.exe. Use utility dof-rj03.exe to reconvert characters from the hexadecimal format of a DOF file to an ASCII matrix format. The RJ03 series thermal printers TP06 (journal) and TP07 (receipt) need two character sets, which needs to be loaded: 10x17 and 14x24 (width x height). The dot matrix (needle) printers NP06 (journal) and NP07 (receipt) need two character sets in pixel format: 7x9 and 9x9 (width x height). The printers accept to load characters in range 20H - FFH. IMPORTANT NOTE: Syntax:
RJ03-DOF [-N] ASCIIfile > DOFfile
If the TP07 is installed as a GDI Windows printer, user defined characters cannot be loaded into TP07.
Options: -N must be set for 7x9 or 9x9 fonts needed for dot matrix printers NP06 or NP07.
402
July 2011
Example contents of an ASCII matrix file (character B) for the TP07 printer:
Width 14 Height 24 Character 42 .............. .............. .XXXXXXXXX.... .XXXXXXXXXX... ..XX.....XXX.. ..XX.....XXX.. ..XX......XXX. ..XX......XXX. ..XX.....XXX.. ..XX.....XXX.. ..XXXXXXXX.... ..XXXXXXXX.... ..XX.....XXX.. ..XX.....XXX.. ..XX......XXX. ..XX......XXX. ..XX.....XXX.. ..XX.....XXX.. .XXXXXXXXXX... .XXXXXXXXX.... .............. .............. .............. ..............
Example 2:
RJ03-DOF -N USR7x9.ASC > USR7x9.DOF
Example contents of an ASCII matrix file (character B) for the NP06 printer:
Width 7 Height 9 Character 42 ....... .XXXX.. .X...X. .X...X. .XXXX.. .X...X. .X...X. .XXXX.. .......
July 2011
403
Miscellaneous tools
Miscellaneous tools
WRITE-ID.EXE Write-ID.exe can be used to write data on track1,2 or/and 3 of ID cards. Therefore you need a card reader which is able to write on the ID card tracks. The data definition of the tracks has to be edited in a batch file e.g. write_id.cmd. The batchfile must contain the path of the program and as parameters 3 string definitions which indicates the track data. Example: You want to write track 2 data on the card but track 1 and 3 are empty: Syntax of the batch file: c:\protopas\tools\Write-Id "" "99999999999=999999999" ""
The WRITE-ID.EXE tool cannot work if the ATM is in service mode or/and a card insert job has been already started. MDS2WNC.EXE MDS2WNC.exe can be used to replace MDS i series status codes or/and Maintenance Data of parameter DDC_MDS_STATUS or/and M_DATA of configuration file CCERRMAP.INA to CSCW32 StClass and StCodes for Wincor Nixdorf ATMs. Error Class and Error Code (StClass, StCode) will be copied and concatenated from the section line and will be inserted in the value field of parameter DDC_MDS_STATUS or M_DATA. Syntax:
MDS2WNC [-M] [-D] sourcefile destfile
Options: -D -M Example:
MDS2WNC -M -D C:\PROTOPAS\CONF\CCERRMAP.INA CCERRMAP.NEW
Inserts CSCW32 StClass & StCode to DDC_MDS_STATUS Inserts CSCW32 StClass & StCode to M_DATA
404
July 2011
Miscellaneous tools
COMPREGF.exe compares an extracted Regfile (REGEDIT4 format) with the contents of the Windows registry. Syntax:
COMPREGF -Rregfile [-Llogfile]
specifies the extracted registry file (must be extracted in ASCII text (REGEDIT4) format) specifies the logfile name where the differencies are stored
PRT-RAW.EXE PRT-RAW.exe uses the CSCW32 interface to print macros and printer data from an ASCII file to the selected printer station (BON1, JOURNAL1 or BELEG1). It can be used to preset printers with default settings before application start or if you like to test the printer functionality. Syntax:
PRT-RAW -PDEVICE -Ffilename
Options: -PDEVICE DEVICE specifies the device station: BON1 - receipt printer JOURNAL1 - journal printer BELEG1 - document printer specifies the filename that contains the printer data.
-Ffilename Example:
July 2011
405
PrintRaw.exe calls the "Print" or "PrintRaw" method of the ProTopas API to print macro sequences and printer data configured via a formular number or from an ASCII file to the requested printer destination specified via parameters. Syntax:
PRINTRAW [-Fnnn][-E] -Pprinter
Options: Parameter -Fnnn is optional and enables the formular "Print" method of ProTopas. If the parameter is NOT set, the "PrintRaw" method of the ProTopas API is used (on the document printer "Eject" is called after the print). -Fnnn nnn - specifies a formular number that has to be configured via parameter MSGnnn in follwing registry locations depending on which printer type has been selected: ..\LYNXPAR\PRINTER\RECEIPT ..\LYNXPAR\PRINTER\JOURNAL ..\LYNXPAR\PRINTER\DOCUMENT printer - specifies the printer type: REC - receipt printer JRN - journal printer DOC - document printer JOU - E-journal destination Calls ProTopas Eject() method if -PREC is set
-Pprinter
-E Example 1:
The following command line initiates a formular "Print" on receipt using printer data defined via parameter MSG400 in section ..\LYNXPAR\PRINTER\RECEIPT.
PRINTRAW -F400 -PREC
Example 2:
The following command line initiates a "PrintRaw" on the journal printer using the printer data defined in C:\PROTOPAS\RAWDATA.TXT.
PRINTRAW -PJRN
406
July 2011
Miscellaneous tools
SETHWPPF.exe is called once during the installation phase in the batch file UPDCONF.CMD. Depending on the configured WOSA device service it disables the paper journal if the WOSA journal printer service is not configured to be loaded. It supports following WOSA service names: PRJ,PRR,PRD,DEP. Syntax:
SETHWPPF -DWOSA-SERVICE1,WOSA-SERVICE2,WOSA-SERVICEn,...
Options: -DWOSA-SERVICEx specifies the WOSA service names that can be configured in parameter CCBase in section ..\CCOPEN\RESTART\APPLICATION_1 -T Sets parameters for Triple DES -GND9G,TH21,TH22,TH97 Checks if the printers n the list are installed as GDI printers and sets the required parameters for GDI print operation in ProCash/NDC or ProCash/DDC.
Example:
SETHWPPF -DPRJ,PRR,PRD,DEP -T -GND9G,TH21,TH22,TH97
Function Description for -D option: When the utility is called following functions are performed: 1. It checks if PRJ, PRR, PRD, DEP is configured in Registry parameter CCBase. 2. It sets Parameter ACTIVE = N for the sections [SERVICES_PRJ], [SERVICES_PRR], [SERVICES_PRD], [SERVICES_DEP] in CUSTOM.PPF and parallel the value is set in the registry if the belonging service is not configured. 3. If the PRJ service is not configured it sets in addition to parameter ACTIVE parameter PAPER_JOURNAL = 0 in section [JOURNALPRINTER] of CUSTOM.PPF and parallel it sets the value in the registry. Function Description for -T option: 1. Calls batch program Sop3Des.bat to set parameters for ProSop Triple DES key input. Refer also to Abschnitt Enable Triple DES operation on page 322. Function Description for -G option: 1. Includes the GDI Printer Overlay Framework (dcPrtGdi.DLL) in the repository configuration for the Receipt or/and Document printer. Scans the CSC-W32 printer configuration. If a valid GDI printer configuration is found in the CSC-W32 section, the repository configuration for the detected printer is modified. In addition the Windows printer name is set for parameter PRINTER_NAME in section GDI_XXX_PRINTER (xxx = REC or DOC) of "CUSTOM.PPF".
July 2011
407
InitEpp.exe initializes the EPP and deletes all loaded keys. After INITEPP.EXE has been called with option -D and -E, the security keys have to be entered via SOP function. If INITEPP.EXE is called with option -I, just EPP information is displayed, the status of the EPP will not be changed. Syntax:
INITEPP [-D -E] [-I]
Options: -D -E calls CSC-W32 function CscEdmInit() to initialize the EPP calls CSC-W32 function CscEdmExport() after CscEdmInit() to remove the key names from the EPP. This function returns successfully if an EPP V4 or higher is installed. "EPP export error" is returned if the function call is not supported because of an old EPP version. This parameter has to be set together with parameter -D displays detailed information about EPP Type, Status, Capabilities and the loaded Firmware Version
-I
EXTERRMP.EXE ExtErrMp.exe can be used to convert the sections of CCERRMAP.INA to a new registry structure where the different error classes from section [CLASS] are grouped to devices in a new section [DEVICES]. The tool can also be used to split all error classes from an existing CCERRMAP.INA to multiple files. Each file is named as the class name. Syntax:
EXTERRMP [-Soldfile -Eoldfile] > newfile
Options: -S Creates a new errmap file where the old error mapping registry format is converted to section [CLASS\...] and [DEVICES\...] In addition to option -S, multiple files of each class are created, where the filename is the class name.
-E
408
July 2011
Simulation utilities
Simulation utilities
HOSTSIM.EXE Hostsim.exe is a windows program which can be started parallel to the running application to simulate several host messages and Online - Offline events. After the program has been called, the following window appears on the screen:
If you select "Enter Message" you get a text input field on the bottom line. Any valid host to terminal message can be entered. Example entry: 1\1c\1c\1c4
The backslash (\) for the field separator (1c) must be entered via [STRG] + [ALT] + [\] After entering the message you have to click on the Send Message button, then the message is send to the communication framework. If you press "Select Message" you get a new dialog window where you can select a message that you like to be sent. You have to create your own message list in a separate ASCII file named "NDC-SIM.MSG" stored in "C:\PROTOPAS". Each line should contain one host command (without leading spaces) only.
July 2011
409
MfcDlg.exe is a dialog window where you can enter a screen number which is displayed immediately parallel to the running customer application. This is useful to check specific screens for its contents and availability. The program shows the following dialog window on the screen:
MFCVAR.EXE MfcVar.exe is a windows program which shows the entered steps and contents of variables (e.g. Operation Code buffer) for the actual step. The program shows the following window on the screen:
410
July 2011
Installation of communication SW
Installation of communication SW
This section describes how to install and configure the software of network cards and communication add on products.
Types of EICON cards Wincor Nixdorf has released model EC/PC, C21 and S51 card. In the first half of 2000 the new C91 board will be released which will not be supported in the DOS environment. The release V4R2 supports the EC/PC, C21 and S51 cards under WindowsNT 4.0 with service pack 3 or higher. You have to use a driver update if your PC has a Pentium II or III processor. This patch (ECNB.SYS 23.07.98 4.2 Build 88) is included in release V4R2S1. The S51 card was released for the installation of OS/2.
WINCOR NIXDORF INTRANET BS P42 Software integration and Pilot support http://seeus.pdb.sni.de/ftp-user3/index.htm
July 2011
411
Installation of communication SW
Installation
Select "SETTINGS" from the Windows "START" button. Open "CONTROL PANEL" and double click "NETWORK". Go to folder "ADAPTERS" and click "ADD". Now click on HAVE DISK...
412
July 2011
Installation of communication SW
The INSERT DISK window appears and prompts for a path to the EICON software:
The next window lets you choose a software variant. Just click OK.
July 2011
413
Installation of communication SW
Now you have to select "AUTOMATIC" or "MANUAL" installation. For PnP OS systems you can use use the automatic installation procedure. The system automatically detects the card and defines the hardware resources. "Manual" will be used in systems without PnP capabilities or if the automatic detection fails or if the card has to have special resources. In that case you will have to select the card type and assign its resources manually.
The next dialog box is just an information window in case if you have selected "Automatic" installation. Just click OK. If the card could not be detected automatically you have to use the manual setup for configuration.
414
July 2011
Installation of communication SW
Now you will be asked for the destination directory and Installation Group:
July 2011
415
Installation of communication SW
The results of the automatic detection are displayed in the dialog window "DETECTION RESULTS". If the parameters for IRQ and/or I/O address are not shown, manual installation is recommended. Comments in the lower part maybe helpful for error analysis.
Now run the EICON configuration program by clicking Yes in the following window.
416
July 2011
Installation of communication SW
Now you can configure your EICON card and the protocols. Specific sections can be selected inside the directory structure. The dependent data is displayed on the right side and can be changed. Please ask your network administrator for the relevant parameters of protocol configuration. The protocol configuration of the card can be saved with the function "FILE-IMPORT". By doing this, the configuration set can be used in other systems. Note: Hardware settings, like I/O address and IRQ, are not overwritten.
July 2011
417
Installation of communication SW
418
July 2011
Installation of communication SW
In the next dialog box you have to set the physical line settings. An important setting is the field "DATA ENCODING", where you have to set NRZ or NRZI. The clocking setting is usually "EXTERNAL". After the configuration changes it is neccessary to save the data.
The last dialog asks you if you want to install the EICON WAN services for Routers, PAD's and so on. Select the NO button at this time.
July 2011
419
Installation of communication SW
Several settings have to be done from the application side. These are for instance Local and remote address, buffer sizes and call user data.
Testing connection From the DOS command prompt you can call some test programs. The call "ECCARD START" is used to start the EICON service. "ECCARD STOP" disables the EICON service. With command "ECCARD STATUS" you get information of the line activity.
420
July 2011
Tables
Tables
Table 1: External Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 32 33 42 114 116 117 118 125 126 129 149 151 153 155 265 265 267 268 269 270 290 291 291 Table 2: Components on "ProBase/C CD"
Table 3: Core products and AddOns on "J/Install CD" Table 4: Structure of the Customizing Media Table 5: Optional Parameters (NDC)
. . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
Table 6: Miscellaneous Features I (DDC) . . . . . . . . . . . . . . . Table 7: Miscellaneous Features II (DDC) . . . . . . . . . . . . . . . Table 8: Miscellaneous Features III (DDC) . . . . . . . . . . . . . . . . . . . . . .
Table 10: RGB values for 16 standard colors . . . . . . . . . . . . . . Table 11: Screen parameters reference table . . . . . . . . . . . . .
Table 12: Parameters supported in language banks (DDC only) . . . . Table 13: Variables and formats for event and error messages . . . .
Table 14: Hardware Configuration Parameters (NDC) . . . . . . . . . Table 15: Hardware Configuration Parameters (DDC) . . . . . . . . . Table 16: Default NDC font names . . . . . . . . . . . . . . . . . . . Table 17: Default DDC font names . . . . . . . . . . . . . . . . . . . Table 18: DDC resolution dependent values for "SIZE" and "HEIGHT" Table 19: NDC resolution dependent values for "SIZE" and "HEIGHT" Table 20: Standard NDC and DDC font identifiers . . . . . . . . . . .
Table 21: Default settings for NDC and DDC fonts . . . . . . . . . . . Table 22: List of files in sub folder \BAS . . . . . . . . . . . . . . . .
Table 23: List of files in sub folder \BATCH . . . . . . . . . . . . . . . Table 24: List of files in sub folder \CDM . . . . . . . . . . . . . . . .
July 2011
421
Tables Table 25: List of files in sub folder \CCD . . . . . . . . . . . . . . . . Table 26: List of files in sub folder \CHQ . . . . . . . . . . . . . . . . Table 27: List of files in sub folder \CRS . . . . . . . . . . . . . . . . Table 28: List of files in sub folder \EMV . . . . . . . . . . . . . . . . Table 29: Error class files of folder \CCERRMAP . . . . . . . . . . . 292 292 293 293 294 294 294 295 295 295 295 296 297 297 297 298 298 298 298 299 300 301 301 302 302 302
Table 30: List of files in sub folder \WEB\CONF . . . . . . . . . . . . Table 31: List of files in sub folder \WN . . . . . . . . . . . . . . . .
Table 32: List of files in sub folder \NCR\XFS20 . . . . . . . . . . . . Table 33: List of files in sub folder \NCR\XFS30 . . . . . . . . . . . . Table 34: List of files in sub folder \DIEBOLD\XFS20 Table 35: List of files in sub folder \DIEBOLD\XFS30 . . . . . . . . . . . . . . . . . .
Table 36: List of files in sub folder \WOSA . . . . . . . . . . . . . . . Table 37: List of files in sub folder \FONET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 39: List of files in sub folder \FONET\COINOUT Table 40: List of files in sub folder \FONET\CRS Table 41: List of files in sub folder \FONET\CCDM
. . . . . . . . . . . . . . . . . . . . .
Table 42: List of files in sub folder \FONET\COININ . . . . . . . . . . Table 43: List of files in sub folder \FONET\RM2 Table 44: List of files in sub folder \FLX . . . . . . . . . . .
. . . . . . . . . . . . . . . .
Table 45: List of files in sub folder \BAS . . . . . . . . . . . . . . . . Table 46: List of files in sub folder \BATCH . . . . . . . . . . . . . .
Table 47: List of files in sub folder \CDM . . . . . . . . . . . . . . . . Table 48: List of files in sub folder \CCD . . . . . . . . . . . . . . . . Table 49: List of files in sub folder \CHQ . . . . . . . . . . . . . . . . Table 50: List of files in sub folder \CRS . . . . . . . . . . . . . . . . 422 July 2011
Tables Table 51: List of files in sub folder \EMV . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 302 303 303 303 304 304 304 306 307 307 307 307 307 308 308 309 313 314 325 326 327 347 350 351 352 423
Table 53: List of files in sub folder \WN . . . . . . . . . . . . . . . . . Table 54: List of files in sub folder \NCR\XFS20 Table 55: List of files in sub folder \NCR\XFS30 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 56: List of files in sub folder \DIEBOLD\XFS20 Table 57: List of files in sub folder \DIEBOLD\XFS30 Table 58: List of files in sub folder \WOSA
. . . . . . . . . . . . . . .
Table 59: List of files in sub folder \FONET . . . . . . . . . . . . . . . Table 60: List of files in sub folder \FONET\CDM . . . . . . . . . . . . Table 61: List of files in sub folder \FONET\COINOUT . . . . . . . . . Table 62: List of files in sub folder \FONET\CRS . . . . . . . . . . . . Table 63: List of files in sub folder \FONET\CCDM . . . . . . . . . . . Table 64: List of files in sub folder \FONET\COININ . . . . . . . . . .
Table 65: List of files in sub folder \FONET\RM2 . . . . . . . . . . . . Table 66: List of files in sub folder \FLX . . . . . . . . . . . . . . . . . Table 67: Error parameter block of CCERRMAP . . . . . . . . . . . . Table 68: CSC-W32 and XFS class assign table . . . . . . . . . . . . Table 69: XFS30 - CSC-W32 class assign table Table 70: Card less transaction parameters . . . . . . . . . . . .
. . . . . . . . . . . . . .
Table 71: Card less parameter fields . . . . . . . . . . . . . . . . . . Table 72: Parameter fields for IDLE_TIMEOUT Table 73: Transaction Framework Error Table . . . . . . . . . . . . . . . . . . . . . . . . .
Table 74: Cash Dispenser Framework Error Table . . . . . . . . . . . Table 75: Cash Dispenser return code table Table 76: Transaction Framework Error Table July 2011 . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tables Table 77: Registry cross link [STARTUP] . . . . . . . . . . . . . . . . . . . . . . . 353 354 354 354 355 356 356 357 358 360 360 361 361 361 364 364 365 365 366 366 366 368 368 369 369 370
Table 78: Registry cross link [START_APPLICATION] Table 79: Registry cross link [DEFAULT] Table 80: Registry cross link [CCProtFW1] Table 81: Registry cross link [MODEM]
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
Table 82: Registry cross link [SERIAL] . . . . . . . . . . . . . . . . . Table 83: Registry cross link [PROTOCOL\PROJECT] . . . . . . . .
Table 84: Registry cross link [HARDWARE_CONFIGURATION] (DDC) Table 85: Registry cross link [HARDWARE_CONFIGURATION] (NDC) Table 86: Registry cross link [LYNXCI_PARAMETER] . . . . . . . . . Table 87: Registry cross link [LYNXCI_TIMER] Table 88: Registry cross link [LYNXCI_EMV] Table 89: Registry cross link [EMV_TAGS] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 90: Registry cross link [CASH_DISPENSER] . . . . . . . . . . Table 91: Registry cross link [COIN_DISPENSER] . . . . . . . . . .
Table 92: Registry cross link [BARCODE] . . . . . . . . . . . . . . . Table 93: Registry cross link [DEPOSIT] . . . . . . . . . . . . . . . . Table 94: Registry cross link [CARD_READER] . . . . . . . . . . . . Table 95: Registry cross link [ELECTRONIC_JOURNAL] . . . . . . . Table 96: Registry cross link [JOURNALPRINTER] . . . . . . . . . . Table 97: Registry cross link [JOURNAL_FONT_XXX] Table 98: Registry cross link [RECEIPTPRINTER] . . . . . . . .
. . . . . . . . . .
Table 99: Registry cross link [RECEIPT_FONT_XXX] . . . . . . . . . Table 100:Registry cross link [DOCUMENTPRINTER] . . . . . . . .
Table 101:Registry cross link [DOCUMENT_FONT_XXX] . . . . . . . Table 102:Registry cross link [VIEWER] . . . . . . . . . . . . . . . . 424 July 2011
Tables Table 103:Registry cross link [SNA] . . . . . . . . . . . . . . . . . . . Table 104:Registry cross link [SNA_PROJECT] . . . . . . . . . . . . . . . . . . 370 370 371 371 372 373 373 373 374 375 375 376 377
Table 106:Registry cross link [X25] . . . . . . . . . . . . . . . . . . . Table 107:Registry cross link [X25_PROJECT] . . . . . . . . . . . . . Table 108:Registry cross link [TCPIP_PROJECT] . . . . . . . . . . .
Table 109:Registry cross link [TOPMSG] . . . . . . . . . . . . . . . . Table 110:Registry cross link [CUSTMSG] . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 111:Registry cross link [LYNXCI_SCREEN] Table 112:Registry cross link [SCREEN_XXX]
. . . . . . . . . . . . . . . . . . . . .
Table 113:Registry cross link [OPERATOR_SCREENS] Table 114:Registry cross link [APPLICATION_XXX]
. . . . . . . . . .
July 2011
425
Tables
426
July 2011
Figures
Figures
Figure 1: Figure 2: Figure 3: Figure 4: Figure 5: Figure 6: Figure 7: Figure 8: Product Overview . . . . . . . . . . . . . . . . . . . . . ProBase/C Installation Medias . . . . . . . . . . . . . . 31 36 39 285 285 285 286 287
J/Install Installation medias . . . . . . . . . . . . . . . . PARAC Start window . . . . . . . . . . . . . . . . . . . PARAC Update window . . . . . . . . . . . . . . . . . . PARAC Finish window with return code (0) . . . . . . . . PARAC Finish window with error return code . . . . . . . Workbench of PCEDT . . . . . . . . . . . . . . . . . .
July 2011
427
Figures
428
July 2011
Abbreviations
API ARC ASCII ATM CDM CI CRT CSC DDC DES EBCDIC FDK FIT ID IDCU MAC MDS NCR NDC OAR Application Program Interface Application Return Code American Standard Code for Information Interchange Automated Teller Machine Cash Dispenser Module Customization Image Cathode Ray Tube Customer Service Center DIEBOLD Direct Connect (equals 911/912 Protocols) Data Encryption Standard Extended Binary Coded Decimal Interchange Code Function Display Key Financial Institution Table IDentification ID Card Unit Message Authentication Code Modular Delivery System National Cash Register NCR Direct Connect Open Account Relationship
July 2011
429
Abbreviations PAN PC PIN POS QLLC SDLC SNA PU LU SSCP PLU TABS PPF CFGM Primary Account Number Personal Computer Personal Identification Number Point of Sales (Cash Registers) Qualified Logical Link Control Synchronous Data Link Control System Network Architecture Physical Unit Logical Unit System Server Control Point Primary Logical Unit Total Automatic Banking System Parac Parameter File ProCash-NDC/DDC Configuration Manager
430
July 2011
Related publications
Available manuals
Basically all the manuals you need to get information about configurations and functionality of ProCash/DDC, ProConsult/DDC, ProDevice (WOSA), CSC-W32 and AddOn products are available on the product cd. Sub folder: \DOC\NDC-DDC\
ProTopas Module Konstruction Kit Programming Guide Describes the Frameworks of the ProTopas Manager and gives detailed API descriptions for the programmer. With this manual a programmer is able to build up Protopas applications.
July 2011
431
Related publications ProTopas Framework Documentation Programming Guide Gives a global overview about the ProTopas Framework architecture and describes the interaction between the different frameworks. ProTopas Host Protocol and Communication Frameworks ProGramming Guide Describes the APIs of the Communication Frameworks from ProTopas Manager and gives detailed descriptions for the programmer. ProCash/DDC User Guide manual Provides detailed function description about ProCash/DDC operation and DDC Host to terminal and Terminal to Host messages (Write Commands, Function Commands, Operational Commands, Status messages, etc.). ProCash/NDC User Guide manual Provides detailed function description about ProCash/NDC operation and NDC Host to terminal and Terminal to Host messages (Download Commands, Transaction Request and Reply messages, Terminal Commands, Status messages, etc.). ProFlex/NDC-DDC Programming Guide Describes function details of the Addon product ProFlex/NDC-DDC. It gives detailed programming descriptions for developers how to set up the transaction flow and how to install and configure the product for a host connection.
432
July 2011