Visa Cross-testing Automation Specification or VCAS module pilots ACE-Client automatically:
Configurations are modified and sent to acceptance system.
TMS/Administrative settings are modified and sent to acceptance system.
Transactions are started on acceptance device
signals are updated during the transactions
During the execution of Automated tests, it is better to not manipulate ACE-Client. Between the tests, ACE-Client is fully available.
VCAS tests the integration of the software in the hardware. It implies a huge constraint on transaction overall duration (see Polling timeout below).
Settings
Field | Comment | Value |
---|---|---|
Port | Listening Port | IP port between 50000 and 65535 |
Automatic Start | Activate/Deactivate the VCAS server start when ACE-Client is started | 0 or 1 |
TTQ | Default value of the TTQ in the configurations | any valid TTQ value |
Online Only | Defines if the acceptance system is online only | 1 for online only 0 otherwise |
Agnos v3.3 | Defines the version of Agnos Framework | 1 for framework 3.3 0 otherwise |
Troubleshooting
If you need us to investigate anything related to VCAS, perform the test/transaction then:
use the File > Export mechanism to create an export zip
get the TTQ value from Setup > Visa Cross-testing Automation System
get the Administrative value from Setup > Visa Cross-testing Automation System
Send us the export, the TTQ and Administrative values.
Reset Device
Device shall power off and on and be ready to receive another command
The function gpiReset
is called by this command. It shall implement a reboot of the device and restart the software after the reboot.
Polling timeout
The test VCAS.C.005.00 in VCAS validation tool sets the polling timeout to 2s and expects the whole transaction to take no more than 5s.
t1 is the duration of VCAS StartTransaction request transmission. It depends on the medium (cable or Wi-Fi…)
t2 is the duration of the request’s processing in ACE-Client. It depends on the performance of the computer.
t3 is the duration of transaction request transmission from ACE-Client to the terminal. It depends on the medium and may be longer if there is an adapter between ACE-Client and the terminal
t4 is the duration of the transaction itself
t5 is the duration of transaction response transmission from the terminal to ACE-Client. It depends on the medium and may be longer if there is an adapter between ACE-Client and the terminal
t6 is the duration of the request’s processing in ACE-Client. It depends on the performance of the computer.
t7 is the duration of VCAS StartTransaction response transmission. It depends on the medium (cable or Wi-Fi…)
The sum of all the durations must be less than 5s.
ACE-Client can compute (text in orange):
t2, it is around 30 ms
t3+t4+t5 as the transaction “duration”. This is the duration from ACE-Client point of view and it includes the transmission time.
t6 it is around 20 ms
Empty DebugLog
The test VCAS.C.009.00 - ClearLogs fails with empty Debug logs, if the APDU are not sent to ACE-Client.
FAQ
Is VCAS module started ?
If the button Start/Stop at the right of button 'Update Port' displays 'Stop', VCAS module is up. If it displays 'Start', the module is down.
How to change the listening port
if ACE-Client runs:
change the value in the field
click on Update Port button
click on Stop button
click on Start button (same as Stop)
Starting from version 3.3.34, if ACE-Client is stopped
edit “vcas.ini” in installation directory
change “listeningPort” value
What does SetConfigToDefault do
send the CAKeys to acceptance system
change TERMINAL configuration and send it to acceptance system
change PROCESSING configuration and send it to acceptance system
change ENTRY_POINT configuration and send it to acceptance system
What does PrepareTransaction do
change the TMS/Administrative settings in acceptance system. The values in the table below are set/modified:
Field | Forced Value |
---|---|
Contactless | 1 |
Trace Depth | 6 for APDU log delay |
Key In | 0 |
Signal | 1 |
Polling timeout | VCAS tool gives the value of the polling timeout |
APDU Log | 0 if Agnos v3.3 is ticked 1 for the other frameworks |
PayPass Legacy | 0 |
Amex Legacy | 0 |
JCB Legacy | 0 |
CUP Legacy | 0 |
DPAS Legacy | 0 |
Visa Legacy | 1 |
Digital Signals | 1 |
The other values may depend on the ICS.
Is StopCurrentTransaction supported?
No.The StopCurrentTransaction() function is conditional only if pre-defined timeout (Tag: 0x24) can be set correctly via the SetConfig() function.
The pre-defined timeout is modified through the TMS/Administrative and PrepareTransaction. For performance reasons (transaction duration), StopCurrentTransaction is not supported.
Is StartTransactionAsync supported?
Yes.
As only StopCurrentTransaction is optional and not supported, StartTransactionAsync starts a transaction like StartTransaction.
Where is the executable to stop VCAS
Please use shutdown-ACE-Client.bat in C:\Amadis\ACE-Client to shutdown ACE-Client and VCAS module.
If you want to manually stop the VCAS please use the Start/Stop button.