jPOS Programmer’s Guide

1 jpos Programmer s GuideRevision: of ContentsCopyright notice .. viPreface .. vii1. The jpos Project .. About .. jpos License .. About ISO-8583 .. Downloading jpos .. Directory structure .. Using jpos .. Building jpos .. Available tasks .. Running jpos .. 52. About ISO-8583 .. An ISO-8583 primer .. International standard ISO 8583 .. Message format .. Wire protocol .. Message flow .. jpos approach to ISO-8583.

2 ISOMsg & Co.. Packing and unpacking .. Creating custom packagers .. Managing the wire protocol with ISOC hannel .. Accepting connections with ISOS erver .. Multiplexing an ISOC hannel with a MUX .. IncomingListener .. 253. Support classes .. jpos ' Logger .. NameRegistrar .. Configuration .. SystemMonitor .. Profiler .. DirPoll .. ThreadPool .. 374. Packagers .. Implementing Custom Packagers .. GenericPackager .. 385.

3 Channels .. TCP/IP Socket-based channels .. SSL Channels .. LoopbackChannel .. ChannelPool .. Channel Filters .. MD5 Filter .. ChannelInfoFilter .. DelayFilter .. DebugFilter .. ThroughputControlFilter .. BSHF ilter .. Aditional filters .. 476. jpos Space .. Space interface .. Local Space interface .. Space Factory .. TSpace .. JDBMS pace .. JESpace .. 52jPOS Programmer s SpaceInterceptor.

4 SpaceTap .. SpaceUtil .. 537. Q2 .. Running Q2 .. Command line options .. Embedding Q2 .. Shutting down Q2 .. Writing your first Q2 Script .. QTest - a sample QBean .. QBeanSupport .. Dynamic classloading .. 708. Q2 jpos Services .. ChannelAdaptor .. QBean descriptor .. Handling alternate connections .. Channel timeout, keep-alive, connection-timeout .. OneShotChannelAdaptor .. QBean descriptor .. QMUX.

5 QBean descriptor .. MTI mapping and default key .. QServer .. QBean descriptor .. 799. TransactionManager .. TransactionConstants .. Transaction Context .. Context Recovery Interface .. Assembly Line .. AbortParticipant .. GroupSelector .. TransactionManager implementation .. TM use of spaces .. Configuration .. TransactionStatusListener .. Transaction Participants .. Switch participant .. CheckFields participant.

6 SelectDestination .. QueryHost .. SendResponse .. JSParticipant .. Pause .. 9810. ResultCode .. CMF .. Result holder class .. 101A. Getting involved .. 102B. License .. 103ivList of ISO-8583 message structure .. Sample 0800 message .. Primary Bitmap .. Another 0800 message .. Primary Bitmap .. Secondary Bitmap .. Sample authorization .. Authorization timeout .. Sample authorization request.

7 Sample authorization response .. ISOF ieldPackagers .. Sample ISOC hannel implementations .. IncomingListener Configuration Properties .. Logger s main classes .. LogListener .. NameRegistrar s prefix .. Space Names .. OneShotChannelAdaptor Attributes.. TransactionConstants .. AssemblyLine .. Switch participant Configuration Properties .. CheckFields Configuration Properties .. SelectDestination Configuration Properties .. QueryHost Configuration Properties.

8 SendResponse Configuration Properties .. 97vList of ISOC hannel example .. ISOS erver .. MUX example .. Profiler .. DirPoll Processor .. ISO-8583 version 1993 packager implementation .. ISO-8583 version 1993 packager configuration .. SocketFactory configuration .. Using the SpaceFactory .. Sample TSpace use .. Sample GroupSelector implementation .. jpos Team .. 102viCopyright noticeCopyright 1998-2017 by jpos Software SRL, Uruguay. All rights reserved.

9 No part of this book may be reproduced in anyform or by any electronic or mechanical means, including information storage and retrieval systems, without permission inwriting from jpos Software SRL, except by a reviewer who may quote brief passages in a document covers jpos 1. The jpos About jpos project is hosted at In order to stay up-to-date with jpos news, you may want to visitthe project s main page, as well as its blog at For an up to date list of project resources, youcan visit the page. There s also a low traffic jpos News mailing list where we postimportant announcements, such as a the availability of new versions of this Guide .

10 You re encouraged to registerby visiting the project s main page at is hosted at may also want to follow us on Twitter, where we keep a list of users who regularly tweet about jpos at@apr/lists/ jpos [ ].In addition, you may want to subscribe to our users' mailing list [ ].Commit notifications can be tracked by following @jposcommits [ ].We are also active on Slack [ ]. Please request an invitation via e-mail to you happen to tweet about jpos , please use the hash tag # jpos so we can follow jpos LicensejPOS is distributed under the GNU Affero General Public License version NOTICEIf you don t plan to release your jpos based application under a compatible license (see FAQ [ ] where you can find a licensecompatibility matrix) you need to buy a commercial license (you can contact us using the contactform [ ]).