RE2206: IBM SurePOS ACE Programming What You Should Know About V4 and V5

RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5 RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and ...
Author: Colin Nichols
36 downloads 2 Views 60KB Size
RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5

RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5 November 2006 This course update covers the new features and enhancements that were added in IBM SurePOS Application Client/Server Environment (ACE) Version 4 and the new feature that was added to SurePOS ACE Version 5. These features and enhancements do not change the mechanics of programming SurePOS ACE; however, this information can be valuable if you will be programming in these areas of SurePOS ACE. Throughout this course, we refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference and IBM SurePOS Application Client/Server Environment for 4690 OS Planning and Installation Guide. To view these resources, go to the IBM Retail Store Solutions Web site at www.ibm.com/products/retail. Once you are at the site, click Support from the left-hand pane, then click Publications under the Popular Links category, and then click SUREPOS under the Applications heading. Select the appropriate Version 4 or Version 5 manual that you wish to view.

New features (Version 4) The new features in SurePOS ACE Version 4 are the pharmacy interface and terminal off-line (TOF) functions. Pharmacy interface The pharmacy interface is an application that provides increased functionality between any pharmacy application (using the Chain Drug file format) and ACE. The pharmacy interface allows communication between the pharmacy application and ACE. Log adx_ipgm:diflog captures the Data Integration Facility (DIF) pharmacy actor logging for the default ACE pharmacy interface executing under DIF. The new TS and CS pharmacy extensions create new application events. The new events are: •

X525 UNABLE TO UPDATE PHARMACY APPLICATION WITH RX INFORMATION



X526 PHARMACY INTERFACE CONFIGURATION ERROR



X527 UNABLE TO RETREIVE RX INFORMATION FROM PHARMACY APPLICATION



X528 UNABLE TO INITIALIZE COMMUNICATIONS

Page 1 of 6

RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5



X529 ERROR SENDING MESSAGE TO PHARMACY APPLICATION



X530 ERROR RECEIVEING MESSAGE FROM PHARMACY APPLICATION



X531 DID NOT RECEIVE MESSAGE FROM PHARMACY APPLICATION

For complete programming details, please refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4 and see the Description of ACERXFIL and Appendix item Extending SurePOS ACE. TOF The TOF function provides the ability to continue ringing sales transactions and complete some nonsales functions while off-line from the controller. When the terminal is back online with the controller, summary and detailed sales information is logged to the controller to account for the off-line activity. While a terminal is in TOF mode, transaction data is stored on the terminal in the eamtlog.dat file. If the Transaction Summary Log is not valid when the terminal IPLs, the eamtlog.dat file is appended to eamtlxxx.dat (xxx is the terminal number) on the locally attached controller. For additional TOF details, please refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4 and the IBM SurePOS Application Client/Server Environment for 4690 OS Planning and Installation Guide Version 4.

Page 2 of 6

RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5

Application Enhancements (Version 4) The application enhancements in SurePOS ACE Version 4 added functions that increased customer usability and satisfaction. The enhancements that are relative to the programming functions are: • • • • • •

Fuel integration alternate pricing Open department key Tender variety key Log Women, Infants, Children (WIC) card errors VISA's Payment Card Industry Data Security Standard Bank Identification Number file rebuild application

Fuel integration alternate pricing The alternate pricing function allows customers to set two separate prices for the same product. When using an alternate price, an alternate department can be assigned for the alternate price. If a terminal sells an item using the alternate price, the sale will be logged against the alternate department number. To display the alternate pricing details for the Selective Item Report, an overlay file for aceslird.ini must be created and installed in the ADX_IPGM directory. For details please refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4 and search for ViewDualP. For details about the Item Record file layouts for the variety of byte sizes that are available, refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4, Chapter 2, "Descriptions of Files and Records under EAMITEMR (Item Record File) > Basic Item Record File Layouts." Open department key The open department key allows for a generic terminal key (DEPTKEY) to be added to the terminal keyboard. This key allows up to 999 department numbers to be defined for lookup capabilities. The open department key works like any other lookup key and reduces the number of specific department lookup keys required on a keyboard at the terminal. To use the open department key, perform the following steps: 1. Add a physical key to the terminal keyboard. 2. Add the 240 key to your terminal layout and the State Definition Table if you are migrating from a version prior to Version 4. 3. Complete the Department Key page under personalization.

Page 3 of 6

RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5

