PSS 5000

Application Note

Extended Transaction Size

Date July 6, 2012

Document number PSS5000/APNO/804739/00

Doms A/S Formervangen 28 Tel. +45 4329 9400 info@doms.dk

DK-2600 Glostrup Fax +45 4343 1012 www.doms.com
 PSS 5000 Application Note
Extended Transaction Size

Table of Contents
1 Scope ............................................................................................................. 3
2 References ..................................................................................................... 3
3 Description .................................................................................................... 4
4 Compatibility ................................................................................................. 5
5 DPP Chapter A .............................................................................................. 7
5.1 FcLogon ................................................................................................ 7
5.2 load_FcPriceSet .................................................................................... 7
5.3 FcPriceSet_req ...................................................................................... 7
5.4 BackOfficeRecord_req ......................................................................... 7
6 DPP Chapter B............................................................................................... 8
6.1 install_Fp .............................................................................................. 8
6.2 FpStatus ................................................................................................ 8
6.3 authorize_fp_with_preset ...................................................................... 8
6.4 extended_authorize_fp .......................................................................... 8
6.5 prepare_prepaid_trans ........................................................................... 8
6.6 extended_prepare_trans ........................................................................ 9
6.7 FpFuellingData_req ............................................................................ 10
6.8 FpSupTransBufStatus ......................................................................... 10
6.9 FpSupTrans ......................................................................................... 10
6.10 FpUnSupTransBufStatus .................................................................... 10
6.11 FpUnSupTrans .................................................................................... 10
6.12 clr_FpSupTrans................................................................................... 10
6.13 clr_FpUnSupTrans .............................................................................. 10
6.14 change_FcParameters ......................................................................... 11
6.14.1 Fuelling Modes .......................................................................... 11
6.14.2 FloorLimitMargin ...................................................................... 11
6.14.3 GlobalFuellingLimits ................................................................. 11
6.15 FcParameterSet_req ............................................................................ 12
7 DPP Chapter E ............................................................................................. 12
7.1 accept_EptSeq ..................................................................................... 12
7.1.1 sales_pars ................................................................................... 12
7.1.2 EptSeqDataItems (RcpItems) ..................................................... 12
7.2 clr_EptSeq........................................................................................... 12
8 History ......................................................................................................... 13

PSS5000/APNO/804739/00 Page 2 of 13
 PSS 5000 Application Note
Extended Transaction Size

1 Scope
Extended Transaction Size (ETS) refer transactions with up to 10 digits for
volume and money. Price can be up to 6 digits. The Standard Transaction Size
(STS), which is used in most system with PSS, is 6-6-4 digits.

Scope for this document is to describe how to build or upgrade systems to use
the ETS as supported by PSS.

Please notice, that extended transaction size touches areas which do have
the interest of the Weight and Measures in various countries and some
approvals might have to be updated.

Changes in W&M functionality and approvals will be handled separately when

needed.

2 References
Following references to external documents are used throughout this
document.

[1] Doms POS Protocol, Application Level, Control Functions

All vol, money and price parameters supporting the Extended Transaction Size
use the extension “_e”; e.g. Price_e and PrepaidAmount_e.

PSS5000/APNO/804739/00 Page 3 of 13
 PSS 5000 Application Note
Extended Transaction Size

3 Description
As the fuel has become more expensive, the cost for filling a car with a big
fuel tank (typically a truck) has exceeded what can be displayed by a standard
display of many pumps and transaction sizes by many POS systems and
forecourt controllers.

Pump manufacturers active in the markets where this is a problem typically

have updated their pumps with

1. physically displays with more digits

2. updated interface protocol with data formats to support bigger
transactions

A number of these updated protocols are now supported by PSS and others
will be added when needed.

An alternative to update the pumps as describe above is to modify1 an exist

pump to operate with the comma shifted to the right compared to standard
configuration. It’s possible to configured PSS to compensate for such non-
standard decimal point setting for individual pumps during installation, by
specifying to the PSS how it should interpret the digits in the protocol. See
paragraph 6.1.

If the comma e.g. is shifted 1 to the right, it’s possible to handle transactions
which are 10 times bigger.

1
configuration, software or physical change depending on pump

PSS5000/APNO/804739/00 Page 4 of 13
 PSS 5000 Application Note
Extended Transaction Size

4 Compatibility
With relation to ETS the PSS has been updated in different steps in the
following areas

