***************************************************************************
**                 COPYRIGHT (c) 2003 BY TRI-8, INCORPORATED.            ** 
**                    A L L  R I G H T S  R E S E R V E D.               **
***************************************************************************

CHANGELOG -- a listing of significant (or at least interesting) changes.
PLEASE DO NOT FORGET to view the release notes in
$OSC/doc/RELEASE_NOTES.txt for special caveats to any new release.

Version 2.1b [2009/02/23]
   - added support for sub-one-dollar transaction amounts (micropayments)
   - preserve trExec.apprCode after return of CCA_VOICEAUTH transactions 
   - skip OSCBroker connection ENTIRELY if the only card numbers present
     in trExec are the standard locally-faked card numbers
   - round amounts up to the nearest cent


Version 2.1 [2008/11/14]
   - Purchase Card Level III support (CCA_PURCHASE on TSYS only)
   - added new trExec fields for PC III and extended PC II support
     > trExec.vatNo
     > trExec.commodityCode
     > trExec.discount
     > trExec.shipHandling
     > trExec.duty
     > trExec.shipToZip
     > trExec.numLines
     > trExec.productCode
     > trExec.price
     > trExec.lineDiscount
     > trExec.quantity
     > trExec.description
     > trExec.uom
   - added PC II support for ship-to ZIP (via trExec.shipToZip)
   - OSCBrokerSS.jar introduction (Single Settlement option)
   - better log messages for login denied (bad username/password)


Version 2.0d [2005/09/28]
   - OSCBroker.jar update (SSL certificate issue)


Version 2.0c [2005/01/12]
   - bugfix: OSCConfig.devMode interaction with environment variable DEVMODE.
   - bugfix: Purchase Card Level II data error caused non-qualifying 
             transactions.
   - documentation updates, specifically regarding ACH transaction
     monitoring for failures subsequent to transaction submission.


Version 2.0b [2004/11/15]
   - minor internal updates for improved processor response coordination
   - updated trExec.OSCID width specification from "x(10)" to "x(14)" in 
     tri8osc/oscapi 
   - changed CCA_CAPTURE logging to use OSCID instead of transNo
   - "CAPID" now appended to trExec.authDetails on capture, and logged to
     standard log, for added tracking capabilities on captures
   - bugfix: Fixed OSCA_BROKERCHK "Failed on CCA_STATUS" message due to 
             infrastructure changes.
   - bugfix: Fixed incorrect OSCID returned on CCA_QTRANS for CCA_CAPTURed
             transactions (OSCID was assigned the "CAPID," which is merely 
	     a special OSCID for the actual CCA_CAPTURE transaction).