The State Definition Table The State Definition Table defines the key sequences allowed at the terminals by ACE. The default State Definition Table supplied with ACE is EAMS@000. This default State Definition Table is located on the installation CD. Update the State Definition Table For instructions on how to update the State Definition Table and program the terminal keys, refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4 in Appendix D: Keys on the Terminal Keyboard. Additional information about the State Definition Tables can be found in the IBM 4690 OS Programming Guide Version 4 Release 1. Tender variety key The tender variety key feature allows additional tender functions to be mapped to a single key. This feature allows other variety codes, such as 2 for a payroll check, to be mapped to a single terminal key. New validation ranges can be added to the OPTNPARM.INI file. Adding the new ranges requires modifying the InputValidation Section (optnparm.us9). For additional details and an example, refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4, Chapter 4. See the .ini File Descriptions under OPTNPARM (Options) > InputValidation Section. Log WIC card errors WIC electronic benefits transfer (EBT) card errors are now recorded while processing a balance inquiry transaction. If an error occurs during a balance inquiry transaction, an entry is added to the transaction and exception logs. The error string is written to the Transaction Log as part of the WIC EBT Balance Inquiry nonsales transaction. The error string is also written to the Exception Log. For additional information about the WIC EBT Data String (0x80), refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4, Chapter 2, "Descriptions of Files and Records > EAMTRAN* (Transaction Summary Log) > WIC EBT Data String (0x80)." VISA's Payment Card Industry Data Security Standard ACE Electronic Payment Support (EPS) has been enhanced to accommodate selected requirements defined in VISA's Payment Card Industry Data Security Standard (Version 1.0). A new field has been added to the end of the 16 string in the Transaction Log for transaction recovery. The new field is EntryMethodSecondID and is used if a

Page 4 of 6

RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5

second ID is presented during a sales transaction. If a second ID is not presented during the transaction, the field will be blank. • •

Field type = ACSII Field length = 1

For complete details, refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4, Chapter 2, "Descriptions of Files and Records > EAMTRAN* (Transaction Summary Log) > SurePOS ACE EPS Tender String (0x16)." BIN file rebuild application To use Personal Identification Number (PIN) encouragement with the ACE application, a BIN file is required for verifying account numbers that determine dual-purpose cards. The ACE application contains the ACEBIRBL (BIN file rebuild) utility which uses an ASCII input file to create a keyed BIN file that can be used by ACE for the PIN encouragement feature. For additional information and explanations about the files used and affected by the ACEBIRBL utility, refer to the sources below which can be found in the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 4. •

How the ACEBIRBL utility works and creates a new BIN file can be found in Appendix A: Setting up the Development Environment under Using ACEBIRBL to Rebuild BIN Files.



ACEBINFL is the BIN file generated by ACEBIRBL. An explanation of the record format is described in Chapter 2 "Descriptions of Files and Records under ACEBINFL (BIN File)."



ACEBINLG.INI is a resource file that contains the execution details for the ACEBIRBL utility. For additional details about this file and its contents, refer to Chapter 2 "Descriptions of Files and Records under ACEBINLG (ACEBIRBL Log File)."



ACEBNRSR.INI is the resource file that is used to control the text used in the background messages for the ACEBIRBL utility. For additional details about this file and its contents, refer to Chapter 4 ".ini File Descriptions under ACEBINLG (BIN Report Log)."

Page 5 of 6

RE2206: IBM SurePOS™ ACE Programming – What You Should Know About V4 and V5

New features (Version 5) Dump on exception The new dump on exception feature enables the user to disable the 4690 OS Application Dump Flag on the controller and selectively choose which ACE processes may cause a controller storage dump when an uncaught exception occurs. This can help the retailer more closely manage the conditions that can trigger a controller dump, which can help improve overall system availability. Enabling new .386 applications to support dump on exception As long as the code is enabled (that is, dumpex is not excluded), all programs built for 4690 will be enabled for the dump on exception function. To enable the function for your own executables, just add appropriate entries to an acedmp.usx overlay file following the same process as you would use for enabling base programs. To activate dump on exception for all ACE built processes, the overlay file would contain: [Globals] DumpOnException=Y [acecsmll] DumpOnException=Y

Both sections and DumpOnException keywords must be present to override settings for all applications, as well as ACECSMLL. For additional information about the dump on exception function, refer to the IBM SurePOS Application Client/Server Environment for 4690 OS Programming Reference Version 5, Appendix C: Extending SurePOS ACE.

Page 6 of 6