DIN CWA 14050-22-2001 en 2528 Extensions for Financial Services (XFS) interface specification - Release 3 0 - Part 22 Text terminal unit device class interface Migration from Versi.pdf

1、April 2001Extensions for Financial Services (XFS) interface specification Release 3.0 Part 22: Text Terminal Unit Device ClassInterface Migration from Version 2.0 (see CWA 13449) toVersion 3.0 (this CWA) Programmers ReferenceCWA 14050-22Englische Fassung CWA 14050-22:2000ICS 35.200; 35.240.40Erweite

2、rungen fr die Schnittstellenspezifikation fr Finanzdienst-leistungen (XFS) Version 3.0 Teil 22: Schnittstelle fr die Gerteklasse “Textterminals“ Migration von Version 2.0 (siehe CWA 13449) zu Version 3.0(dieses CWA) ProgrammierhandbuchNationales VorwortDieses CEN Workshop Agreement CWA 14050-22, das

3、 vom CEN/ISSS XFS Workshop erarbeitet wurde,wird ausschlielich in englischer Sprache zur Verfgung gestellt.CEN Workshop Agreements werden im Rahmen eines Konsortiums entwickelt. Sie unterscheiden sich vonEuropischen Normen dadurch, dass sie grundstzlich kein ffentliches Einspruchsverfahren durchlauf

4、enund dass auch keine nationale Meinungsbildung stattfindet. Im Gegensatz zu Europischen Normen, dieden Konsens aller interessierten Kreise darstellen, haben CEN Workshop Agreements lediglich dieZustimmung der unmittelbar beteiligten Mitglieder des Konsortiums gefunden.Fr den Inhalt sind ausschlieli

5、ch die Mitglieder des Konsortiums verantwortlich (siehe ergnzendeHinweise im CWA-Vorwort). Weder das CEN-Zentralsekretariat, noch die CEN-Mitglieder haben den Inhaltauf eventuelle Fehler oder Widersprche zu Normen und Rechtsvorschriften geprft.Fortsetzung 28 Seiten CWA Beuth Verlag GmbH, 2001 .Jede

6、Art der Vervielfltigung, auch auszugsweise, Ref. Nr. DIN CWA 14050-22:2001-04nur mit Genehmigung des Beuth Verlages gestattet. RW DIN CWA Preisgr. 05Alleinverkauf der Normen durch Beuth Verlag GmbH, 10772 BerlinB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Leerseite B55EB1B3E1

7、4C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Rue de Stassart, 36 B-1050 BruxellesTel : +32 2 550 08 11 Fax : +32 2 550 08 19EUROPEAN COMMITTEE FOR STANDARDIZATION COMIT EUROPEN DE NORMALISATION EUROPISCHES KOMITEE FR NORMUNG WORKSHOPCWA 14050-22AGREEMENTNovember 2000ICS 35.200; 35.240.

8、40Extensions for Financial Services (XFS) interface specification -Release 3.0 - Part 22: Text Terminal Unit Device Class Interface -Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers Reference 2000 CEN All rights of exploitation in any form and by any means reserved w

9、orld-wide forCEN National MembersRef. No CWA 14050-22:2000 EThis CEN Workshop Agreement can in no way be held as being an official standardas developed by CEN National Members.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 2CWA 14050-22:2000Table of ContentsForeword 31. Ge

10、neral 52. New Chapters 52.1 References . 52.2 XFS form/media definition files in multi-vendor environments 53. New Info Commands 53.1 WFS_INF_TTU_KEY_DETAIL . 54. Changes to existing Info Commands . 74.1 WFS_INF_TTU_STATUS . 74.2 WFS_INF_TTU_CAPABILITIES. 94.3 WFS_INF_TTU_QUERY_FORM 104.4 WFS_INF_TT

11、U_QUERY_FIELD 115. New Execute Commands. 125.1 WFS_CMD_TTU_RESET . 126. Changes to existing Execute Commands 136.1 WFS_CMD_TTU_CLEARSCREEN 136.2 WFS_CMD_TTU_WRITE_FORM (former WFS_CMD_TTU_DISPLAY_FORM) . 136.3 WFS_CMD_TTU_READ_FORM 146.4 WFS_CMD_TTU_WRITE . 156.5 WFS_CMD_TTU_READ. 167. New Events .

12、197.1 WFS_EXEE_TTU_FIELDERROR 197.2 WFS_EXEE_TTU_FIELDWARNING 207.3 WFS_EXEE_TTU_KEY 208. Changes to existing Events. 219. Changes to Form and Field Definitions . 219.1 Definition Syntax . 219.2 Field Definition . 2210. Changes to C - Header file. 23B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9Norm

13、CD - Stand 2007-03 Page 3CWA 14050-22:2000ForewordThis CWA is revision 3.0 of the XFS interface specification.The move from an XFS 2.0 specification (CWA 13449) to a 3.0 specification has been prompted by a series of factors.Initially, there has been a technical imperative to extend the scope of the