1. Doms POS Protocol has been updated to support ETS data formats for
transaction related parameters.

2. PSS core has been updated to operate with ETS transactions

3. Pump Protocols are updated to handle ETS transactions when needed

for specific projects

4. Fuelling Point configuration has been updated to support pumps with

non-default decimal point setting

The extended data formats are supported by most PSS Applications, which are
newer than February 2010, where Doms POS Protocol was updated for the
first project where ETS was needed. The idea is that new implementations of
Doms POS Protocol should use the new extended data formats, even before
the controller actually could operate with bigger transactions. In case such a
new application (typically a POS) needs to work on a site which is using an
old PSS application, which does not support ETS data formats, the PSS should
be updated with a new application.

A new application can check if PSS supports the extended data formats
by trying to logon with the parameter “UNSO_TRBUFSTA_3” (see
paragraph 6.8), as this will be rejected by controllers not supporting ETS
data formats.

The ability to actually support bigger transactions has been added gradually in
PSS applications where it has been needed. The Appendix for the specific PSS
Application will tell

NoDigitsInMoney = 10
NoDigitsInVol = 10
NoDigitsInPrice =6

if the controller supports ETS transactions.

A controller with the capability to work with ETS has from factory default
global limits that limit transactions to a size that can be handled with the old
data formats. For a controller which doesn’t support ETS, it will not be
possible to change the Global limits or Fuelling Mode limits beyond values
which can be handled by the STS data formats.

An attempt to change the Global Limits beyond what is supported by the

controller will be rejected. Please note that this message will also be
rejected if any installed Fuelling Points are open. See paragraph 6.14.1.

PSS5000/APNO/804739/00 Page 5 of 13
 PSS 5000 Application Note
Extended Transaction Size

An attempt to change Fuelling Mode parameters for max transaction

size beyond what hand be handle by the STS data formats will be
rejected. See paragraph 6.14.1

It’s the responsibility of the integrator to make sure that all relevant system
components are updated to support ETS, before the limits are raised beyond
STS.

PSS5000/APNO/804739/00 Page 6 of 13
 PSS 5000 Application Note
Extended Transaction Size

5 DPP Chapter A
5.1 FcLogon

FcLogon is used by different clients to tell PSS which version of an unsolicited

message the client wants to receive and the extended data format also have
resulted in new versions of unsolicited messages.

1. FpSupTransBufStatus (see paragraph 6.8)

2. FpUnSupTransBufStatus (see paragraph 6.10 )
3. FpStatus (see paragraph 6.2)

5.2 load_FcPriceSet

A new message with SUBC 02 is introduced for the price_e data format.

5.3 FcPriceSet_req

The new message with new SUBC 02 is introduced for the price_e data
format.

5.4 BackOfficeRecord_req

BackOfficeRecord are project specific and updating with new ParId’s will be
handled on project basis.

PSS5000/APNO/804739/00 Page 7 of 13
 PSS 5000 Application Note
Extended Transaction Size

6 DPP Chapter B
6.1 install_Fp

A new variant of install_Fp using SUBC 03 has been introduced. It can be

used provide a list of installation parameters for a Fuelling Point, e.g.

PumpDecimalPositionInMoney
PumpDecimalPositionInVolume
PumpDecimalPositionInPrice
PumpDecimalPositionInMoneyTotal
PumpDecimalPositionInVolTotal

These parameters can be used to configure a Fuelling Point to match a pump

which is using decimal point setting different from the site standard defined by
the LAM.

6.2 FpStatus

A new extended version of FpStatus with SUBC 3 has been has been
introduced. It e.g. provides unsolicited fuelling data using _e data formats.

6.3 authorize_fp_with_preset

To authorise with preset in the extended format, use extended_authorize_fp

new parameter StartLimit_e.

6.4 extended_authorize_fp

Two new AuthPars has been added

• StartLimit_e
• FpGradePriceDiscounts_e

And the logPar

• PrepaidMoney_e

6.5 prepare_prepaid_trans

For prepare prepay with extended format use extended_prepare_trans with

new StartLimit_e.

PSS5000/APNO/804739/00 Page 8 of 13
 PSS 5000 Application Note
Extended Transaction Size

6.6 extended_prepare_trans

New _e AuthPars has been introduced:

AuthParId = ID2
*
01: SmId
02: FmgId
03: PgId
04: ValidGrades
05: StartLimit
06: FpTransReturnData
07: LogData
08: AutoLockId
09: FpGradePriceDiscounts
10:
11:
12: FpGradePriceDiscounts_e
13: StartLimit_e