Version 2.0
   - updated documentation
   - added OSC administrative actions OSCA_VERSION and OSCA_BROKERCHK
   - added OSCConfig.brokerHost, OSCConfig.brokerPort
   - RENAMED CCExec to trExec (buffer CCExec provided for backward 
     compatibility)
   - added new trExec (CCExec) fields:
     > trExec.qFromTime
     > trExec.qToTime
     > trExec.currencyCode
     > trExec.PONo
     > trExec.tax
     > trExec.routingNo 
     > trExec.accountNo
     > trExec.CHAddress2
     > trExec.CHCity
     > trExec.CHState
     > trExec.CHPhone
     > trExec.CHEmail
     > trExec.AVSresult
   - added AVS_* result codes:
     > AVS_EXACT_ZIP9
     > AVS_EXACT_ZIP5
     > AVS_STREET_ONLY
     > AVS_ZIP9_ONLY
     > AVS_ZIP5_ONLY
     > AVS_NO_MATCH
     > AVS_UNAVAIL
     > AVS_NONUS_UNAVAIL
     > AVS_ISSUER_DOWN
     > AVS_ERROR_INELIGBLE
     > AVS_NOT_SUPPORTED
     > AVS_GEN_DECL    
   - added OSC_CURR_* currency codes:
     > OSC_CURR_USD
     > OSC_CURR_EUR
     > OSC_CURR_CAD
     > OSC_CURR_GBP
     > OSC_CURR_DEM
     > OSC_CURR_FRF
     > OSC_CURR_JPY
     > OSC_CURR_NLG
     > OSC_CURR_ITL
     > OSC_CURR_CHF
     > OSC_CURR_DZD
     > OSC_CURR_ARP
     > OSC_CURR_AUD
     > OSC_CURR_ATS
     > OSC_CURR_BSD
     > OSC_CURR_BBD
     > OSC_CURR_BEF
     > OSC_CURR_BMD
     > OSC_CURR_BRR
     > OSC_CURR_BGL
     > OSC_CURR_CLP
     > OSC_CURR_CNY
     > OSC_CURR_CYP
     > OSC_CURR_CSK
     > OSC_CURR_DKK
     > OSC_CURR_XCD
     > OSC_CURR_EGP
     > OSC_CURR_FJD
     > OSC_CURR_FIM
     > OSC_CURR_XAU
     > OSC_CURR_GRD
     > OSC_CURR_HKD
     > OSC_CURR_HUF
     > OSC_CURR_ISK
     > OSC_CURR_INR
     > OSC_CURR_IDR
     > OSC_CURR_IEP
     > OSC_CURR_ILS
     > OSC_CURR_JMD
     > OSC_CURR_RUR
     > OSC_CURR_SAR
     > OSC_CURR_XAG
     > OSC_CURR_SGD
     > OSC_CURR_SKK
     > OSC_CURR_ZAR
     > OSC_CURR_KRW
     > OSC_CURR_ESP
     > OSC_CURR_XDR
     > OSC_CURR_SDD
     > OSC_CURR_SEK
     > OSC_CURR_TWD
     > OSC_CURR_THB
     > OSC_CURR_TTD
     > OSC_CURR_TRL
     > OSC_CURR_VEB
     > OSC_CURR_ZMK
     > OSC_CURR_XPD
     > OSC_CURR_XPT
   - added OSC_CURR_MULT_* currency multipliers:
     > OSC_CURR_MULT_USD
     > OSC_CURR_MULT_EUR
     > OSC_CURR_MULT_CAD
     > OSC_CURR_MULT_GBP
     > OSC_CURR_MULT_DEM
     > OSC_CURR_MULT_FRF
     > OSC_CURR_MULT_JPY
     > OSC_CURR_MULT_NLG
     > OSC_CURR_MULT_ITL
     > OSC_CURR_MULT_CHF
     > OSC_CURR_MULT_DZD
     > OSC_CURR_MULT_ARP
     > OSC_CURR_MULT_AUD
     > OSC_CURR_MULT_ATS
     > OSC_CURR_MULT_BSD
     > OSC_CURR_MULT_BBD
     > OSC_CURR_MULT_BEF
     > OSC_CURR_MULT_BMD
     > OSC_CURR_MULT_BRR
     > OSC_CURR_MULT_BGL
     > OSC_CURR_MULT_CLP
     > OSC_CURR_MULT_CNY
     > OSC_CURR_MULT_CYP
     > OSC_CURR_MULT_CSK
     > OSC_CURR_MULT_DKK
     > OSC_CURR_MULT_XCD
     > OSC_CURR_MULT_EGP
     > OSC_CURR_MULT_FJD
     > OSC_CURR_MULT_FIM
     > OSC_CURR_MULT_XAU
     > OSC_CURR_MULT_GRD
     > OSC_CURR_MULT_HKD
     > OSC_CURR_MULT_HUF
     > OSC_CURR_MULT_ISK
     > OSC_CURR_MULT_INR
     > OSC_CURR_MULT_IDR
     > OSC_CURR_MULT_IEP
     > OSC_CURR_MULT_ILS
     > OSC_CURR_MULT_JMD
     > OSC_CURR_MULT_RUR
     > OSC_CURR_MULT_SAR
     > OSC_CURR_MULT_XAG
     > OSC_CURR_MULT_SGD
     > OSC_CURR_MULT_SKK
     > OSC_CURR_MULT_ZAR
     > OSC_CURR_MULT_KRW
     > OSC_CURR_MULT_ESP
     > OSC_CURR_MULT_XDR
     > OSC_CURR_MULT_SDD
     > OSC_CURR_MULT_SEK
     > OSC_CURR_MULT_TWD
     > OSC_CURR_MULT_THB
     > OSC_CURR_MULT_TTD
     > OSC_CURR_MULT_TRL
     > OSC_CURR_MULT_VEB
     > OSC_CURR_MULT_ZMK
     > OSC_CURR_MULT_XPD
     > OSC_CURR_MULT_XPT
   - added ACHA_* actions for ACH support
     > ACHA_PURCHASE
     > ACHA_CREDIT
     > ACHA_STATUS
     > ACHA_QTRANS
   - added ACHS_* status values for ACH support
     > ACHS_ACCEPTED
     > ACHS_DECLINED
     > ACHS_ERR
     > ACHS_SYSERR (same as CCS_SYSERR, as SYS/SUB ERRs are independent)
     > ACHS_SUBERR (same as CCS_SUBERR)
   - bugfix: fixed socket buffering condition that could lead to "bfx" 
             errors on large CCA_QTRANS data sets (effective workaround 
	     had been to increase -s paramater on Progress startup)
   - added OSCConstChar (OSC constant to char utility function, which is
                         actually an alias for CCChar, expanded)
   - added OSCConstEnglish (OSC constant to English description utility 
                            function, which is actually an alias for 
			    CCEnglish, expanded)
   - added OSCConstEnglish (OSC constant to English description utility 
                            function, which is actually an alias for 
			    CCEnglish, expanded)
   - added OSCConstEnglishAbbr (OSC constant to English (abbreviated)
                                description utility function, which is 
				actually an alias for CCEnglishAbbr, 
				expanded)
   - added maskVal() function, which allows easy value masking, such as
     masking credit card numbers (e.g. "1234567890123456" becomes
     "XXXXXXXXXXXX3456")
   - added trExec.timeout default value.  If a trExec record is created 
     but no value is supplied for the timeout, the OSCConfig.defaultTimeout
     value will be used.
   - added ACH test numbers: routingNo 789456124 and accountNo 00000 
     returns ACHS_DECLINED
   - added ACHRoutingMask, ACHAccountMask (can be called for default 
     maskings of routing and account numbers)
   - RENAMED OSCConfig.CCTimeout to OSCConfig.defaultTimeout
   - DELETED CCA_VOID, CCS_VOID
   - DELETED CCA_SETTLEBT
   - DELETED OSCConfig.host and OSCConfig.port
   - DELETED trExec.batchItemNo
   - DELETED trExec.recType
   - DELETED OSC_TYPE_TRANSACTION
   - DELETED OSC_TYPE_SETTLEMENT
   - major infrastructure overhaul, optimization and advancement, including
     triple-redundancy plus increased speed and throughput 
   - introduced OSCBroker for maximum reliability and 2048-bit encryption

Version 1.1b
   - updated documentation
   - bugfix: multi-merchant support for CCA_STATUS command incorrectly omitted
             trExec.username and trExec.password on multi-merchant calls

Version 1.1
   - added warning to trExec.authStatus in demo mode
   - added support for CCA_VOID
   - added CCS_VOID status
   - added trackdata support (trExec.trackData)
   - added standard predictable responses, regardless of mode and regardless
     of network: 0409, 0509, 0609 (expDate) w/ cardno = 4012888888881
   - internal performance optimizations
   - trExec-level multi-merchant support (trExec.username, trExec.password)
   - added enhanced logging 


Version 1.0.1
   - minor documentation updates
   - test CC number update
   - license updates
   - new demo OneStep Charge Engine host as default in tri8osc/oscapi

Version 1.0
   - initial public release