14、 existing specification of the XFS Manager toinclude new devices, such as the Card Embossing Unit.Similarly, there has also been pressure, through implementation experience and the advance of the Microsofttechnology, to extend the functionality and capabilities of the existing devices covered by the

15、 specification.Finally, it is also clear that our customers and the market are asking for an update to a specification, which is now over 2years old. Increasing market acceptance and the need to meet this demand is driving the Workshop towards this release.The clear direction of the CEN/ISSS XFS Wor

16、kshop, therefore, is the delivery of a new Release 3.0 specification basedon a C API. It will be delivered with the promise of the protection of technical investment for existing applications andthe design to safeguard future developments.The CEN/ISSS XFS Workshop gathers suppliers as well as banks

17、and other financial service companies. A list ofcompanies participating in this Workshop and in support of this CWA is available from the CEN/ISSS Secretariat.This CWA was formally approved by the XFS Workshop meeting on 2000-10-18. The specification is continuouslyreviewed and commented in the CEN/

18、ISSS Workshop on XFS. It is therefore expected that an update of thespecification will be published in due time as a CWA, superseding this revision 3.0.The CWA is published as a multi-part document, consisting of:Part 1: Application Programming Interface (API) - Service Provider Interface (SPI); Pro

19、grammers ReferencePart 2: Service Classes Definition; Programmers ReferencePart 3: Printer Device Class Interface - Programmers ReferencePart 4: Identification Card Device Class Interface - Programmers ReferencePart 5: Cash Dispenser Device Class Interface - Programmers ReferencePart 6: PIN Keypad D

20、evice Class Interface - Programmers ReferencePart 7: Check Reader/Scanner Device Class Interface - Programmers ReferencePart 8: Depository Device Class Interface - Programmers ReferencePart 9: Text Terminal Unit Device Class Interface - Programmers ReferencePart 10: Sensors and Indicators Unit Devic

21、e Class Interface - Programmers ReferencePart 11: Vendor Dependent Mode Device Class Interface - Programmers ReferencePart 12: Camera Device Class Interface - Programmers ReferencePart 13: Alarm Device Class Interface - Programmers ReferencePart 14: Card Embossing Unit Class Interface - Programmers

22、ReferencePart 15: Cash In Module Device Class Interface- Programmers ReferencePart 16: Application Programming Interface (API) - Service Provider Interface (SPI) - Migration from Version 2.0 (seeCWA 13449) to Version 3.0 (this CWA) - Programmers ReferencePart 17: Printer Device Class Interface - Mig

23、ration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers ReferenceB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 4CWA 14050-22:2000Part 18: Identification Card Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA

24、) - Programmers ReferencePart 19: Cash Dispenser Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 20: PIN Keypad Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA)- Programmers Referenc

25、ePart 21: Depository Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers ReferencePart 22: Text Terminal Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 23: Sensors an

26、d Indicators Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version3.0 (this CWA) - Programmers ReferencePart 24: Camera Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers ReferencePart 25: Identification Card Devic

27、e Class Interface - PC/SC Integration GuidelinesIn addition to these Programmers Reference specifications, the reader of this CWA is also referred to a complementarydocument, called Release Notes. The Release Notes contain clarifications and explanations on the CWA specifications,which are not requi

28、ring functional changes. The current version of the Release Notes is available online fromhttp:/www.cenorm.be/isss/Workshop/XFS.The information in this document represents the Workshops current views on the issues discussed as of the date ofpublication. It is furnished for informational purposes onl

29、y and is subject to change without notice. CEN/ISSS makesno warranty, express or implied, with respect to this document.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 5CWA 14050-22:20001. GeneralUNICODE support for field values, key stroke events during text entry and a fe

30、w clarifications have been added.For all commands, the error code and event sections have been amended to explicitly mention that the generic valuesfrom the API document can also be returned.2. New Chapters2.1 References1. XFS Application Programming Interface (API)/Service Provider Interface ( SPI)

31、, Programmers ReferenceRevision 3.0, October 18, 20002.2 XFS form/media definition files in multi-vendor environmentsAlthough for most Service Providers directory location and extension of XFS form/media definition files areconfigurable through the registry, the capabilities of Service Providers and

32、 or actual hardware may vary. Therefore thefollowing considerations should be taken into account when applications use XFS form definition files with the purposeof running in a multi-vendor environment:- Physical display area dimensions may vary from one text terminal to another- Just-in-time form l

33、oading may not be supported by all Service Providers, which makes it impossible to createdynamic form files just before displaying them (which in return means that only the display data of the forms can bechanged, not the -layout data such as field positions)- Some form/media definition keywords may