PSS5000/APNO/804739/00 Page 9 of 13
 PSS 5000 Application Note
Extended Transaction Size

6.7 FpFuellingData_req

A new message with new SUBC 01H for support of _e parameters have been
introduced.

Please notice, that fuelling data is included in a new variant of FpStatus_3 and
therefore now send unsolicited.

6.8 FpSupTransBufStatus

The new message with new SUBC 03 for support of _e parameters is slightly
reconstructed.

6.9 FpSupTrans

New transpars has been introduced for ETS. Below are listed ETS related
parameters with old and new ID’s.

52: Price
53: Vol
54: Money
55: SecurityTelegram * not relevant to update *
58: SecurityTelegramTypePSS
59: SecurityTelegramTypePSS_e
-
64: Price_e
65: Vol_e
66: Money_e
-
75: PumpPreset
76: PumpPreset_e

If a transaction is bigger than the 6-6-4 format, attempts to read transaction

with the STS-parameters will be rejected.

6.10 FpUnSupTransBufStatus

A new message with new SUBC 03H supporting _e parameters and has been
slightly reconstructed compared to previous versions.

6.11 FpUnSupTrans

Same as for FpSupTrans; see paragraph 6.9.

6.12 clr_FpSupTrans

A new message with SUBC 04H has been introduced for support of _e
parameters.

6.13 clr_FpUnSupTrans

A new message with SUBC 03H has been using _e parameters

PSS5000/APNO/804739/00 Page 10 of 13
 PSS 5000 Application Note
Extended Transaction Size

6.14 change_FcParameters

6.14.1 Fuelling Modes

FuellingModes has been extended with 2 new limit parameters, so now there
are 4.

The new extended limits should be used in all new interface developments

• MaxTransVolume_e
• MaxTransMoney_e

If the PSS application do not support ETS transactions, uploading data with
more significant digits than supported, will be rejected, e.g. if the controller
only supported the original 6-6-4 format.

6.14.2 FloorLimitMargin

A new extended parameter has been included:

• FloorLimitMargin_e.

Both the old and new format can be changed using the FcChangeParameter
(Floor Limit Margins) message defined in Chapter B.

Rejected if

• not all fuelling points are closed

• if the value is higher than supported by the controller

6.14.3 GlobalFuellingLimits

Two new parameters matching the extended transaction size has been
introduced:

• GlobalMoneyLimit_e
• GlobalVolumeLimit_e

These limits will work as fuelling mode parameters, which means PSS will
sent a stop to the pump when PSS has registered that a limit has been reached.
A fuelling mode limits is “soft limit” and not a preset, so transaction will go
slightly higher than the limit.

Both can be changed using the FcChangeParameter (FcGflPar) message

defined in Chapter B.

Rejected if

• not all fuelling points are closed

• if the value is higher than supported by the controller

PSS5000/APNO/804739/00 Page 11 of 13
 PSS 5000 Application Note
Extended Transaction Size

6.15 FcParameterSet_req

Reading the same parameters, which can changed with the FcChancePars
message.

7 DPP Chapter E
In Chapter E one the accept_EptSeq message is related to the transaction
format.

7.1 accept_EptSeq

To handle the Extended Transaction Size 4 new EptSalesPars has been added.

7.1.1 sales_pars

EptSalesParId = ID2
*
01: EptFmgId
02: EptMaxVol
03: EptMaxMoney
04: EptPriceGroupId
05: EptGradePriceDiscounts
06: EptGradeMoneyLimits
07: EptMaxVol_e
08: EptMaxMoney_e
09: EptGradePriceDiscounts_e
10: EptGradeMoneyLimits_e
*

7.1.2 EptSeqDataItems (RcpItems)

Price, Volume, Money (ID 04,05,06) can not be read or written, is only used
for receipt formatting selected with characters u, v and m. These will be used
for both standard and extended transaction format. PSS will format receipts
according to actual transaction size.

Also remaining EptSeqData has not initially been changed to extended

transaction format. If needed, we will change relevant parameters, when time
comes.

7.2 clr_EptSeq

No changes.

PSS5000/APNO/804739/00 Page 12 of 13
 PSS 5000 Application Note
Extended Transaction Size

8 History
Date Rev. Init. Comments
2012-07-6 00 hbh

PSS5000/APNO/804739/00 Page 13 of 13