34、 not be supported due to limitations of the hardware or software3. New Info Commands3.1 WFS_INF_TTU_KEY_DETAILDescription This command returns information about the Keys (buttons) supported by the device.This command should be issued to determine which Keys are available.Input Param None.Output Para

35、m LPWFSTTUKEYDETAIL lpKeyDetail;typedef struct _wfs_ttu_key_detailLPSTR lpszKeys;LPWSTR lpwszUNICODEKeys;LPWORD lpwCommandKeys; WFSTTUKEYDETAIL, * LPWFSTTUKEYDETAIL;lpszKeysString which holds the printable characters (numeric and alphanumeric keys) on the Text TerminalUnit, e.g. “0123456789ABCabc ”

36、if those text terminal input keys are present. This string is aNULL pointer if capability fwCharSupport equals WFS_TTU_UNICODE or if no keys of this typeare present on the device.lpwszUNICODEKeysString which holds the numeric and alphanumeric keys on the Text Terminal Unit like lpszKeys butB55EB1B3E

37、14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 6CWA 14050-22:2000in UNICODE format. This string is a NULL pointer if capability fwCharSupport equalsWFS_TTU_ASCII or if no keys of this type are present on the device.lpwCommandKeysArray of command keys on the Text Terminal Unit. The

38、array is terminated with a zero value. Thisarray is a NULL pointer if no keys of this type are present on the device.WFS_TTU_CK_ENTERWFS_TTU_CK_CANCELWFS_TTU_CK_CLEARWFS_TTU_CK_BACKSPACEWFS_TTU_CK_HELPWFS_TTU_CK_00WFS_TTU_CK_000WFS_TTU_CK_ARROWUPWFS_TTU_CK_ARROWDOWNWFS_TTU_CK_ARROWLEFTWFS_TTU_CK_ARR

39、OWRIGHTThe following values may be used as vendor dependent keys.WFS_TTU_CK_OEM1WFS_TTU_CK_OEM2WFS_TTU_CK_OEM3WFS_TTU_CK_OEM4WFS_TTU_CK_OEM5WFS_TTU_CK_OEM6WFS_TTU_CK_OEM7WFS_TTU_CK_OEM8WFS_TTU_CK_OEM9WFS_TTU_CK_OEM10WFS_TTU_CK_OEM11WFS_TTU_CK_OEM12The following keys are used for Function Descriptor

40、Keys.WFS_TTU_CK_FDK01WFS_TTU_CK_FDK02WFS_TTU_CK_FDK03WFS_TTU_CK_FDK04WFS_TTU_CK_FDK05WFS_TTU_CK_FDK06WFS_TTU_CK_FDK07WFS_TTU_CK_FDK08WFS_TTU_CK_FDK09B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 7CWA 14050-22:2000WFS_TTU_CK_FDK10WFS_TTU_CK_FDK11WFS_TTU_CK_FDK12WFS_TTU_CK_

41、FDK13WFS_TTU_CK_FDK14WFS_TTU_CK_FDK15WFS_TTU_CK_FDK16WFS_TTU_CK_FDK17WFS_TTU_CK_FDK18WFS_TTU_CK_FDK19WFS_TTU_CK_FDK20WFS_TTU_CK_FDK21WFS_TTU_CK_FDK22WFS_TTU_CK_FDK23WFS_TTU_CK_FDK24WFS_TTU_CK_FDK25WFS_TTU_CK_FDK26WFS_TTU_CK_FDK27WFS_TTU_CK_FDK28WFS_TTU_CK_FDK29WFS_TTU_CK_FDK30WFS_TTU_CK_FDK31WFS_TTU

42、_CK_FDK32Error Codes Only the generic error codes defined in Ref. 1 can be generated by this command.Comments None.4. Changes to existing Info Commands4.1 WFS_INF_TTU_STATUSDescription This command reports the full range of information available, including the information that isprovided by the serv

43、ice provider.Input Param None.Output Param LPWFSTTUSTATUS lpStatus;B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 8CWA 14050-22:2000typedef struct _wfs_ttu_statusWORD fwDevice;WORD wKeyboard;WORD wKeyLock;WORD wLEDsWFS_TTU_LEDS_MAX;WORD wDisplaySizeX;WORD wDisplaySizeY;LPS

44、TR lpszExtra; WFSTTUSTATUS, * LPWFSTTUSTATUS;fwDeviceSpecifies the state of the text terminal unit as one of the following flags:Value MeaningWFS_TTU_DEVONLINE The device is on-line (i.e., powered on and operable).WFS_TTU_DEVOFFLINE The device is off-line (e.g., the operator has taken the deviceoffline by turning a switch or pulling out the device).WFS_TTU_DEVPOWEROFF The device is powered off or physically not connected.WFS_TTU_DEVBUSY The device is busy and unable to process an executecommand at this time.WFS_TTU_DEVNODEVICE There is no device intended to be there; e.g. this type