[go: up one dir, main page]

100% found this document useful (5 votes)
4K views228 pages

VTS Userguide

តេសត

Uploaded by

simchandoeun
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
100% found this document useful (5 votes)
4K views228 pages

VTS Userguide

តេសត

Uploaded by

simchandoeun
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 228

Visa Test System – V.I.P.

User’s Guide

Effective: 15 Mar 2013

 2001–2013 Visa. All Rights Reserved. 51000-18


Visa Confidential
Important Note on Confidentiality and Copyright

The Visa Confidential label signifies that the information in this document is confidential and proprietary to Visa and is in-
tended for use only by Visa Clients subject to the confidentiality restrictions in Visa's Operating Regulations, non-Client Third
Party Processors that have an executed and valid Exhibit K on file with Visa, and other third parties that have a current non-
disclosure agreement (NDA) with Visa that covers disclosure of the information contained herein.

This document is protected by copyright restricting its use, copying, distribution, and decompilation. No part of this document
may be reproduced in any form by any means without prior written authorization of Visa.

Visa, VisaNET, and Visa USA are trademarks or registered trademarks of Visa, Inc. in the U.S. and other countries, and are
used under license by Visa, Inc.

All other product names mentioned herein are the trademarks of their respective owners.

THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE
PERIODICALLY ADDED TO THE INFORMATION HEREIN: THESE CHANGES WILL BE INCORPORATED IN NEW EDI-
TIONS OF THE PUBLICATION. VISA, INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S)
AND/OR THE PROGRAM(S) DESCRIBED IN THIS PUBLICATION AT ANY TIME.

If you have technical questions or questions regarding a Visa service or capability, contact your Visa representative. If you
have comments or questions about this document, send them to TCS@visa.com.
Contents

About This Guide


Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Organization of This Guide . . . . . . . . . . . . . . . . . . . . . . . . 1

Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Chapter 1 • Introduction to VTS-V.I.P.


Overview of VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . . . . . 1–1

VTS-V.I.P. Features . . . . . . . . . . . . . . . . . . . . . . . . . 1–2

How VTS-V.I.P. Works With the V.I.P. System . . . . . . . . . . . . . . . 1–5

Offline Testing With a Direct Connection . . . . . . . . . . . . . . . . 1–5

Offline Testing With a VAP (Optional) . . . . . . . . . . . . . . . . . 1–8

Online Testing With VCMS . . . . . . . . . . . . . . . . . . . . . 1–9

Online Certification . . . . . . . . . . . . . . . . . . . . . . . . 1–11

Limitations of VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . . . . . 1–13

VTS-V.I.P. Support . . . . . . . . . . . . . . . . . . . . . . . . . . 1–13

Chapter 2 • Getting Started


Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 2–2

Installing VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . . . . . . 2–3

Starting VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . . . . . . . 2–4

Navigating VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . . . . . . 2–5

15 Mar 2013 Visa Confidential i


Contents Visa Test System – V.I.P.
User’s Guide

Viewing Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . 2–9

Viewing Directories . . . . . . . . . . . . . . . . . . . . . . . . 2–10

Viewing Signons . . . . . . . . . . . . . . . . . . . . . . . . . 2–11

Viewing File Rotation . . . . . . . . . . . . . . . . . . . . . . . 2–12

VTS-V.I.P. Test Steps . . . . . . . . . . . . . . . . . . . . . . . . 2–13

Basic Test Steps . . . . . . . . . . . . . . . . . . . . . . . . . 2–13

Optional Test Steps . . . . . . . . . . . . . . . . . . . . . . . . 2–14

Using Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . 2–14

Uninstalling VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . . . . . 2–16

Chapter 3 • Setting Up the Communications Handler


Introduction to the Communications Handler . . . . . . . . . . . . . . . . 3–1

Navigating the Communications Handler Window . . . . . . . . . . . . . 3–1

Choosing a Protocol . . . . . . . . . . . . . . . . . . . . . . . . 3–3

Configuring Your System for TCP/IP Protocols . . . . . . . . . . . . . . . . 3–3

Using TCP/IP LAN . . . . . . . . . . . . . . . . . . . . . . . . . 3–3

Using TCP/IP SLIP–Direct . . . . . . . . . . . . . . . . . . . . . . 3–5

Connecting a Null Modem . . . . . . . . . . . . . . . . . . . . 3–6

Configuring RAS . . . . . . . . . . . . . . . . . . . . . . . . 3–7

For Windows XP Operating System . . . . . . . . . . . . . . . . . 3–7

Using TCP/IP SLIP - Modem . . . . . . . . . . . . . . . . . . . . 3–10

Connecting a Dial-Up Modem . . . . . . . . . . . . . . . . . . 3–10

Setting Your Protocol in the Communications Handler . . . . . . . . . . . . 3–12

Configuring the Modem Eliminator . . . . . . . . . . . . . . . . . . . 3–13

Recommended Modem Eliminator Settings . . . . . . . . . . . . . . 3–14

Sample Modem Eliminator Settings . . . . . . . . . . . . . . . . . 3–14

ii Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Contents
User’s Guide

Chapter 4 • Creating a Test


Understanding Test Structure . . . . . . . . . . . . . . . . . . . . . . 4–1

Using Knowledgebases . . . . . . . . . . . . . . . . . . . . . . . . 4–3

Creating a Test . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–3

Changing Test Properties . . . . . . . . . . . . . . . . . . . . . . . 4–5

Using Visa-Supplied Tests . . . . . . . . . . . . . . . . . . . . . . . 4–7

Adding a Test Case . . . . . . . . . . . . . . . . . . . . . . . . . 4–7

Saving a Test as a Text File . . . . . . . . . . . . . . . . . . . . . . 4–7

About Test Configuration . . . . . . . . . . . . . . . . . . . . . . . 4–8

3rd Bitmap . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–14

Address Verification Service (AVS) . . . . . . . . . . . . . . . . . . 4–14

Bypass VCMS Stations . . . . . . . . . . . . . . . . . . . . . . 4–14

Custom Payment Service (CPS) . . . . . . . . . . . . . . . . . . . 4–15

Currency Precision Service . . . . . . . . . . . . . . . . . . . . . 4–15

Card Verification Value (CVV) Service . . . . . . . . . . . . . . . . . 4–15

Field 55 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–15

Field 59 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–15

Field 62 Bitmap . . . . . . . . . . . . . . . . . . . . . . . . . 4–16

Field 118 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–16

Full Authorization Service . . . . . . . . . . . . . . . . . . . . . 4–16

Message Format . . . . . . . . . . . . . . . . . . . . . . . . . 4–16

Multicurrency Service . . . . . . . . . . . . . . . . . . . . . . . 4–16

National Net Settlement Service . . . . . . . . . . . . . . . . . . . 4–16

Special Account Numbers . . . . . . . . . . . . . . . . . . . . . 4–17

PDOL Related Data . . . . . . . . . . . . . . . . . . . . . . . . 4–17

Network ID . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–17

Setting Test Configuration . . . . . . . . . . . . . . . . . . . . . . . 4–19

Inserting a Message Delay . . . . . . . . . . . . . . . . . . . . . . . 4–20

15 Mar 2013 Visa Confidential iii


Contents Visa Test System – V.I.P.
User’s Guide

Chapter 5 • Using Variables


Introduction to Using Variables . . . . . . . . . . . . . . . . . . . . . . 5–2

Default Variable Groups . . . . . . . . . . . . . . . . . . . . . . . . 5–3

Acquirer Variables . . . . . . . . . . . . . . . . . . . . . . . . . 5–4

Card Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 5–5

Issuer Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 5–8

System Variables . . . . . . . . . . . . . . . . . . . . . . . . 5–10

User-Defined Variables . . . . . . . . . . . . . . . . . . . . . . 5–10

Opening a Variables Group . . . . . . . . . . . . . . . . . . . . . . 5–11

Creating a New Variables Group . . . . . . . . . . . . . . . . . . . . 5–13

Modifying a Variable . . . . . . . . . . . . . . . . . . . . . . . . . 5–14

Selecting the Default Variables Group . . . . . . . . . . . . . . . . . . 5–16

Associating Card and Issuer Variables Groups . . . . . . . . . . . . . . . 5–17

Deleting a Variables Group . . . . . . . . . . . . . . . . . . . . . . 5–18

Printing a Variables Group . . . . . . . . . . . . . . . . . . . . . . 5–19

Saving a Variables Group as a Word Document . . . . . . . . . . . . . . 5–19

Creating a User-Defined Variable . . . . . . . . . . . . . . . . . . . . 5–19

Modifying a User-Defined Variable . . . . . . . . . . . . . . . . . . . 5–21

Using a User-Defined Variable in a Test Case . . . . . . . . . . . . . . . 5–23

Deleting a User-Defined Variable . . . . . . . . . . . . . . . . . . . . 5–23

Designating a Variables Group for the Test Case . . . . . . . . . . . . . . 5–24

Chapter 6 • Modifying a Test


Introduction to Test Modification . . . . . . . . . . . . . . . . . . . . . 6–1

Population Methods . . . . . . . . . . . . . . . . . . . . . . . . 6–2

Literal . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–2

Field in Earlier, Previous, or Current Message . . . . . . . . . . . . . 6–2

Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–3

iv Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Contents
User’s Guide

Valid Value . . . . . . . . . . . . . . . . . . . . . . . . . . 6–3

System Generated . . . . . . . . . . . . . . . . . . . . . . . 6–3

Subfield Level . . . . . . . . . . . . . . . . . . . . . . . . 6–4

Field Properties . . . . . . . . . . . . . . . . . . . . . . . . . 6–4

Match Field . . . . . . . . . . . . . . . . . . . . . . . . . 6–5

Validate Field . . . . . . . . . . . . . . . . . . . . . . . . . 6–5

Omit Field . . . . . . . . . . . . . . . . . . . . . . . . . . 6–5

Editing a Message . . . . . . . . . . . . . . . . . . . . . . . . . . 6–5

Editing a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–8

Printing Message Content . . . . . . . . . . . . . . . . . . . . . . . 6–10

Deleting a Case or Message . . . . . . . . . . . . . . . . . . . . . . 6–10

Adding a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–11

Using the Bitmap Editor . . . . . . . . . . . . . . . . . . . . . . . . 6–12

Viewing a Message in Hex . . . . . . . . . . . . . . . . . . . . . . . 6–14

Using the TLV Editor . . . . . . . . . . . . . . . . . . . . . . . . . 6–15

Chapter 7 • Running a Test


Introduction to Running a Test . . . . . . . . . . . . . . . . . . . . . 7–1

Understanding Message Processing . . . . . . . . . . . . . . . . . . . 7–1

Setting Test Execution Preferences . . . . . . . . . . . . . . . . . . . 7–3

Executing a Test . . . . . . . . . . . . . . . . . . . . . . . . . . . 7–4

Using Match Probability . . . . . . . . . . . . . . . . . . . . . . . . 7–7

About Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7–8

Dynamic Key Exchange . . . . . . . . . . . . . . . . . . . . . . 7–9

PIN Processing in VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . 7–10

Using Keys in VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . . . . 7–10

15 Mar 2013 Visa Confidential v


Contents Visa Test System – V.I.P.
User’s Guide

Chapter 8 • Obtaining Test Results


Introduction to Obtaining Test Results . . . . . . . . . . . . . . . . . . . 8–1

About Log Viewer Messages . . . . . . . . . . . . . . . . . . . . . . 8–1

Using the Log Viewer . . . . . . . . . . . . . . . . . . . . . . . . . 8–2

Using the Raw Message Viewer . . . . . . . . . . . . . . . . . . . . . 8–7

Printing Messages . . . . . . . . . . . . . . . . . . . . . . . . . . 8–10

Deleting Messages . . . . . . . . . . . . . . . . . . . . . . . . . 8–10

Chapter 9 • Using Card Readers


Introduction to Using Card Readers . . . . . . . . . . . . . . . . . . . . 9–1

Chip Card Readers . . . . . . . . . . . . . . . . . . . . . . . . . . 9–2

Chip Card Processing . . . . . . . . . . . . . . . . . . . . . . . . 9–4

Issuer Authentication . . . . . . . . . . . . . . . . . . . . . . . . 9–4

Issuer Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . 9–5

Chip Card Fields . . . . . . . . . . . . . . . . . . . . . . . . . . 9–5

User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . 9–8

Installing Chip Card Reader Software . . . . . . . . . . . . . . . . 9–12

Installing Software for the GemPC Twin . . . . . . . . . . . . . . 9–12

Installing the Driver for the GemPC Twin . . . . . . . . . . . . . . 9–12

Verifying Software Components for the GemPC Twin . . . . . . . . . 9–13

Installing Software for the GemCore Keyboard USB Pro Cherry . . . . . 9–13

Installing the Driver for the GemCore Keyboard USB Pro Cherry . . . . 9–13

Verifying Software Components for the GemCore Keyboard


USB Pro Cherry . . . . . . . . . . . . . . . . . . . . . . . 9–16

Contactless and Magstripe Readers . . . . . . . . . . . . . . . . . . . 9–17

Installing Contactless and Magstripe Readers and Software . . . . . . . . 9–17

Installing the Castles EZPROX Driver . . . . . . . . . . . . . . . 9–18

Installing the Magtek Driver . . . . . . . . . . . . . . . . . . . 9–19

Installing the ViVOpay 4000 Driver . . . . . . . . . . . . . . . . 9–21

vi Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Contents
User’s Guide

Installing the ViVOTech 5000 Driver . . . . . . . . . . . . . . . . 9–23

Equinox Card Reader Terminal . . . . . . . . . . . . . . . . . . . . . 9–24

Installing the Equinox Terminal Driver . . . . . . . . . . . . . . . 9–25

Installing the packinglist for the Equinox Terminal . . . . . . . . . . . 9–27

Processing Cards Offline . . . . . . . . . . . . . . . . . . . . . . . 9–28

Saving the Card Data in a Variables Group . . . . . . . . . . . . . . . 9–28

Running the Test With Offline Card Data . . . . . . . . . . . . . . . . 9–29

Processing Offline Without a Card Reader or Card . . . . . . . . . . . . . 9–31

Processing Cards Online . . . . . . . . . . . . . . . . . . . . . . . 9–31

Chapter 10 • Exporting and Importing Tests and Files


Introduction to Exporting and Importing Tests and Files . . . . . . . . . . . . 10–1

Exporting Files . . . . . . . . . . . . . . . . . . . . . . . . . . . 10–2

Importing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . 10–3

Import Warning Messages . . . . . . . . . . . . . . . . . . . . . 10–4

Chapter 11 • Automated Log Comparison


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11–1

About Comparing Log Files . . . . . . . . . . . . . . . . . . . . . . 11–1

Opening Automated Log Comparison . . . . . . . . . . . . . . . . . . 11–2

Comparing Log Files . . . . . . . . . . . . . . . . . . . . . . . . . 11–3

Chapter 12 • Using VTS-V.I.P. with VCMS


Introduction to Using VTS-V.I.P. with VCMS . . . . . . . . . . . . . . . . 12–1

Testing With VCMS . . . . . . . . . . . . . . . . . . . . . . . . . . 12–1

CR Message Processing . . . . . . . . . . . . . . . . . . . . . . 12–3

Station Pairing . . . . . . . . . . . . . . . . . . . . . . . . . . 12–4

Other Non-ISO Messages . . . . . . . . . . . . . . . . . . . . . 12–5

Changing Loopback Mode . . . . . . . . . . . . . . . . . . . . . 12–5

15 Mar 2013 Visa Confidential vii


Contents Visa Test System – V.I.P.
User’s Guide

Setting VCMS Preferences . . . . . . . . . . . . . . . . . . . . . . 12–6

Logging On to VCMS . . . . . . . . . . . . . . . . . . . . . . . . 12–8

Chapter 13 • Using VTS-V.I.P. with EAS/Visa MG


Introduction to Using VTS-V.I.P. with EAS/Visa MG . . . . . . . . . . . . . 13–1

Menu Bar and Buttons . . . . . . . . . . . . . . . . . . . . . . 13–1

Station Pairing and Depairing . . . . . . . . . . . . . . . . . . . . . 13–3

Secure Member Connection (SMC) . . . . . . . . . . . . . . . . . . . 13–4

Setting up the Communication Handler for Secure Member Connection . . . 13–4

Adding Auto Generation for Heart Beat Messages . . . . . . . . . . . 13–6

Setting up Stunnel . . . . . . . . . . . . . . . . . . . . . . . . 13–6

Editing SMC Message: To edit the SMC messages please click the
SMC Edit menu . . . . . . . . . . . . . . . . . . . . . . . . . 13–7

Chapter 14 • Using VTS-V.I.P. with Add Fields


Introduction to Using VTS-V.I.P. with Add Fields . . . . . . . . . . . . . . 14–1

Menu Bar and Buttons . . . . . . . . . . . . . . . . . . . . . . 14–1

Procedure to Add Fields in Multiple Messages . . . . . . . . . . . . . . . 14–3

Chapter 15 • Using VTS-V.I.P. with Script Generator


Introduction to Using VTS-V.I.P. with Script Generator . . . . . . . . . . . . 15–1

Menu Bar and Buttons . . . . . . . . . . . . . . . . . . . . . . 15–1

Procedure to Create Script from a Defined Database . . . . . . . . . . . . 15–3

Index

viii Visa Confidential 15 Mar 2013


Figures

1–1: VTS-V.I.P. System Diagram . . . . . . . . . . . . . . . . . . . 1–4


1–2: Offline Direct Connection—VTS-V.I.P. as Issuer . . . . . . . . . . . . 1–6
1–3: Offline Direct Connection—VTS-V.I.P. as Acquirer . . . . . . . . . . . 1–7
1–4: Offline Testing With VAP—VTS-V.I.P. as Issuer . . . . . . . . . . . . 1–8
1–5: Offline Testing With VAP—VTS-V.I.P. as Acquirer . . . . . . . . . . . . 1–9
1–6: Online Testing With VCMS—VTS-V.I.P. as Issuer . . . . . . . . . . . 1–10
1–7: Online Testing With VCMS—VTS-V.I.P. as Acquirer . . . . . . . . . . 1–11
1–8: Online Testing With V.I.P.—Certification Office as Issuer . . . . . . . . . 1–12
1–9: Online Testing With V.I.P.—Certification Office as Acquirer . . . . . . . . 1–12
2–1: Finding VTS-V.I.P. in the Start Menu . . . . . . . . . . . . . . . . 2–5
2–2: Viewing the VTS-V.I.P. Log Window . . . . . . . . . . . . . . . . 2–6
2–3: Format of Main VTS-V.I.P. Window . . . . . . . . . . . . . . . . 2–7
2–4: Preferences Window . . . . . . . . . . . . . . . . . . . . . 2–8
2–5: Preferences Window . . . . . . . . . . . . . . . . . . . . . 2–9
2–6: Preferences Window . . . . . . . . . . . . . . . . . . . . 2–10
2–7: Preferences Window . . . . . . . . . . . . . . . . . . . . 2–11
2–8: Preferences Window . . . . . . . . . . . . . . . . . . . . 2–12
3–1: Communications Handler Window . . . . . . . . . . . . . . . . . 3–2
3–2: TCP/IP Tab . . . . . . . . . . . . . . . . . . . . . . . . 3–4
3–3: Null Modem Pins . . . . . . . . . . . . . . . . . . . . . . 3–6
3–4: TCP/IP Tab . . . . . . . . . . . . . . . . . . . . . . . . 3–9
3–5: TCP/IP Tab . . . . . . . . . . . . . . . . . . . . . . . 3–11
3–6: General Tab . . . . . . . . . . . . . . . . . . . . . . 3–13
4–1: Test Hierarchy . . . . . . . . . . . . . . . . . . . . . . . 4–2
4–2: Test Structure . . . . . . . . . . . . . . . . . . . . . . . 4–2

15 Mar 2013 Visa Confidential ix


Figures Visa Test System – V.I.P.
User’s Guide

4–3: Knowledgebase Format . . . . . . . . . . . . . . . . . . . 4–3


4–4: Create New Test Dialog Box . . . . . . . . . . . . . . . . . . 4–4
4–5: Empty Test Case Window. . . . . . . . . . . . . . . . . . . 4–4
4–6: Incoming and Outgoing Request Folders . . . . . . . . . . . . . . 4–5
4–7: Adding Message Pairs . . . . . . . . . . . . . . . . . . . 4–5
4–8: Test Properties Dialog Box . . . . . . . . . . . . . . . . . . 4–6
4–9: Test Configuration Dialog Box . . . . . . . . . . . . . . . . . 4–19
4–10: Delay Dialog Box . . . . . . . . . . . . . . . . . . . . . 4–20
5–1: How Variables Are Arranged . . . . . . . . . . . . . . . . . . 5–2
5–2: Variables Database . . . . . . . . . . . . . . . . . . . . 5–11
5–3: Variables Database . . . . . . . . . . . . . . . . . . . . 5–12
5–4: Variables Group Display . . . . . . . . . . . . . . . . . . . 5–13
5–5: Save Group As Dialog Box . . . . . . . . . . . . . . . . . . 5–13
5–6: Variable Group Display . . . . . . . . . . . . . . . . . . . 5–14
5–7: Variable Group Description Box . . . . . . . . . . . . . . . . . 5–15
5–8: Variables Group Display . . . . . . . . . . . . . . . . . . . 5–15
5–9: Variable Group Display . . . . . . . . . . . . . . . . . . . 5–16
5–10: Variables Database . . . . . . . . . . . . . . . . . . . . 5–17
5–11: Variable Group Display . . . . . . . . . . . . . . . . . . . 5–18
5–12: Variables Manager . . . . . . . . . . . . . . . . . . . . . 5–20
5–13: Add User Variable Dialog Box . . . . . . . . . . . . . . . . . 5–20
5–14: User Defined Variables . . . . . . . . . . . . . . . . . . . 5–21
5–15: Edit User Variable Properties Dialog Box . . . . . . . . . . . . . . 5–22
5–16: Case Properties Dialog Box . . . . . . . . . . . . . . . . . . 5–26
6–1: Message Editor . . . . . . . . . . . . . . . . . . . . . . 6–6
6–2: Field Editor . . . . . . . . . . . . . . . . . . . . . . . 6–8
6–3: Population Method Fields . . . . . . . . . . . . . . . . . . 6–9
6–4: Add Field Dialog Box . . . . . . . . . . . . . . . . . . . . 6–11
6–5: Field Editor . . . . . . . . . . . . . . . . . . . . . . . 6–13
6–6: Bitmap Editor . . . . . . . . . . . . . . . . . . . . . . 6–14
6–7: Hex Viewer . . . . . . . . . . . . . . . . . . . . . . . 6–15
6–8: Hex Viewer . . . . . . . . . . . . . . . . . . . . . . . 6–15
6–9: TLV Editor . . . . . . . . . . . . . . . . . . . . . . . 6–16

x Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Figures
User’s Guide

7–1: Test Execution Preferences . . . . . . . . . . . . . . . . . . . 7–3


7–2: Test Execution Dialog Box . . . . . . . . . . . . . . . . . . . 7–5
7–3: Case Properties . . . . . . . . . . . . . . . . . . . . . . 7–8
7–4: Keys Properties . . . . . . . . . . . . . . . . . . . . . 7–12
8–1: Log Viewer . . . . . . . . . . . . . . . . . . . . . . . . 8–3
8–2: Options Dialog Box . . . . . . . . . . . . . . . . . . . . . 8–4
8–3: System Message Dialog Box . . . . . . . . . . . . . . . . . . 8–5
8–4: Incoming Message Dialog Box . . . . . . . . . . . . . . . . . . 8–6
8–5: Bitmap Settings Dialog Box . . . . . . . . . . . . . . . . . . . 8–7
8–6: General Settings . . . . . . . . . . . . . . . . . . . . . . 8–8
8–7: Raw Message Viewer . . . . . . . . . . . . . . . . . . . . 8–9
8–8: Delete Log Dialog Box . . . . . . . . . . . . . . . . . . . 8–10
9–1: Message Editor . . . . . . . . . . . . . . . . . . . . . . 9–9
9–2: Message Editor . . . . . . . . . . . . . . . . . . . . . 9–10
9–3: Message Editor . . . . . . . . . . . . . . . . . . . . . 9–11
9–4: Message Editor . . . . . . . . . . . . . . . . . . . . . 9–11
9–5: Gemplus Web Site . . . . . . . . . . . . . . . . . . . . 9–12
9–6: Cherry Web Site . . . . . . . . . . . . . . . . . . . . . 9–14
9–7: Cherry Support Download Dialog Box . . . . . . . . . . . . . . 9–15
9–8: Cherry Support Software/Manual Download Dialog Box . . . . . . . . . 9–16
9–9: Preferences Dialog Box . . . . . . . . . . . . . . . . . . . 9–19
9–10: HID Virtual Serial Port Configuration Utility . . . . . . . . . . . . . 9–20
9–11: ViVOpay 4000 Driver Installer . . . . . . . . . . . . . . . . . 9–21
9–12: ViVOpay 4000 Driver Installer . . . . . . . . . . . . . . . . . 9–22
9–13: ViVOpay 4000 Driver Installer . . . . . . . . . . . . . . . . . 9–22
9–14: Preferences Dialog Box . . . . . . . . . . . . . . . . . . . 9–24
9–15: Hypercom Serial Driver Installation . . . . . . . . . . . . . . . 9–26
9–16: Variables Group Display . . . . . . . . . . . . . . . . . . . 9–28
9–17: Select Acquirer Group Dialog Box . . . . . . . . . . . . . . . . 9–29
9–18: Select ICC Application Dialog Box . . . . . . . . . . . . . . . 9–29
9–19: Test Configuration Dialog Box . . . . . . . . . . . . . . . . . 9–30
9–20: Case Properties Dialog Box . . . . . . . . . . . . . . . . . 9–31
9–21: Test Configuration Dialog Box . . . . . . . . . . . . . . . . . 9–32

15 Mar 2013 Visa Confidential xi


Figures Visa Test System – V.I.P.
User’s Guide

9–22: Case Properties Dialog Box . . . . . . . . . . . . . . . . . . 9–33


10–1: Export Dialog Box . . . . . . . . . . . . . . . . . . . . . 10–2
10–2: Import Dialog Box . . . . . . . . . . . . . . . . . . . . . 10–3
11–1: Automated Log Comparison Dialog Box . . . . . . . . . . . . . . 11–2
11–2: Options Dialog Box . . . . . . . . . . . . . . . . . . . . 11–3
11–3: Options Dialog Box . . . . . . . . . . . . . . . . . . . . 11–4
11–4: Automated Log Comparison Dialog Box . . . . . . . . . . . . . . 11–4
12–1: Message Flow in VisaNet Loopback Mode . . . . . . . . . . . . . 12–2
12–2: VCMS Testing Protocols . . . . . . . . . . . . . . . . . . . 12–3
12–3: Preferences Dialog Box . . . . . . . . . . . . . . . . . . . 12–7
12–4: VCMS Login Dialog Box . . . . . . . . . . . . . . . . . . . 12–9
12–5: Edit Partner Station ID Dialog Box . . . . . . . . . . . . . . . . 12–10
13–1: Tools Menu . . . . . . . . . . . . . . . . . . . . . . . 13–2
13–2: EAS/Visa MG Pairing Dialog Box . . . . . . . . . . . . . . . . 13–2
13–3: Add Station ID’s Dialog Box . . . . . . . . . . . . . . . . . . 13–3
13–4: Depair Dialog Box . . . . . . . . . . . . . . . . . . . . . 13–3
13–5: General Settings . . . . . . . . . . . . . . . . . . . . . 13–4
13–6: TCP/IP Settings . . . . . . . . . . . . . . . . . . . . . 13–5
13–7: SMC Menu . . . . . . . . . . . . . . . . . . . . . . . 13–6
14–1: Edit Menu . . . . . . . . . . . . . . . . . . . . . . . 14–2
14–2: Main VTS-V.I.P. Window . . . . . . . . . . . . . . . . . . . 14–3
14–3: Select Fields Dialog Box . . . . . . . . . . . . . . . . . . . 14–4
15–1: Edit Menu . . . . . . . . . . . . . . . . . . . . . . . 15–2
15–2: Retrieving Data Dialog . . . . . . . . . . . . . . . . . . . 15–3
15–3: Select Fields Dialog Box . . . . . . . . . . . . . . . . . . . 15–3
15–4: Create Script Dialog Box . . . . . . . . . . . . . . . . . . 15–4
15–5: Message Box . . . . . . . . . . . . . . . . . . . . . . 15–5

xii Visa Confidential 15 Mar 2013


Tables

2–1: System Requirements . . . . . . . . . . . . . . . . . . . . 2–2


2–2: Protocol Requirements . . . . . . . . . . . . . . . . . . . . 2–3
2–3: Online Help Icons . . . . . . . . . . . . . . . . . . . . . 2–15
4–1: Test Configuration Settings . . . . . . . . . . . . . . . . . . . 4–9
5–1: Acquirer Variables and Primary Fields . . . . . . . . . . . . . . . 5–4
5–2: Card Variables and Primary Fields . . . . . . . . . . . . . . . . 5–5
5–3: Issuer Variables and Primary Fields . . . . . . . . . . . . . . . . 5–8
5–4: System Variables and Primary Fields . . . . . . . . . . . . . . . 5–10
6–1: System-Generated Fields for Outgoing Messages . . . . . . . . . . . 6–3
7–1: Key Fields in Preferences . . . . . . . . . . . . . . . . . . 7–10
9–1: Overview of VTS-V.I.P.-Supported Chip Card Readers . . . . . . . . . . 9–2
9–2: Valid Application Identifiers (AID) . . . . . . . . . . . . . . . . . 9–3
9–3: Source and Variables Used for Chip Card Fields . . . . . . . . . . . . 9–6
12–1: Changing VCMS Loopback Mode . . . . . . . . . . . . . . . . 12–6
13–1: List of SMC Message Edit Menus . . . . . . . . . . . . . . . . 13–7

15 Mar 2013 Visa Confidential xiii


About This Guide

Visa Test System – V.I.P. (VTS-V.I.P.) application performs testing of certification scripts. It
provides functionality to streamline the certification process.

Audience
The Visa Test System – V.I.P. User’s Guide is intended for users who:

Install the hardware, communications subsystem, and applications software.

Conduct testing of VisaNet Integrated Payment (V.I.P.) certification scripts.
This guide assumes that users have some experience with the pre-certification testing
process and with using the Windows interface.

Organization of This Guide


This guide comprises the following 15 chapters.
● Chapter 1, Introduction to VTS-V.I.P.—Provides an overview of the VTS-V.I.P.
application and the different types of testing that users can perform.
● Chapter 2, Getting Started—Provides the system requirements for VTS-V.I.P. and
instructions on installing the software and setting up general preferences. This
chapter also includes a list of the steps required for testing.

Chapter 3, Setting Up the Communications Handler—Describes how to install
communications hardware components and how to set up VTS-V.I.P. for different host
interface protocols.

Chapter 4, Creating a Test—Describes how to create a test using messages from the
Visa-supplied Knowledgebases and how to set test configuration settings.
● Chapter 5, Using Variables—Explains the Variables Manager.

Chapter 6, Modifying a Test—Describes the Message, Field, and Bitmap Editors.

15 Mar 2013 Visa Confidential 1


About This Guide Visa Test System – V.I.P.
User’s Guide

● Chapter 7, Running a Test—Describes how message processing works during a test,


and how to run a test. It also describes how to use match probability and keys.
● Chapter 8, Obtaining Test Results—Describes how to set up and view the results of a
test.

Chapter 9, Using Card Readers—Describes how to use a card reader with VTS-V.I.P.
● Chapter 10, Exporting and Importing Tests and Files—Describes how to export and
import a test to another computer running VTS-V.I.P.
● Chapter 11, Automated Log Comparison—Describes how to use the automated log
comparison feature.
● Chapter 12, Using VTS-V.I.P. with VCMS—Provides an explanation of VCMS
loopback testing and using VTS-V.I.P. in this role.
● Chapter 13, Using VTS-V.I.P. with EAS/Visa MG—Provides an explanation of how to
use VTS-V.I.P. with Extended Access Server (EAS)/Visa Message Gateway (Visa
MG).
● Chapter 14, Using VTS-V.I.P. with Add Fields—Provides an explanation how to
perform mass updates of messages within existing databases (.stf files) when new
fields are added.
● Chapter 15, Using VTS-V.I.P. with Script Generator—Provides an explanation how to
Create Scripts (excel file) automatically from the defined databases (.stf files) for
transaction details.
This guide also contains an index.

Related Documents
The publications listed in this section provide more information about Visa systems and
about additional services not covered in this manual.
● Card Technology Standards

Deluxe ISO8583 Interface Specifications

PIN and Security Requirements
● VAP Interface Specifications: V.I.P. Processing
● Visa Smart Debit/Visa Smart Credit System Technical

V.I.P. System BASE I Technical Specifications and the V.I.P. System suite of technical
specifications manuals
● V.I.P. System Services

EMV2000 Guidelines: www.emvco.com
● VCMS Testing and Certification Guide—V.I.P. System Member Version

2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Related Documents
User’s Guide

● Member Implementation Guides, both U.S. and International versions


● V.I.P System SMS Interlink Member Implementation Guide
● Visa Direct Exchange Message Gateway Service Implementation Guide

15 Mar 2013 Visa Confidential 3


Introduction to VTS-V.I.P. 1

Overview of VTS-V.I.P. . . . . . . . . . . . . . . . . . . 1–1

VTS-V.I.P. Features . . . . . . . . . . . . . . . . . . . . 1–2

How VTS-V.I.P. Works With the V.I.P. System . . . . . . 1–5

Limitations of VTS-V.I.P. . . . . . . . . . . . . . . . . .1–13

VTS-V.I.P. Support . . . . . . . . . . . . . . . . . . . .1–13

Overview of VTS-V.I.P.
VisaNet Certification Management Service (VCMS) provides members and their
processors with a dedicated environment for testing their systems and completing
certification with Visa. The service offers a convenient and reliable way of testing system
integrity before connecting to VisaNet in a production environment.
VCMS closely mirrors the current VisaNet Integrated Payment (V.I.P.) System (including
Single Message System [SMS] and BASE I) and clearing and settlement (BASE II)
production environments. VCMS also supports many of the production applications in
BASE I, BASE II, and SMS.
VCMS V.I.P. allows online testing of member systems both for BASE I and for SMS.
VCMS clearing and settlement allows online testing of member clearing and settlement
interfaces.
Members need to certify that their host is capable of handling the new or changed V.I.P.
formats correctly. Members use a software application to simulate the processing of
messages between their host and the V.I.P. System.

15 Mar 2013 Visa Confidential 1–1


Introduction to VTS-V.I.P. Visa Test System – V.I.P.
User’s Guide

Members used to use the DOS-based VisaNet Test System application to perform the
scenarios necessary to complete testing and certification; next, Visa developed VTS2000,
a Windows-based software application which used a standard Windows interface.
VTS2000 was discontinued in October of 2005.
VTS-V.I.P. is a Windows-based software application using a standard Windows interface
which can be connected to your test host or to the VisaNet Access Point (VAP) to execute
production similar V.I.P. testing. This tool has been in production since 2001.
VTS-V.I.P. supports end-to-end testing by performing the role of an acquirer or an issuer,
depending on the role of the member’s host system.

VTS-V.I.P. Features
VTS-V.I.P. provides these features:
An easy-to-navigate application—VTS-V.I.P. implements a Windows standard interface
which is familiar and easy to use. Screens include more information to help you to
complete testing.
An up-to-date platform—VTS-V.I.P. runs on Windows XP and Windows Vista and is not
dependent on an unsupported operating system.
IMPORTANT
The Windows NT 4.0 operating system is not supported, effective 30
November 2005. See IML #4204.
The Windows 2000 operating system is not supported, effective 30
April 2010.
NOTE: Any references to Windows XP in this document refer to both the Home and
Professional editions. Any references to Windows Vista in this document refer to
the 32 bit version.
An expanded variables function—With the Variables Manager, you can create your
own variables, as well as use or edit variables supplied by Visa. The Variables function
enables you to change a variable once and have this change reflected in all tests that use
the variable. VTS-V.I.P. improves variables management by grouping them by function.
New editing features—VTS-V.I.P. includes a cursor place indicator to help you locate
your position when you are editing a field or subfield. This is especially helpful when you
are editing large literal fields where the position of data is critical.
Matching at a subfield level—VTS-V.I.P. provides matching at the subfield level.
The ability to run cases in parallel—With VTS-V.I.P., you can run several test cases at
the same time. This saves testing time.
The ability to resume running a test—This feature allows you to pause test execution to
correct message errors as they occur and then resume testing at that point, rather than
beginning again.

1–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. VTS-V.I.P. Features
User’s Guide

The ability to pair and depair station IDs with Extended Access Server/Visa
Message Gateway (EAS/Visa MG)—VTS-V.I.P. allows you to pair and depair station IDs
easily using a new menu option or toolbar icon called EAS/Visa MG.
A raw message viewer—VTS-V.I.P. provides an option to save raw messages in a
separate file and view them while the Communications Handler is not running.
Support for new chip card readers—VTS-V.I.P. supports two EMV Level 1-compliant
chip card readers. These chip card readers allow a complete online chip card processing
flow, including support for issuer authentication and issuer scripts.
Contactless—VTS-V.I.P. provides support for using the ViVOpay 4000/5000 contactless
card reader using MSD standard.
Magstripe—VTS-V.I.P. provides support for using the Magtek for magstripe card readers.
Contact, Contactless, Magstripe—VTS-V.I.P. provides support for using the Equinox
device for these three types of card reading.
Multiple Instances—VTS-V.I.P. provides the ability to view and run both issuer and
acquirer stations simultaneously on one machine.
Better Productivity—Automated Log Comparison enables users, developers, QA
analysts, regional certifiers, and members to have better productivity.
Support for Deluxe (ISO 0, 2, 4, A, C, and 8)—VTS-V.I.P. provides the Deluxe
Knowledgebase and variables.
You can use VTS-V.I.P. for authoring, editing, and testing functions. You can build your
own tests, as well as run or modify any tests supplied by Visa.
When you run a test, VTS-V.I.P.:
● Builds incoming and outgoing messages.
● Analyzes incoming and outgoing messages by comparing input fields to expected
results.
● Logs test run results, including errors and discrepancies.
In addition, VTS-V.I.P. enables you to edit or create any component of the test system,
from a database that contains one or more tests to a subfield within a message. The
editing tools let you perform common editing functions such as copying, cutting, pasting,
and deleting text.
VTS-V.I.P. uses information from the Knowledgebase to determine which fields you can
include in messages and what their values should be. These values are based on the
V.I.P. definition database. See V.I.P. System BASE I Technical Specifications and the
V.I.P. System SMS technical specifications manuals for more information on V.I.P. fields.
For information on other message formats, see the following:

Deluxe message format Deluxe ISO8583 Interface Specifications

15 Mar 2013 Visa Confidential 1–3


Introduction to VTS-V.I.P. Visa Test System – V.I.P.
User’s Guide

When you run the tests, VTS-V.I.P. sends and receives the messages over the
communications lines using the Communications Handler. As soon as these messages
are sent or received, VTS-V.I.P. logs them. You can use this log to evaluate the test
results.
Figure 1–1 shows the major VTS-V.I.P. components.

Figure 1–1: VTS-V.I.P. System Diagram

Communications
Knowledgebase Handler

Test Handler

Test Database Raw Msg File

Log Server

Raw Msg Viewer


Variable
Database

Variable Manager
Log File Log Viewer

1–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. How VTS-V.I.P. Works With the V.I.P. System
User’s Guide

How VTS-V.I.P. Works With the V.I.P. System


VTS-V.I.P. simulates the V.I.P. System. For Custom Payment Service transactions, it uses
common test algorithms to ensure that your host system properly copies values from
authorization records to clearing records without modification. VTS-V.I.P. generates a
transaction ID and a test validation code that BASE II online systems can verify.
The following sections describe how VTS-V.I.P. simulates the Visa Interchange Center
(VIC), an issuer, or an acquirer depending on its settings. You can send and receive
messages without going through a VisaNet Access Point (VAP) or VisaNet Certification
and Management Service (VCMS) itself. The test environments enable you to connect:
● Offline testing with a direct connection to your host computer.
● Offline testing with a VAP.
● Online testing with VCMS.

Offline Testing With a Direct Connection


Offline testing with a direct connection is the first step in certification. In this setup, VTS-
V.I.P. is attached to the member host computer directly without the VAP or VIC in between.
In this configuration, VTS-V.I.P. performs some of the functions of the VIC and plays the
role of an issuer or an acquirer, as shown in Figure 1–2 and Figure 1–3.
VTS-V.I.P. simulates the V.I.P. System responses to requests sent by the host computer. It
also sends V.I.P. System requests to the host computer for testing the system’s ability to
respond properly. It simulates this process by executing tests contained in a user-defined
database.

15 Mar 2013 Visa Confidential 1–5


Introduction to VTS-V.I.P. Visa Test System – V.I.P.
User’s Guide

Figure 1–2: Offline Direct Connection—VTS-V.I.P. as Issuer

ATM or POS

Request
Response

Acquirer
Host

Response Request

Request Request Request

Response Response Response


Acquirer VAP/ VisaNet Issuer VAP/ Issuer
EAS/Visa MG Interchange EAS/Visa MG Host
Center (VIC)

= Role being
tested

= Role of VTS-
V.I.P.

1–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. How VTS-V.I.P. Works With the V.I.P. System
User’s Guide

Figure 1–3: Offline Direct Connection—VTS-V.I.P. as Acquirer

ATM or POS
Device

Response Request

Acquirer
Host

Response Request

Request Request

Response Response
Acquirer VisaNet Issuer VAP
VAP Interchange
Center (VIC)

Response Request

= Role being tested

Issuer
= Role of VTS-V.I.P. Host

15 Mar 2013 Visa Confidential 1–7


Introduction to VTS-V.I.P. Visa Test System – V.I.P.
User’s Guide

Offline Testing With a VAP (Optional)


Offline testing with a VAP is the second step in the certification process. In this
configuration, the member host is attached to an onsite VAP computer that, in turn, is
attached to VTS-V.I.P. This arrangement provides all of the functionality of a direct
connection. However, it facilitates testing of the link between the member host and the
VAP and uses the internal VAP software.
In this configuration, VTS-V.I.P. can also play the role of an issuer or an acquirer, as shown
in Figure 1–4 and Figure 1–5.

Figure 1–4: Offline Testing With VAP—VTS-V.I.P. as Issuer

Request

Response
ATM or POS
Acquirer
Device
Host

Response Request

Acquirer
VAP

Response Request

Request Request

= Role being
Response Response
tested
VisaNet Issuer VAP Issuer
= Role of VTS- Interchange Host
V.I.P. Center (VIC)

1–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. How VTS-V.I.P. Works With the V.I.P. System
User’s Guide

Figure 1–5: Offline Testing With VAP—VTS-V.I.P. as Acquirer

Request Request Request

Response Response Response


ATM or POS
Device Acquirer Acquirer VisaNet
Host VAP Interchange
Center (VIC)

Response Request

Request

= Role being
tested Response

Issuer Issuer VAP


= Role of VTS- Host
V.I.P.

Online Testing With VCMS


VCMS loopback testing is the last step before going online with the V.I.P. System. The
VCMS connection, known as VisaNet Loopback, uses a network connection between the
VAP/EAS/Visa MG and the VCMS test system in a test environment. This arrangement
most closely replicates the V.I.P. production environment with the VTS-V.I.P. computer
attached to the test port of the VAP/EAS/Visa MG and assuming the role of the acquirer or
issuer, as shown in Figure 1–6 and Figure 1–7.
With VTS-V.I.P. connected to the test port on the VAP, you control both the acquirer or
issuer ends of the replicated production environment through a single VAP. If you are an
acquirer, you can test with VTS-V.I.P. simulating an issuer host. If you are an issuer, VTS-
V.I.P. simulates the acquirer host.
If you plan to test VTS-V.I.P. with the VisaNet Certification Management Service (VCMS),
it offers the following loopback modes:
● Local Loopback (VAP only)—Routes messages to and from the member host using
the VTS-V.I.P. test port connection to the VAP without a connection to the VCMS test
system. Local Loopback is an offline method similar to VAP offline testing. (The Local
Loopback configuration is the same as shown in Figure 1–4 and Figure 1–5.)
However, Local Loopback uses communications interfaces that are identical to those
used for online VCMS testing.

15 Mar 2013 Visa Confidential 1–9


Introduction to VTS-V.I.P. Visa Test System – V.I.P.
User’s Guide

● VisaNet Loopback—Routes messages to and from VTS-V.I.P. and the member host
through the VAP and VCMS test systems. VisaNet Loopback mode provides a
simulation of a complete V.I.P. processing cycle.
● None—Routes messages to and from the member's host either to another member's
host or to a Visa certification lab. Because VTS-V.I.P. is not in the routing path for this
loopback mode, it prevents test execution until the loopback mode is changed to
either Local Loopback or VisaNet Loopback.

Figure 1–6: Online Testing With VCMS—VTS-V.I.P. as Issuer

Request

ATM or POS Response


Acquirer
Device
Host
VCMS Loopback

Response Request

Request

Response
VCMS
VAP VIC
Serial Test Port

= Role being
tested

= Role of VTS-
V.I.P.

Issuer
Host

1–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. How VTS-V.I.P. Works With the V.I.P. System
User’s Guide

Figure 1–7: Online Testing With VCMS—VTS-V.I.P. as Acquirer

Request

ATM or POS Response


Acquirer
Device
Host

Response Request

Request

Response
VCMS
VAP VIC
Test Port

Response Request

= Role being
tested

= Role of VTS-
V.I.P.

Issuer
Host

Online Certification
As soon as you have completed offline testing and VCMS VisaNet Loopback testing, you
can perform online certification testing. You do not use VTS-V.I.P. in this configuration.
Your host computer runs tests through a VAP that is connected to the Visa VCMS V.I.P.
System, as shown in Figure 1–8 and Figure 1–9.

15 Mar 2013 Visa Confidential 1–11


Introduction to VTS-V.I.P. Visa Test System – V.I.P.
User’s Guide

Figure 1–8: Online Testing With V.I.P.—Certification Office as Issuer

Request

ATM or POS Response


Acquirer
Device
Host

Response Request

Request Request

= Role being
tested Response Response
VCMS Visa
VAP VIC Certification
Office

Figure 1–9: Online Testing With V.I.P.—Certification Office as Acquirer

Request Request Request

Response Response Response


Visa VCMS Issuer
Certification VIC VAP Host
Office

= Role being
tested

1–12 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Limitations of VTS-V.I.P.
User’s Guide

Limitations of VTS-V.I.P.
VTS-V.I.P. does not simulate all of the functionality of the V.I.P. System. The following
limitations apply when offline testing:

In VCMS VisaNet Loopback mode, VTS-V.I.P. does not download data defined in the
core V.I.P. globals for its processing.
● VTS-V.I.P. does not calculate fees for multicurrency processing.
● VTS-V.I.P. does not perform the following edits:

– Validation of interfield relationships


– Validation of intermessage relationships
The validations that VTS-V.I.P. supports are field edits—that is, field length, field type
(binary, hexadecimal, bits, and so forth), minimum and maximum values, table look-
ups, and checks for the presence of mandatory fields in a message.

VTS-V.I.P. Support
If you have a problem, first call your Visa representative for help. If your Visa
representative cannot solve your problem, please ask them to contact Inovant Global
Support Services.
Inovant Global Support Services will escalate your issue to VTS-V.I.P. Development using
all of the information you have provided to your Visa representative. Remember to include
a phone number where you can be reached in case Inovant Customer Support or VTS-
V.I.P. Development needs to call you back to troubleshoot your problem. Inovant
Customer Support is available 24 hours per day, seven days per week.
For troubleshooting, VTS-V.I.P. Development asks for the following information:
● The version of VTS-V.I.P. you are using.

The type of operating system.

The steps needed to re-create your problem.

15 Mar 2013 Visa Confidential 1–13


Getting Started 2

Before You Begin . . . . . . . . . . . . . . . . . . . . . 2–1

System Requirements . . . . . . . . . . . . . . . . . . 2–2

Installing VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . 2–3

Starting VTS-V.I.P. . . . . . . . . . . . . . . . . . . . . 2–4

Navigating VTS-V.I.P. . . . . . . . . . . . . . . . . . . . 2–5

Viewing Preferences . . . . . . . . . . . . . . . . . . . 2–9

VTS-V.I.P. Test Steps . . . . . . . . . . . . . . . . . . .2–13

Using Online Help. . . . . . . . . . . . . . . . . . . . .2–14

Uninstalling VTS-V.I.P. . . . . . . . . . . . . . . . . . .2–16

Before You Begin


Before you install and run the VTS-V.I.P. software, review the following recommendations:

If you are not sure about the hardware requirements for your system, check with your
system administrator. VTS-V.I.P. requires Windows XP or Windows Vista, with
Microsoft Remote Access Service (RAS) installed wherever necessary.

You must be set up as an administrator on the computer you use to install VTS-V.I.P.;
however, you do not need to be an administrator to run VTS-V.I.P.
● VTS-V.I.P. supports only the TCP/IP host interface protocols. Your protocol choice is
affected by several factors. If you plan to connect to a VAP, Visa recommends that
you choose the same protocol for VTS-V.I.P. as you will use for the VAP, if possible.
This ensures a smoother transition among the host link, VTS-V.I.P., and VAP.

15 Mar 2013 Visa Confidential 2–1


Getting Started Visa Test System – V.I.P.
User’s Guide

See Table 2–2 for protocol requirements and Chapter 3, Setting Up the
Communications Handler for more information on choosing a protocol.
● If an anti-virus application is running on your personal computer, disable it before
attempting to install VTS-V.I.P. Do not allow any anti-virus software to run in the
background. (However, be sure to enable it after you install VTS-V.I.P.)
● If you have difficulty installing the VTS-V.I.P. software, contact your Visa
representative.

System Requirements
VTS-V.I.P. should be installed on a computer running Windows XP or Windows Vista.
Table 2–1 provides the minimum and recommended system requirements.

Table 2–1: System Requirements

Hardware Minimum Configuration Recommended Configuration

Computer Pentium III, 550 MHz or higher Pentium III, 700 MHz or higher

Operating system One of the following is required: One of the following is required:
● Windows XP ● Windows XP
● Windows Vista (32 bit) ● Windows Vista (32 bit)
● Windows 7 (64 Bit) ● Windows 7 (64 Bit)

Free hard disk space 2 GB 4 GB

RAM 256 MB RAM 512 MB RAM

Monitor 1024x768 SVGA Display 1024x768 SVGA Display

2–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Installing VTS-V.I.P.
User’s Guide

Table 2–2 provides the communications protocols supported in VTS-V.I.P. and their
requirements.

Table 2–2: Protocol Requirements

Communications Requirements Supported in Windows


Protocol XP, Windows Vista, and
Windows 7

TCP/IP LAN Computer should be able to ping the VAP and vice-versa.
X

TCP/IP SLIP One of the following is required:


X
● NULL modem with two 25-to-9 cables OR
● US Robotics 56K V.90 modem, connected and
configured on an operating analog telephone line.

Installing VTS-V.I.P.
The VTS-V.I.P. application contains utilities that work together to create, edit and run tests,
and create logs and printouts of the results. VTS-V.I.P. includes the following components:
● Main VTS-V.I.P. application (referred to as Test Handler)
● Communications Handler
● Variables Manager
● Knowledgebase
● Log Comparison
● Log Server

Log Viewer

Raw Message Viewer
● Uninstall Utility
● User’s Guide

Help
When you install VTS-V.I.P., you also install the Visa-provided V.I.P. Knowledgebase. This
knowledgebase contains predefined templates according to product and service. You use
these messages to build your tests. (A separate installation is required for other
knowledgebases, such as Deluxe.)

15 Mar 2013 Visa Confidential 2–3


Getting Started Visa Test System – V.I.P.
User’s Guide

Installing the VTS-V.I.P. software makes the following changes to your system:
● Adds entries to your registry file.
● VTS3.ini and VTS3default.ini file.
● For multiple instances VTS-V.I.P. (0), (1), (2).ini files.
● Installs Microsoft Data Access Components (MDAC) 2.8 or later, if not already
installed.

To install VTS-V.I.P.:
1. Insert the VTS-V.I.P. CD-ROM into the CD-ROM drive or download the VTS-V.I.P.
installation files from VOL as appropriate.
2. Double-click the setup.exe file.
The default is set to install all files.
3. Follow the screen prompts to complete the installation, or download for VOL.
NOTE: After VTS-VIP v33.0 installation on WinXP, please replace the file
"C:\Program Files\Vts3\Appl\WinSCard.dll" with the existing file
"C:\Windows\System32\WinSCard.dll" in your workstation.

Starting VTS-V.I.P.
You can start all of the VTS-V.I.P. components, except the uninstall utility, from inside the
application. In addition, you can start some of the utilities from the Programs menu.

To start VTS-V.I.P.:
1. Click the Start button on the taskbar, point to Programs, and then click Visa Test
System Suite of Tools.
2. Click the Visa Test System icon or any of the icons to start that corresponding utility.
NOTE: You can also right-click any utility to create a shortcut for your desktop.

2–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Navigating VTS-V.I.P.
User’s Guide

Figure 2–1: Finding VTS-V.I.P. in the Start Menu

When you start the first VTS utility there is approximately a 15-second delay, due to
initiation of the Log Server. When you start subsequent VTS utilities, there will be no delay
as long as the Log Server is running. The Log Server runs in the background and the Log
Server icon remains in the taskbar.

Navigating VTS-V.I.P.
You can navigate through VTS-V.I.P. by clicking buttons or by selecting items from the
menus. Scroll bars allow you to view data that might not fit on your screen. Also, you can
adjust the size of many of the windows to fit your needs.
If a button or menu selection appears in dim print, this indicates that the function or option
is not available and is probably not applicable to your current activity.
The main VTS-V.I.P. window is divided into the Test Area on the left and the
Knowledgebase on the right. The Log Window displays current messages at the bottom of
this main window. You can also hide the Log Window.

15 Mar 2013 Visa Confidential 2–5


Getting Started Visa Test System – V.I.P.
User’s Guide

For optimal viewing with multiple instances, resize the windows to view the instances side
by side, rather than layering instances horizontally. This way, you can view the Log
Window in both instances.

Figure 2–2: Viewing the VTS-V.I.P. Log Window

NOTE: As you resize the window and it becomes narrower, some of the features on the
toolbar are not visible. You may select any of these features by using menu
options (File, Edit, View, Tools, Help).
VTS-V.I.P. includes a toolbar with buttons for quick access to commonly performed tasks.
There is also a status bar and indicator showing whether the communications line is up or
down.
Figure 2–3 illustrates the parts of the main VTS-V.I.P. window.

2–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Navigating VTS-V.I.P.
User’s Guide

Figure 2–3: Format of Main VTS-V.I.P. Window

Toolbar

Test Area Knowledgebase

Log Window
Status Bar

Communications Line Indicator

You can control whether to display the status bar or main toolbar by using the View menu.

To show or hide the Status Bar or Main Toolbar:


1. On the View menu, click Status Bar or Main Toolbar.

2. The view option you select appears in the main VTS-V.I.P. window.
You can control whether to show or hide the Log Window in Preferences. The view option
will take effect after you restart VTS-V.I.P.

15 Mar 2013 Visa Confidential 2–7


Getting Started Visa Test System – V.I.P.
User’s Guide

To show or hide the Log Window:


1. On the View menu, click Preferences. The Preferences dialog box appears.

Figure 2–4: Preferences Window

2. Select the Show log window for debugging check box.


3. Click OK to close the Preferences dialog box.

2–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Viewing Preferences
User’s Guide

Viewing Preferences
In Preferences, you can view the version number, installation directories, and internal
message template IDs.

To view the version of VTS-V.I.P. that you have installed:


1. On the View menu, click Preferences. The Preferences dialog box appears.

Figure 2–5: Preferences Window

The Installed Version box shows the version number of VTS-V.I.P. that is installed on
your computer. This value is for display only.
2. Click OK to close the Preferences dialog box.
On the Directories tab, you can view the installation directories.

15 Mar 2013 Visa Confidential 2–9


Getting Started Visa Test System – V.I.P.
User’s Guide

Viewing Directories
Follow these steps to view directories.

To view the directories where VTS-V.I.P. is installed:


1. On the View menu, click Preferences. The Preferences dialog box appears. Click the
Directories tab.

Figure 2–6: Preferences Window

This tab shows the directories where VTS-V.I.P. was installed. These values are for
display only.
2. Click OK to close the Preferences dialog box.

2–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Viewing Preferences
User’s Guide

Viewing Signons
You can view the internal message template IDs VTS-V.I.P. uses for credit and debit sign-
on and sign-off messages.

To view the internal message template identification:


1. On the View menu, click Preferences. The Preferences dialog box appears. Click the
Signons tab.

Figure 2–7: Preferences Window

This tab shows the business paths for BASE I and SMS sign-on and sign-off 0800
messages used when connected to the VCMS VAP. These values are for Visa internal
use only.
2. Click OK to close the Preferences dialog box.

15 Mar 2013 Visa Confidential 2–11


Getting Started Visa Test System – V.I.P.
User’s Guide

Viewing File Rotation


Follow these steps to view directories.

To view the directories where VTS-V.I.P. is installed:


1. On the View menu, click Preferences. The Preferences dialog box appears. Click the
File Rotation tab.

Figure 2–8: Preferences Window

This tab shows the file indicator for the types of files to rotate and the frequency of
scheduled rotation. These values can be adjusted as desired to avoid overfilling your
hard disk.
2. Check the File Rotation box to adjust file rotation parameters.
3. Adjust the files and options as needed.
4. Click Apply to apply any new settings.
5. OK to close the Preferences dialog box.

2–12 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. VTS-V.I.P. Test Steps
User’s Guide

The other tabs in Preferences are described in the chapters and sections listed below.

Preferences Tab Chapter and Section

Test Execution Chapter 7, Running a Test


“Setting Test Execution Preferences”

VCMS Login Parameters Chapter 12, Using VTS-V.I.P. with VCMS


“Setting VCMS Preferences”

Keys Chapter 7, Running a Test


“Using Keys in VTS-V.I.P.”

VivoTech 5000 / Castle Chapter 9, Using Card Readers,


Settings
"set configuration options"

VTS-V.I.P. Test Steps


This section briefly summarizes how to run a test using VTS-V.I.P. The remaining chapters
in the book explain in detail how to perform these steps.

Basic Test Steps


Before proceeding with these steps, you should have installed the VTS-V.I.P. software
and selected which host interface protocol to use. For more information, see Chapter 3,
Setting Up the Communications Handler.

To run a test using VTS-V.I.P.:


1. Start the VTS-V.I.P. application from the Programs menu.
2. Start the Communications Handler, and set it for your communications protocol. (For
details, see Chapter 3, Setting Up the Communications Handler.)
3. Create a new test or open a Visa-provided one. The new or opened test and
associated Knowledgebase appear in the main VTS-V.I.P. window. You can simply
drag messages from the Knowledgebase to your test, create new test cases, and
drag messages to reorder them. (See Chapter 4, Creating a Test.)
4. Change your test configuration settings. (See Chapter 4, Creating a Test.)
5. Designate that VTS-V.I.P. use a variables group. VTS-V.I.P. comes with several default
variables groups, or you can create your own user-defined variables in the Variables
Manager.

15 Mar 2013 Visa Confidential 2–13


Getting Started Visa Test System – V.I.P.
User’s Guide

Variables groups are designated for each case. Therefore, if a test is made up of
several cases, you could designate different variables groups for each. (See Chapter
5, Using Variables.)
6. Modify messages in the test at the field or subfield level with the Message Editor and
Field Editor. (See Chapter 6, Modifying a Test.)
7. Run the test. (See Chapter 7, Running a Test.)
8. Examine the test results with the Log Viewer after the test has been run. (See Chapter
8, Obtaining Test Results.)

Optional Test Steps


In addition to the basic test steps, you can:
● Install a card reader and use it in offline or online mode. In offline mode, VTS-V.I.P.
reads the card data and inserts it into a card variables group. You can save the data
and use it again.
In online mode, VTS-V.I.P. inserts the card values into the current message during test
execution. (See Chapter 9, Using Card Readers.)
● Export or import a test to move it to or from another computer running VTS-V.I.P. You
can also use the import feature to open a converted VTS2000 test. (See Chapter 10,
Exporting and Importing Tests and Files.)
● Ensure new enhancements do not impact existing functionality or pre-existing values.
(See Chapter 11, Automated Log Comparison.)
● Perform online testing with VAP and VCMS. (See Chapter 12, Using VTS-V.I.P. with
VCMS.)
● Perform online testing with EAS/Visa MG and VCMS. (See Chapter 13, Using VTS-
V.I.P. with EAS/Visa MG.)

Using Online Help


VTS-V.I.P. contains an online Help system you can access for up-to-date information.

To open the Help system, click the Help toolbar button (pictured at left), or, on the Help
menu, click Help Topics.

2–14 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using Online Help
User’s Guide

You can browse the expandable table of contents on the left-hand side of the screen.
Click the Contents tab and click any topic to display it on the right-hand side. Each
Contents entry has an icon that describes the type of topic it is linked to as shown in
Table 2–3.

Table 2–3: Online Help Icons

Icon Type of Topic

Conceptual topics provide background or contextual information


on a feature or process.

Task topics provide step-by-step instructions on how to perform a


task or series of tasks.

Reference topics provide detailed reference information, such as


context-sensitive help or field descriptions.

You can also search through Index entries. Click the Index tab, then type a word to
perform a search. When you find an Index entry that interests you, click to display the
topic or list of topics associated with it. Topics are often indexed under more than one
entry.
Also, you can use the search feature to locate every occurrence of a word or phrase in the
Help system. Click the Search tab, type the word, and click List Topics. When you find a
topic description of interest, click it to display the topic.
In addition, in many dialog boxes you can click the Help button or Help menu to access a
context-sensitive Help topic. Context-sensitive Help provides information about the
purpose of the dialog box, how to complete it, and related topics.

15 Mar 2013 Visa Confidential 2–15


Getting Started Visa Test System – V.I.P.
User’s Guide

Uninstalling VTS-V.I.P.
You can uninstall VTS-V.I.P. from the Programs menu.

To uninstall VTS-V.I.P.:
1. Click the Start button on the taskbar, point to Programs, and then click Visa Test
System Suite of Tools.
2. Click the Uninstall Visa Test System icon, and the VTS-V.I.P. application will be
removed from the system.

2–16 Visa Confidential 15 Mar 2013


Setting Up the Communications
Handler 3

Introduction to the Communications Handler . . . . . . . 3–1

Configuring Your System for TCP/IP Protocols . . . . . . 3–3

Setting Your Protocol in the Communications Handler . .3–12

Configuring the Modem Eliminator . . . . . . . . . . . .3–13

Introduction to the Communications Handler


This section describes how to set up the Communications Handler using various host
interface protocols, and how to install and configure additional hardware components
required to run VTS-V.I.P. on your system.
The Communications Handler is incorporated into the VTS-V.I.P. application and can be
accessed from within VTS-V.I.P. by selecting Start Communications from the Tools drop
down menu or by clicking the corresponding icon button on the toolbar.
If you have not installed VTS-V.I.P. yet, before continuing with this section, follow the
instructions in Chapter 2, Getting Started.

Navigating the Communications Handler Window


VTS-V.I.P. uses the Communications Handler to transmit test messages to and from the
remote host, VAP, or VCMS. For more information on possible configurations, see “How
VTS-V.I.P. Works With the V.I.P. System” in Chapter 1.
The Communications Handler shows whether your communications line is up and which
protocol you have selected. You can send and receive test messages and see data
flowing across the hardware.

15 Mar 2013 Visa Confidential 3–1


Setting Up the Communications Handler Visa Test System – V.I.P.
User’s Guide

Figure 3–1 shows the Communications Handler window.

Figure 3–1: Communications Handler Window

Toolbar

Status
Indicators

Raw Messages

Log

The Communications Handler dialog box contains the following indicators:



Session—Shows the status about the current session.

Sent—Shows the number of messages that have been sent.
● Received—Shows the number of messages that have been received.
● Line—Shows whether the communications line is up or down.

Protocol—Shows the current protocol.
The Raw Messages area shows the current incoming or outgoing message in
hexadecimal format, before it is parsed by VTS-V.I.P. You can also save raw messages in
a separate file and view them when the Communications Handler is not running. See
“Using the Raw Message Viewer” in Chapter 8 for more information.

3–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Configuring Your System for TCP/IP Protocols
User’s Guide

The Log shows communications line messages that provide information about the status
and activity of the Communications Handler. It also shows the severity of the error
message (Informational, Warning, or Fatal).

Choosing a Protocol
The Communications Handler supports the following host interface protocols:
● TCP/IP LAN
● TCP/IP SLIP (direct or modem)
Set your protocol in the Communications Handler on the General tab. (This procedure is
described later in this chapter in “Setting Your Protocol in the Communications Handler.”)

Configuring Your System for TCP/IP Protocols


You can set up a system to run VTS-V.I.P. with TCP/IP in one of two ways:
● Through a LAN connection that supports TCP/IP.
● Through a serial port using the SLIP protocol.
Using the TCP/IP protocol, the Communications Handler and remote host work in a client/
server relationship. With a LAN connection, you can set either party as the client, and the
other party as the server. With a SLIP connection, you cannot set the Communications
Handler as the server because the Windows XP and Windows Vista workstations do not
support a SLIP dial-in connection.
The server listens to a designated port waiting for the client connection request. The client
must use this port to communicate with the server.
If you set VTS-V.I.P. as the server, it waits for an incoming connection request from the
host system. When you issue the Line/Start command, the Communications Handler
waits for connections using a designated port. Therefore, the host system must connect to
the VTS-V.I.P. port.

Using TCP/IP LAN


Visa does not provide the TCP/IP software. Visa assumes that the computer attached to
the LAN has the TCP/IP networking hardware and software (that is, Token Ring, Ethernet)
and has already been configured for support of other TCP/IP applications (like e-mail).
Next, see “Setting Your Protocol in the Communications Handler” later in this chapter in
order to select TCP/IP on the general tab, and then return to this section to continue
setting up the specific parameters for the TCP/IP tab.

15 Mar 2013 Visa Confidential 3–3


Setting Up the Communications Handler Visa Test System – V.I.P.
User’s Guide

To set the communications protocol for TCP/IP LAN:


1. From the menu bar, select Tools>Start Communications... The VTS
Communications Handler window opens.
2. Select Tools>Protocol Options. The Communications Handler Settings window
opens.
3. Click the TCP/IP tab.

Figure 3–2: TCP/IP Tab

NOTE: Effective November 2005, SNA LU0, X.25, BSC 3270, and BSC 2780 are not
supported.
4. Select whether VTS-V.I.P. will play the Client or Server role. (Typically, VTS-V.I.P. acts
as the Client and the remote host system acts as the Server.)
NOTE: VMLH (B2 B3 Hex) is for development use only.
5. Type the IP Address of the computer on which VTS-V.I.P. is running.

3–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Configuring Your System for TCP/IP Protocols
User’s Guide

To determine the IP address of the computer, open a DOS window by clicking the
Start button on the taskbar, and clicking Run. Type Command in the dialog box. In
the DOS window, type IPCONFIG.
NOTE: If you click the TCP/IP tab, and then select Server, the Communications Handler
autodetects the VTS IP address; you do not have to find it using IPCONFIG. You
can do this on both the issuer PC and the acquirer PC by entering the
corresponding HOST IP address.
For multiple instances, the client Host IP Address and Port data should be used
for the server VTS IP Address and Port.
For a TCP/IP LAN connection, if you use an incorrect local IP address or a virtual
IP address used in the TCP/IP SLIP connection, you can establish the
connection with the remote host, but cannot change the VCMS loopback mode.
6. If VTS-V.I.P. is acting as the Client:
– Type the IP Address of the remote host system.
– Type the 4-digit Port number where the remote host system is listening.
If VTS-V.I.P. is acting as the Server:
– Type a 4-digit Port number. This can be any value from 1024 through 32767, as
long as this port number is not used by another server application on your
computer.
7. Under Link Protocol, click LAN.
8. Click Apply to save the settings, and click OK to close the dialog box.

Using TCP/IP SLIP–Direct


This section describes how to set up the Communications Handler on a serial port using
the TCP/IP SLIP protocol with a serial cable. You need to connect a null modem and
configure your Microsoft Remote Access Service (RAS).
NOTE: The null modem you used for VTS2000 may not work for VTS-V.I.P.
See “Connecting a Null Modem.”
If the VTS-V.I.P. computer is more than 50 feet away from the VAP or member host, you
need to configure the Communications Handler to use a dial-up modem. Refer to the next
section, “Using TCP/IP SLIP - Modem.”

15 Mar 2013 Visa Confidential 3–5


Setting Up the Communications Handler Visa Test System – V.I.P.
User’s Guide

Connecting a Null Modem


A null modem is a 25 to 25-pin connector that connects two serial cables.
To connect to a system other than a VAP, you must modify the user ID and password in
the dial-up script. The name of the default script file is SapphireSlip.scp. You can find the
script files in the RAS directory: C:\WINNT (or windows
directory)\System32\RAS\SapphireSlip.scp.
NOTE: The default user name is slip and the password is vts. Enter these as lowercase
characters.
Visa has tested the following null modems from Black Box Network Services
(www.blackbox.com):
#522303, Pinning B (F/F)
#522301, Pinning B (M/F)
#522302, Pinning B (M/M)
NOTE: Visa selected this null modem configuration for VTS-V.I.P. because it adheres to
the Microsoft RAS standard; it differs from the null modem used for VTS2000.

To set up the null modem pin settings:


1. Set the pins on the null modem so that the following pins are crossed over:
– 2 (TxD) and 3 (RxD)
– 4 (RTS) and 5 (CTS)
– 6 (DSR) and 20 (DTR)
– 8 (DCD) and 20 (DTR)
Figure 3–3 shows the settings for the null modem pin installation.

Figure 3–3: Null Modem Pins


1 — 1
2 — 3
1 2 3 4 5 6 7 8 20 3 — 2
4 — 5
5 — 4

6
— 20
8
6
1 2 3 4 5 6 7 8 20 20 —
8
7 — 7

2. Insert one end of the 9- to 25-pin connector into the computer.

3–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Configuring Your System for TCP/IP Protocols
User’s Guide

3. Insert the other end of the 9- to 25-pin connector into the null modem.
4. Insert one end of the 25-pin cable into the null modem and the other end into the host
or VAP. If you are connecting to a VAP, use communications port 2.

Configuring RAS
You need to configure Microsoft Remote Access Service (RAS) if you are connecting
through a TCP/IP SLIP connection.
NOTE: Your system administrator should have already installed your Remote Access
Service (RAS).
Windows XP includes support for Unimodem modems. If you attempt to use a device with
RAS that is not supported by Unimodem, you may need to configure RAS to use the
Modem.inf file (instead of using Unimodem) to retrieve initialization information for the
devices you add.
When you install VTS-V.I.P., it sets the EnableUnimodem=0 to allow RAS to add the direct
connect serial cable (Dial-Up Networking Serial Cable between 2 PCs). The VTS-V.I.P.
installation also updates your Modem.inf file to add the lines for Dial-up Networking
Serial Cable between 2 PCs.
You need to set up your computer to use this entry. Follow the appropriate section
depending on whether you have a Windows XP operating system.

For Windows XP Operating System


Use this section if you have Windows XP.

To configure your RAS files (in Windows XP):


1. Click the Start button on the taskbar, point to Settings, and then click Control Panel.
2. Double-click Network and Dial-up Connections. The Network and Dial-up
Connections dialog box appears.
3. On the Advanced menu, click Network Identification. The System Properties dialog
box appears.
4. Click the Hardware tab, and click Hardware Wizard. The Add/Remove Hardware
Wizard dialog box appears.
5. Click Next, click Add/Troubleshoot a device, and click Next again. Windows
searches for new hardware but should not find any new modems.
6. Click Add a new device, and click Next.
7. Click No, I want to select the hardware from a list, and click Next.
8. Double-click Modems, select the Don’t detect my modem; I will select it from a list
check box, and click Next.
9. Select Serial Cable to VAP 2400 bps, and click Next.

15 Mar 2013 Visa Confidential 3–7


Setting Up the Communications Handler Visa Test System – V.I.P.
User’s Guide

10. Choose the port (COM1 or COM2) that will have the serial cable to the VAP, click
Next, and click Finish.
Follow the next section to set up your RAS Phone Book file.

To set up the RAS Phone Book (in Windows XP):


1. Click the Start button on the taskbar, point to Settings, and then click Control Panel.
2. Double-click Network and Dial-up Connections. The Network and Dial-up
Connections dialog box appears.
3. Right-click the Vap Via Serial Cable entry, and click Properties.
4. If the Location Information dialog box appears, type your area code, and click OK.
5. The Vap Via Serial Cable Properties dialog box appears. Click the General tab.
6. Click the Modem - Serial Cable to VAP 2400 bps (COM1) check box, and click
Configure. The Modem Configuration dialog box appears.
7. In the Maximum speed (bps) list, click 2400, clear all check boxes except Enable
modem speaker, and click OK.
8. Click the Options tab. Click Display progress while connecting and Redial if line
is dropped.
9. Click the Security tab, and click the Run script check box.
10. Click the Networking tab, click Internet Protocol (TCP/IP), and click Properties.
The Internet Protocol (TCP/IP) Properties dialog box appears.
11. In the IP address box, type the VAP’s “Mbr Slip IP Address.”
12. Click OK.
See “Setting Your Protocol in the Communications Handler” (below) to select TCP/IP on
the general tab and then return to this section to continue setting up the specific
parameters for the TCP/IP tab.

To set the communications protocol for TCP/IP SLIP (Direct):


1. On the Settings dialog box, click the TCP/IP tab.

3–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Configuring Your System for TCP/IP Protocols
User’s Guide

Figure 3–4: TCP/IP Tab

2. Click Client. (You cannot set the Communications Handler as the server because
Windows XP and Windows Vista workstations do not support a TCP/IP SLIP dial-in
connection.)
NOTE: VMLH (B2 B3 Hex) is for Development use only.
3. Type a virtual IP address specified by the VAP or remote host. This IP address should
be within the same subnet as the IP address of the VAP or remote host.
4. Type the IP Address of the remote host system.
5. Type the 4-digit Port number where the remote host system is listening.
6. Under Link Protocol, click SLIP, and click Direct.
7. In the Port list, select the communications port where you have attached the serial
cable to the null modem.
8. Click Apply to save the settings, and click OK to close the dialog box.

15 Mar 2013 Visa Confidential 3–9


Setting Up the Communications Handler Visa Test System – V.I.P.
User’s Guide

Using TCP/IP SLIP - Modem


This section describes how to set up the Communications Handler using the TCP/IP SLIP
protocol with a modem connection. You need to connect a dial-up modem.
You may also need to see the “Configuring the Modem Eliminator” section for
recommended modem eliminator settings.

Connecting a Dial-Up Modem


If the computer on which VTS-V.I.P. is installed is more than 50 feet away from the VAP or
the member host, you must configure the Communications Handler to use a dial-up
modem.

To connect a dial-up modem:


1. Connect the cable from the serial port to the modem.
2. Attach the phone line connection.
See “Setting Your Protocol in the Communications Handler” to select TCP/IP on the
general tab and then return to this section to continue setting up the specific parameters
for the TCP/IP tab.

To set the communications protocol for TCP/IP SLIP (Modem):


1. On the Settings dialog box, click the TCP/IP tab.

3–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Configuring Your System for TCP/IP Protocols
User’s Guide

Figure 3–5: TCP/IP Tab

2. Click Client. (You cannot set the Communications Handler as the server because
Windows XP and Windows Vista workstations do not support a TCP/IP SLIP dial-in
connection.)
NOTE: VMLH (B2 B3 Hex) is for Development use only.
3. Type a virtual IP address specified by the VAP or remote host. This IP address should
be within the same subnet as the IP address of the VAP or remote host.
4. Type the IP Address of the remote host system.
5. Type the 4-digit Port number where the remote host system is listening.
6. Under Link Protocol, click SLIP, and click Modem.
7. Type the phone number of the modem for the VAP.
8. In the Port list, select the communications port where you have attached the serial
cable to the dial-up modem.
9. In the Baud Rate list, select 9600 bps or higher if appropriate.

15 Mar 2013 Visa Confidential 3–11


Setting Up the Communications Handler Visa Test System – V.I.P.
User’s Guide

10. Click the Enable compression check box to enable data compression.
11. Click Apply to save the settings, and click OK to close the dialog box.

Setting Your Protocol in the Communications Handler


Once you install and configure any needed components or communications cards, you
are ready to set the Communications Handler to use the protocol.
Set protocol options on the general tab before starting the communications line. To
change these, you have to stop the communications line, change the settings, and restart
the line.

To set a communications protocol in the Communications Handler:


1. In the main VTS-V.I.P. window, click the Start Communications toolbar button, or on
the Tools menu, click Start Communications. The Communications Handler window
appears.

2. On the Tools menu, click Protocol Options. The Settings dialog box appears.

3–12 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Configuring the Modem Eliminator
User’s Guide

Figure 3–6: General Tab

3. In the Protocol list, click TCP/IP.


4. In the Card Type list, select the corresponding communications card.
5. To save messages in the original format (that is, as they appear before they are
parsed by VTS-V.I.P.) in a separate file, click the Save Raw Messages check box.
If you select to save raw messages, in the File box, type a path and file name, or click
Browse. (See Chapter 8 for details about using the Raw Message Viewer.)
6. Click Apply. Return to the applicable protocol configuration section to continue.

Configuring the Modem Eliminator


A modem eliminator simulates two modems. VTS-V.I.P. can be connected to one side of
the modem eliminator with an RS-232 cable and the member host can be connected to
the other side.
NOTE: You can use two modems or a short-haul modem if the host is more than 50 feet
from the VTS-V.I.P. computer, as long as one modem can automatically establish
a connection to the other modem.

15 Mar 2013 Visa Confidential 3–13


Setting Up the Communications Handler Visa Test System – V.I.P.
User’s Guide

Recommended Modem Eliminator Settings


The recommended modem eliminator settings are listed as follows:
● Switched carrier
● DSR follows DTR
● 9600 bps
● 8 ms RTS/CTS delay
If the modem eliminator settings are not set correctly, synchronous characters may be
dropped. This can cause the member host to receive only the first few synchronous
characters while the remainder of the message may be garbled.
NOTE: If you have a modem eliminator with panel lights, the RTS and CTS lights should
not be on unless data is being passed.

Sample Modem Eliminator Settings


Visa has tested the modem eliminator with the following settings:
● Datatel 2015 Modem Eliminator
– On—switched carrier, terminal side
– On—switched carrier, CPU side
– On—DSR follows DTR, terminal side
– On—DSR follows DTR, CPU side
– 4800 bps data rate, 4.8 KHz
– 8 ms RTS/CTS delay
● Teleprocessing Modem Eliminator
– 8.5 ms DTE 1 CTS delay
– 8.5 ms DTE 2 CTS delay
– 5 ms DTE 1 carrier detect delay
– 5 ms DTE 2 carrier detect delay
– Insert transmit data buffer DTE 1
– Insert transmit data buffer DTE 2
– 4800 bps data rate, 4.8 KHz

3–14 Visa Confidential 15 Mar 2013


Creating a Test 4

Understanding Test Structure . . . . . . . . . . . . . . . 4–1

Using Knowledgebases . . . . . . . . . . . . . . . . . . 4–3

Creating a Test . . . . . . . . . . . . . . . . . . . . . . 4–3

Changing Test Properties . . . . . . . . . . . . . . . . . 4–5

Using Visa-Supplied Tests . . . . . . . . . . . . . . . . 4–7

Adding a Test Case . . . . . . . . . . . . . . . . . . . . 4–7

Saving a Test as a Text File . . . . . . . . . . . . . . . . 4–7

About Test Configuration . . . . . . . . . . . . . . . . . 4–8

Setting Test Configuration. . . . . . . . . . . . . . . . .4–19

Inserting a Message Delay . . . . . . . . . . . . . . . .4–20

Understanding Test Structure


This section discusses the hierarchical structure of VTS-V.I.P. tests, cases, and
messages.
Tests, cases, and messages are stored in a database. A test can contain one or more test
cases and a test case can contain one or more messages. VTS-V.I.P. also includes test
configuration settings that affect a test. (This chapter describes test configuration in more
detail in a later section.)
Figure 4–1 illustrates the hierarchy that VTS-V.I.P. uses when running a test.

15 Mar 2013 Visa Confidential 4–1


Creating a Test Visa Test System – V.I.P.
User’s Guide

Figure 4–1: Test Hierarchy


Test

Configuration Properties Case 1 Case 2 Case 3


Settings

Message 1 Message 1 Message 1


Message 2 Message 2 Message 2
Message 3 Message 3
Message 4...

Case names within each test and message names within each case must be unique.
When you open a saved test in VTS-V.I.P., the cases and messages appear, as shown in
Figure 4–2.

Figure 4–2: Test Structure


Test

Case

Messages

Each message contains fields that contain data or references to data. You can edit these
fields to change data or references. A field may or may not have subfields.
NOTE: The properties at the test level are global and, once selected, override the case-
level properties.

4–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using Knowledgebases
User’s Guide

Using Knowledgebases
Knowledgebases are Visa-supplied databases designed to assist you in the testing
process. The Knowledgebases contain preset possible message definitions.
These preset definitions in the Knowledgebase are provided so that you can avoid
specifying all required values yourself. Each prototype definition already includes fields
that are optional, conditional, or mandatory for the specific function, and the Message
Type Indicator (MTI). The definition also contains default values for each field in the
request and response and the validation rules used for each field.
When you create a test, you associate a Knowledgebase with it. Then you can select a
message or group of messages from the Knowledgebase, and drag it (or them) to the test
case.
Figure 4–3 shows the format of the Knowledgebase.

Figure 4–3: Knowledgebase Format

Creating a Test
This section describes how to create a new test and add cases and messages to it.

To create a new test:


1. Click the New Test toolbar button, or from the menu bar, select File>New>Test.

The Create New Test dialog box appears.

15 Mar 2013 Visa Confidential 4–3


Creating a Test Visa Test System – V.I.P.
User’s Guide

Figure 4–4: Create New Test Dialog Box

2. Click to select the type of Knowledgebase that you want to associate with the test.
The type can be V.I.P. or Deluxe.
3. Click OK.
NOTE: To name the test, on the File menu, click Save As.
This creates a test which appears in the left pane of the window and contains one
empty test case. On the right pane, the Knowledgebase displays a tree with the
current available messages

Figure 4–5: Empty Test Case Window.

4. In the right pane, click to expand the Knowledgebase tree to open the Incoming
Request or Outgoing Request folder of the service desired.

4–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Changing Test Properties
User’s Guide

Figure 4–6: Incoming and Outgoing Request Folders

5. Drag a single message or pair of messages to the case in the left pane to add new
messages to test Case 1.

Figure 4–7: Adding Message Pairs

NOTE: You can also drag a folder and add all the messages in that folder to the test case
at the same time.
6. Click the Save toolbar button, or on the File menu, click Save.

Changing Test Properties


The Test Properties dialog box enables you to add a description for your test or to
designate a variables group for the entire test (including all test cases within that test.)
You can also designate a variables group at the test case level.

15 Mar 2013 Visa Confidential 4–5


Creating a Test Visa Test System – V.I.P.
User’s Guide

If you designate a variables group at the test level (in the Test Properties dialog box),
VTS-V.I.P. also updates all case properties. However, after this test-level update, you can
designate a variables group for individual cases (in the Case Properties dialog box).
For more information on designating a variables group, see “Designating a Variables
Group for the Test Case” in Chapter 5, Using Variables.
For information about match probability, see “Using Match Probability” in Chapter 7,
Running a Test.

To add a test description:


1. Click Properties under the test name. The Test Properties dialog box appears on the
right-hand side of the screen.

Figure 4–8: Test Properties Dialog Box

2. Type a description of your test in the box.


3. Click OK.

4–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using Visa-Supplied Tests
User’s Guide

Using Visa-Supplied Tests


VTS-V.I.P. includes many Visa-supplied tests. When you install the software, these tests
are installed in the Baseline_Test_Scripts folder. These tests are read-only; to modify one,
use the Save As feature.

To open a Visa-supplied test:


1. Click the Open toolbar button, or on the File menu, click Open. The Open dialog box
appears. Visa-supplied tests are in the Baseline_Test_Scripts folder.

2. Select a test file and click Open. The test opens in the left pane.
3. If you modify the test, use Save As to save it in your User_Test_Scripts folder.

Adding a Test Case


This section describes how to add cases to a test. Case names within a test must be
unique.
You can also copy an existing test case or drag and drop a case as a succeeding
transaction.

To create a new test case:


1. Open a test in the main VTS-V.I.P. window.
2. Click the New Case toolbar button, or on the File menu, click New and then click
Case. A new test case appears in the open test.

NOTE: To change the name of a case, double-click or right-click the case name, or click
Properties under the case name in the main VTS-V.I.P. window.

Saving a Test as a Text File


You can save a test or test cases as a Text file.

To save a test case as a Text document:


1. Open a test in the main VTS-V.I.P. window.
2. Click a test or a test case. To select multiple test cases, first click the test and then
press the CTRL key to select the cases.

15 Mar 2013 Visa Confidential 4–7


Creating a Test Visa Test System – V.I.P.
User’s Guide

3. On the Tools menu, click Export Case(s) To Text File. The Save As dialog box
appears.
4. Type a file name.

About Test Configuration


Test configuration settings affect the appearance and values of certain fields, and are
similar to the Global Service Flags feature in VTS2000.
Each configuration setting represents a service, such as Address Verification Service
(AVS) or Multicurrency Service. VTS-V.I.P. provides templates so that you can use existing
tests that use these services to test V.I.P. messages with your member host.
NOTE: VTS-V.I.P. does not perform any service processing by computing real-time
values. It provides a template that includes all necessary fields required for a
particular service.
Test configuration generally controls whether a particular field in a message is omitted or
is present and contains a default value. If set to No, then the field or fields associated with
the flag will have field values set to Omit. If the flag is set to Yes, the field will contain
default data.
EXAMPLE
When the AVS configuration setting is set to Yes, field 123 in the
request message and subfield 44.2 in the response message are
added to the original message and contain a default value. When the
AVS configuration setting is set to No, the above fields are marked
Omit and do not become part of the original message.
In another example, VTS-V.I.P. changes the value of an existing field in the original
message.
EXAMPLE
When the configuration setting for Chip Fields is set to Yes, the default
value in field 22.1 is changed to 05.
The effects described can also depend on:
● Whether VTS-V.I.P. acts as an issuer or acquirer.

The type of original message.
Setting a flag to Yes or No may not affect the original message if the associated business
function with which it is associated does not use the fields specific to that particular
service.
In other words, there may be business functions where the field is never valid, so it cannot
be added.

4–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. About Test Configuration
User’s Guide

EXAMPLE
Field 123 can be added to an authorization request for AVS
processing, but it cannot be included in reversals.
When you select a test configuration setting, VTS-V.I.P. generates default field values for
the fields affected by the setting; however, you can override these defaults by editing the
message and specifying literal values for any of the fields.
Table 4–1 provides a brief description of each configuration setting.

Table 4–1: Test Configuration Settings (1 of 5)

Configuration Setting Description

3rd Bitmap Expanded Chip Card Processing


● If set to Yes, an Expanded Format of the 3rd bitmap chip fields
is present in the message. Selecting Yes results in F134E and
F140 being used instead of F134/F135 and F139.
Note: This configuration setting is used in conjunction with the
3rd Bitmap Fields configuration setting. That is, 3rd Bitmap Fields
are set to Yes when 3rd Bitmap Expanded is set to Yes.
● If set to No, F134/F135 and F139 (nonexpanded) are used
(instead of F134E and F140).

3rd Bitmap Fields Chip Card Processing


● If set to Yes, 3rd bitmap chip fields are present in the
message, if appropriate. Three chip card types or flags
(VIS_3RD, CCD_EMV_3RD, and GEN_EMV_3RD) can be
selected from the drop-down menu. Please refer to related
documentation (that is, VIS 1.4.0 Technical Reference,
EMVCo manuals, and the like) for card type definitions.
● If set to No, chip fields are omitted from the message.

AVS Address Verification Service (AVS)—Indicates usage of AVS-


specific fields and default values. Uses fields 44.2, 123.1, and
123.2.

If set to Yes, AVS fields are present in the message, if
appropriate.
● If set to No, AVS fields are omitted from the message.

Bypass VCMS Stations Bypasses the station pairing VCMS establishes between the
member host and VTS-V.I.P. in VisaNet Loopback mode. If
selected, VTS-V.I.P. does not insert station IDs into header fields
5 and 6.

15 Mar 2013 Visa Confidential 4–9


Creating a Test Visa Test System – V.I.P.
User’s Guide

Table 4–1: Test Configuration Settings (2 of 5)

Configuration Setting Description

CPS Custom Payment Service (CPS)


● If set to Yes, field 62 is present in the message, if appropriate.
● If set to No, field 62 is omitted from the message.

Currency Precision Currency Precision Service—Used for field 63.13 to determine


the location of the decimal point in some amount fields. It is
independent of the Multicurrency Service settings.
● If set to Yes, field 63.13 is present in the message and given a
default value.

If set to No, field 63.13 is omitted from the message.

CVV Card Verification Value (CVV) Service—Indicates usage of CVV-


specific fields and default values.
● If set to Yes:
– Field 22.1 is present in the request message, and its value
changes from 02 to 90.
– Field 44.5 is present in the response message, with a value
of 2.
● If set to No:
– Field 22.1 is present in the request message, with a value
of 02.
– Field 44.5 is omitted from the response message.

Field 55 ● Field 55 is an ISO field used for transmitting chip data in Tag
Length Value (TLV) format. Field 55 can be used for chip
transactions. Field 55 contains a drop-down menu with the
following options: VIS_F55, CCD_EMV_F55, GEN_EMV_F55,
VIS_F55_2.

If set to Yes, field 55 is present in the message, if appropriate.
● If set to No, field 55 is omitted from the message.

Field 59 Field 59—National Point-of-Service Geographic Data



If set to Yes, field 59 is present in the message, if appropriate.
● If set to No, field 59 is omitted from the message.

Field 62 Bitmap This controls the format of field 62.


● If set to Yes, field 62 will be in the bitmap format, whenever it
is present in a message.
● If set to No, field 62 will display in the older, fixed format.

4–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. About Test Configuration
User’s Guide

Table 4–1: Test Configuration Settings (3 of 5)

Configuration Setting Description

Field 118 Field 118—Intra-Country Data


● If set to Yes, field 118 is present in the message, if
appropriate.
● If set to No, field 118 is omitted from the message.

Full Authorization Full Authorization Service


Service ● If set to Yes, field 122 is present in the message, if
appropriate.
● If set to No, field 122 is omitted from the message.

Message Format BASE I or V.I.P. message format—This field determines whether


VTS-V.I.P. creates messages that follow the ISO BASE I or V.I.P.
message format. Note that ISO BASE I does not include fields 19
and 25 in a response, while V.I.P. format shows these fields as
mandatory.

Multicurrency Fields Multicurrency Service—participation in Multicurrency processing.


Affects fields 5, 6, 9, 10, 16, 50, 51, 54, 61.2, and 61.3.

National Net Settlement National Net Settlement Service


● If set to Yes, field 119 is present in the message, if
appropriate.
● If set to No, field 119 is omitted from the message.

Special Account Special Account Number Service—Indicates usage of fields


related to Special Account Numbers. (These include account
numbers that would not be suitable for use in Field 2—Primary
Account Number.)

If set to Yes, fields 61.2, 61.3, 102, 103, and 121 are present
in the message, if appropriate.
● If set to No, these fields are omitted from the message.

PDOL Related Data Smart Card Transactions


During both online and offline smart card reads a popup window
called the PDOL Editor will be opened. Up to 45 bytes of
hexidecimal data may be entered. The length of the entry is
shown next to the entry field.
Note: If an odd number of nibbles is entered only the word
“Bytes” is displayed next to the entry field.

15 Mar 2013 Visa Confidential 4–11


Creating a Test Visa Test System – V.I.P.
User’s Guide

Table 4–1: Test Configuration Settings (4 of 5)

Configuration Setting Description

Network ID This controls the value of field 63.1(Network ID). Network ID


contains a drop-down menu with the following options:
VISA_NID0002
INLK_NID0003
PLUS_NID0004
CIRRUS_NID0006
MASTERCARD_NID0007
STAR_NID0008
PLUS_NID0009
STAR_NID0010
STAR_NID0011
STAR_NID0012
AFFN_NID0013
MOST_NID0014
STAR_NID0015
MAESTRO_NID0016
PLUSE_NID0017
NYCE_NID0018
PLUSE_NID0019
ACCEL_NID0020
ALERT_NID0021
EFT_NID0022
NETS_NID0023
CU24_NID0024
ALASKA_NID0025
GULFNET_NID0026
NYCE_NID0027
SHAZAM_NID0028
EBT_NID0029

4–12 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. About Test Configuration
User’s Guide

Table 4–1: Test Configuration Settings (5 of 5)

Configuration Setting Description

Network ID ● If set to VISA_NID0002 then F63.1=0002.


(continued) ● If set to INLK_NID0003 then F63.1=0003.
● If set to VISA_NID0004 then F63.1=0004.
● If set to CIRRUS_NID0006 then F63.1=0006.
● If set to MASTERCARD_NID0007 then F63.1=0007.
● If set to STAR_NID0008 then F63.1=0008.
● If set to PLUS_NID0009 then F63.1=0009.
● If set to STAR_NID0010 then F63.1=0010.
● If set to STAR_NID0011 then F63.1=0011.
● If set to STAR_NID0012 then F63.1=0012.
● If set to AFFN_NID0013 then F63.1=0013.
● If set to MOST_NID0014 then F63.1=0014.
● If set to STAR_NID0015 then F63.1=0015.
● If set to MAESTRO_NID0016 then F63.1=0016.
● If set to PLUSE_NID0017 then F63.1=0017.
● If set to NYCE_NID0018 then F63.1=0018.
● If set to PLUSE_NID0019 then F63.1=0019.
● If set to ACCEL_NID0020 then F63.1=0020.
● If set to ALERT_NID0021 then F63.1=0021.
● If set to EFT_NID0022 then F63.1=0022.
● If set to NETS_NID0023 then F63.1=0023.
● If set to CU24_NID0024 then F63.1=0024.

If set to ALASKA_NID0025 then F63.1=0025.
● If set to GULFNET_NID0026 then F63.1=0026.
● If set to NYCE_NID0027 then F63.1=0027.

If set to SHAZAM_NID0028 then F63.1=0028.
● If set to EBT_NID0029 then F63.1=0029.

VTS-V.I.P. provides context-sensitive Help in the status bar for the Test Configuration
dialog box. As you point to a test configuration setting, the status bar indicates which
fields it affects.

15 Mar 2013 Visa Confidential 4–13


Creating a Test Visa Test System – V.I.P.
User’s Guide

For more information about field usage and valid values, refer to the V.I.P. System BASE I
Technical Specifications document and the V.I.P. System SMS technical specifications
manuals. For more information about individual services, refer to V.I.P. System Services.
The following sections provide more information on each configuration setting.

3rd Bitmap
3rd Bitmap Expanded and 3rd Bitmap Fields each have two options: yes and no.
When 3rd Bitmap Expanded is set to Yes, the Expanded Format of the 3rd bitmap chip
fields is present in the message. Selecting Yes results in F134E and F140 being used
instead of F134/F135 and F139.
If No is selected, F134/F135 and F139 (nonexpanded) are used (instead of F134E and
F140).
This configuration setting is used in conjunction with the 3rd Bitmap Fields configuration
setting. That is, 3rd Bitmap Fields are set to Yes when 3rd Bitmap Expanded is set to Yes.
If 3rd Bitmap Fields is set to Yes, 3rd bitmap chip fields are present in the message, if
appropriate. One of three chip card types or flags (VIS_3RD, CCD_EMV_3RD, and
GEN_EMV_3RD) can be selected from the drop-down menu. Please refer to related
documentation (that is, VIS 1.4.0 Technical Reference, EMVCo manuals, and the like) for
card type definitions.
If set to No, chip fields are omitted from the message.

Address Verification Service (AVS)


Acquirers use the Address Verification Service (AVS) to verify cardholders’ billing
addresses. Setting the AVS configuration setting to Yes adds Field 123—Address
Verification Data to request messages. It also adds Field 44.2—Address Verification
Result Code to any response message. VTS-V.I.P. then places default values in fields
123.1 and in 123.2, the postal code and address fields. You can specify AVS or IAVS.

Bypass VCMS Stations


This test configuration setting bypasses the station pairing VCMS establishes between
the member host and VTS-V.I.P. in VisaNet Loopback mode. If selected, VTS-V.I.P. does
not insert the station IDs of the member host and VTS-V.I.P. into Header Field 5—
Destination Station ID and Header Field 6—Source Station ID. See Chapter 12 for more
information on testing with VCMS.

Custom Payment Service (CPS)


The Custom Payment Service (CPS) consists of transaction processing requirements
designed to reduce exception item processing costs by improving transaction integrity
and life-cycle control.

4–14 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. About Test Configuration
User’s Guide

Custom Payment Service (CPS) adds field 62 and subfields to appropriate messages.
CPS transactions qualify for a different interchange rate.

Currency Precision Service


The Currency Precision Service configuration setting adds field 63.13 to messages where
needed. It includes information on where to position the decimal place in various amount
fields.
The field carries the decimal positions for the transaction amount, the settlement amount,
and the cardholder amount fields. It is independent from the Multicurrency Service
configuration setting.

Card Verification Value (CVV) Service


The Card Verification Service is a specific check value calculated from the data encoded
on the magnetic stripe by using a cryptographic process and a key word known only to an
issuer and Visa. Both the issuer and acquirer must be CVV members for card verification
to take place.
Card Verification Service is checked on all authorization and financial requests, including
those with PINs, using information supplied by an issuer and acquirer, which is stored in
systems tables (formerly called the system globals). This configuration setting affects
Field 22.1—POS Entry Mode Code and Field 44.5—CVV Results Code.

Field 55
Field 55 is an ISO field used for transmitting chip data in Tag Length Value (TLV) format.
Field 55 can be used for chip transactions. Field 55 contains a drop-down menu with the
following options: VIS_F55, CCD_EMV_F55, GEN_EMV_F55,VIS_F55_2.
If this field is set to yes, it is present in the message, if appropriate. If it is set to no, it is
omitted from the message.

Field 59
Field 59 is a national-use field that identifies an intra-country geographical location. For
instance, it is used in the U.S. and Canada to include the state code or province code, and
sometimes the ZIP or postal code.

Field 62 Bitmap
Field 62 can be formatted in bitmap or fixed format.
If the Field 62 Bitmap configuration setting is set to Yes, field 62 appears in bitmap format,
whenever it is present in a message. If it is set to No, field 62 appears in fixed format.

15 Mar 2013 Visa Confidential 4–15


Creating a Test Visa Test System – V.I.P.
User’s Guide

See V.I.P. System BASE I Technical Specifications and the V.I.P. System SMS technical
specifications manuals for details on field 62.

Field 118
Field 118—Intra-Country Data is a national-use field that contains information unique to
the processing of Visa messages by members in a given country.
If you set the Field 118 configuration setting to Yes, you can specify Japan, Korea, or
another country.

Full Authorization Service


Visa uses this configuration setting to contain the amount of the cardholder's remaining
open-to-use balance which is stored in the Full Authorization File at the VIC. It includes
the use of the amount in field 122, which is a field that remains an open-to-use field and
contains field sign C or D as well as an amount.

Message Format
The Message Format configuration setting determines whether messages are in BASE I
or V.I.P. message format. V.I.P. format requires fields 19 and 25 in response messages,
but BASE I does not.

Multicurrency Service
The Multicurrency Service configuration setting in VTS-V.I.P. simulates main parts of the
Multicurrency component of the V.I.P. System. VTS-V.I.P. emulates this functionality so
that you can test your member host’s software by processing Multicurrency Service fields.
It consists of the conversion of transaction amounts and currency codes of outgoing
messages if the Multicurrency configuration setting is set to Yes. To calculate a value for
field 6, VTS-V.I.P. multiplies the value in field 4 by the Billing Rate issuer variable.

National Net Settlement Service


The National Net Settlement Service is available for countries whose issuers and
acquirers have negotiated a separate settlement agreement for domestic transactions. To
participate, the merchant, acquirer, and issuer must be located in the same country, and
the transaction currency is the local currency.
The National Net Settlement Service configuration setting specifies how a transaction
should be settled, and indicates the inclusion of field 119 where appropriate.
If you set the National Net Settlement setting to Yes, you can select the layout of F119.

4–16 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. About Test Configuration
User’s Guide

Special Account Numbers


The Special Account Number configuration setting affects fields used in the processing of
account numbers. It can affect the presence of fields 102, 103, and 121.
This configuration setting should not be used in field 2 to carry account identification
information or when an issuer cannot be determined from the primary account number.

PDOL Related Data


Some chip cards require PDOL Related Data. While reading those chip cards through
Smart card readers (Gempc Twin, Cherry Key board) during both online and offline reads,
if the "PDOL Related Data” flag is set as “Yes” in config, a popup window called the PDOL
editor will be opened to allow the user to enter the hexadecimal PDOL Related Data. The
entry field will accept up to 45 bytes of hexadecimal data. Any previously entered PDOL
Related Data will be pre-populated in the window. However, the user can modify any
previous value with a new value. When the user enters a new value, the number of bytes
will be dynamically calculated and displayed in the PDOL editor next to the entry field.
NOTE: If an odd number of nibbles is entered only the word “Bytes” is displayed next to
the entry field. The editor will also display an error when the user clicks OK if
there is an odd number of nibbles or non-hexadecimal data in the entry field.
If the "PDOL Related Data” flag is set as "No" in config and the card requires PDOL
Related Data, VTS will send the default values in the GPO (Get Processing Option)
command.
In either case, if the terminal receives a good status word (9000) in the GPO response,
the card will be read successfully. However, if the terminal receives a status word other
than 9000 in the GPO response, an error message will be displayed.

Network ID
Field 63.1 contains Network ID that specifies the network to be used for transmission of
the message and determines the program rules that apply to the transaction.

If user selects VISA_NID0002 then the value of F 63.1 would be 0002.
● If user selects INLK_NID0003 then the value of F 63.1 would be 0003.
● If user selects VISA_NID0004 then the value of F 63.1 would be 0004.

If user selects CIRRUS_NID0006 then the value of F 63.1 would be 0006.
● If user selects MASTERCARD_NID0007 then the value of F 63.1 would be 0007.
● If user selects STAR_NID0008 then the value of F 63.1 would be 0008.
● If user selects PLUS_NID0009 then the value of F 63.1 would be 0009.
● If user selects STAR_NID0010 then the value of F 63.1 would be 0010.

If user selects STAR_NID0011 then the value of F 63.1 would be 0011.

15 Mar 2013 Visa Confidential 4–17


● If user selects STAR_NID0012 then the value of F 63.1 would be 0012.
● If user selects AFFN_NID0013 then the value of F 63.1 would be 0013.
● If user selects MOST_NID0014 then the value of F 63.1 would be 0014.
● If user selects STAR_NID0015 then the value of F 63.1 would be 0015.
● If user selects MAESTRO_NID0016 then the value of F 63.1 would be 0016.
● If user selects PLUSE_NID0017 then the value of F 63.1 would be 0017.
● If user selects NYCE_NID0018 then the value of F 63.1 would be 0018.
● If user selects PLUSE_NID0019 then the value of F 63.1 would be 0019.
● If user selects ACCEL_NID0020 then the value of F 63.1 would be 0020.
● If user selects ALERT_NID0021 then the value of F 63.1 would be 0021.
● If user selects EFT_NID0022 then the value of F 63.1 would be 0022.
● If user selects NETS_NID0023 then the value of F 63.1 would be 0023.
● If user selects CU24_NID0024 then the value of F 63.1 would be 0024.
● If user selects ALASKA_NID0025 then the value of F 63.1 would be 0025.
● If user selects GULFNET_NID0026 then the value of F 63.1 would be 0026.
● If user selects NYCE_NID0027 then the value of F 63.1 would be 0027.
● If user selects SHAZAM_NID0028 then the value of F 63.1 would be 0028.
● If user selects EBT_NID0029 then the value of F 63.1 would be 0029.
NOTE: Default network ID of all messages is VISA_NID0002 except Interlink and Plus
ATM messages. Default network ID of interlink messages is
INLK_NID0003(0003) and Plus ATM is VISA_NID0004 (0004). User can't change
interlink and Plus ATM messages network ID from configuration setting.
Visa Test System – V.I.P. Setting Test Configuration
User’s Guide

Setting Test Configuration


Configuration appears in the Test Area. Each test has its own configuration file associated
with it, and configuration settings for one test do not affect any other test.

To change Test Configuration:


1. Click Config in the Test Area. The Test Configuration dialog box for that test appears
on the right-hand side of the screen.

Figure 4–9: Test Configuration Dialog Box

Name represents the common name used for the service and Flag represents an
internal description of the flag. In some cases, the Flag column includes a drop-down
list.
For instance, if you set the AVS configuration setting to Yes, you can also specify AVS
or IAVS.
2. Double-click the Y/N column to select whether the field is set to Yes or No. (By
default, all services are set to No.)
3. Click OK to save your selections.
VTS-V.I.P. changes the fields and messages and the main VTS-V.I.P. window appears.

15 Mar 2013 Visa Confidential 4–19


Creating a Test Visa Test System – V.I.P.
User’s Guide

Inserting a Message Delay


You can insert a message delay for an outgoing message, and set the length of the delay
in seconds, minutes, or hours.
When you use this feature, VTS-V.I.P. inserts a delay placeholder into the case. You can
move a delay within a case; however, it only affects the next outgoing message within that
case.

To insert a delay:
1. Select a message in the main VTS-V.I.P. window.
2. Click the Insert Delay toolbar button, or on the File menu, click New and then click
Delay.

VTS-V.I.P. inserts a Delay icon before the test and the Delay dialog box appears.

Figure 4–10: Delay Dialog Box

3. Type the length of the delay in the Hours, Minutes or Seconds boxes.
4. Click the Save toolbar button, or on the File menu, click Save.

4–20 Visa Confidential 15 Mar 2013


Using Variables 5

Introduction to Using Variables . . . . . . . . . . . . . . 5–2

Default Variable Groups. . . . . . . . . . . . . . . . . . 5–3

Opening a Variables Group . . . . . . . . . . . . . . . .5–11

Creating a New Variables Group . . . . . . . . . . . . .5–13

Modifying a Variable. . . . . . . . . . . . . . . . . . . .5–14

Selecting the Default Variables Group . . . . . . . . . .5–16

Associating Card and Issuer Variables Groups . . . . . .5–17

Deleting a Variables Group . . . . . . . . . . . . . . . .5–18

Printing a Variables Group . . . . . . . . . . . . . . . .5–19

Saving a Variables Group as a Word Document . . . . .5–19

Creating a User-Defined Variable . . . . . . . . . . . . .5–19

Modifying a User-Defined Variable . . . . . . . . . . . .5–21

Using a User-Defined Variable in a Test Case . . . . . .5–23

Deleting a User-Defined Variable . . . . . . . . . . . . .5–23

Designating a Variables Group for the Test Case . . . . .5–24

15 Mar 2013 Visa Confidential 5–1


Using Variables Visa Test System – V.I.P.
User’s Guide

Introduction to Using Variables


Variables are a powerful feature in VTS-V.I.P. that can be used from one test or test case
to another. You can change a variable once and have this change reflected in all tests
using that variable.
The Variables Manager contains variables in a database as various table entries.
Variables are arranged according to message format (for example, V.I.P.). Within each
message format, variables are then grouped according to the main functions of message
processing as follows:
● Acquirer variables
● Card variables
● Issuer variables
● System variables
● User-defined variables
The Variables Manager appears in a hierarchical display, similar to the main VTS-V.I.P.
window. Once you open a message format database, the five variables group folders
appear on the left-hand side. Click the plus symbol (+) next to any of the variables folders
to expand and display the groups in that folder.
With a variables group open, you can click the top of the Field ID, Name, or Description
column to sort the information in ascending or descending order.
Figure 5–1 shows the variables groups in the left-hand pane of the Variables Manager
window.

Figure 5–1: How Variables Are Arranged

Message Format

Message Processing Group

Variables Groups

5–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Default Variable Groups
User’s Guide

Within the acquirer, card, issuer, and system group folders, you can maintain one or
several groups of variables. When you install VTS-V.I.P., you receive one default group in
each folder.
The default variables groups are marked default and cannot be deleted. However, once
you create other groups, you can designate a different one as the default group.
In the user-defined folder, you maintain only one group of variables. When you install
VTS-V.I.P., this group is empty.

You can edit variables in any group, and add or delete variables in the user-defined group.
In addition, you can make a copy of any group, using the save as feature, to create a new
group with a new name.
NOTE: For an open test, any changes to variables will not appear in the test cases until
you close and reopen the test.

Default Variable Groups


The following section describes the variables defined in each group.

15 Mar 2013 Visa Confidential 5–3


Using Variables Visa Test System – V.I.P.
User’s Guide

Acquirer Variables
Acquirer variables relate to acquirer identification and processing. Table 5–1 lists the
primary fields where the values are used. However, values may be used in other fields.

Table 5–1: Acquirer Variables and Primary Fields (1 of 2)

Field ID Variable Name Description Value

F018 MERCHTYPE Merchant Type (Merchant Category Code) 6012*


- F 18

F019 ACQCTRY Acquirer Country Code - Field 19 840*

F025 POS COND CODE POS Condition Code - Field 25 00*

F032 ACQIID Acquirer Identification Code - Field 32 12345678901

F033 FORWDG INSTN ID Forwarding Institution ID - Field 33 12345678901

F041 CARD ACCEPTOR TERM Card Acceptor Terminal ID - Field 41 12345678


ID

F042 CARD ACCEPTOR Card Acceptor Identification Code - Field CARD ACCEPTOR
CODE 42

F043.01 ACQNAME Acquirer Name - Field 43.1 ACQUIRER NAME

F043.02 CITYNAME City Name - Field 43.2 CITY NAME

F043.03 CTRYCODE Country Code - Field 43.3 US*

F049 ACQCUR Acquirer Currency Code - Field 49 840*

F059.01 STATECODE State Code - Field 59.1 06*

F059.02 COUNTY County Code - Field 59.2 000

F059.03 POSTCODE ZIP Code - Field 59.3 94044

F130/F55 TERM CAP PROF Terminal Capability Profile - Field 130 - 204000
Tag 9F33 (Chip)

F131/F55 TERM VERI RESULTS Terminal Verification Results - Field 131 - 8000100000
Tag 95 (Chip)

5–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Default Variable Groups
User’s Guide

Table 5–1: Acquirer Variables and Primary Fields (2 of 2)

Field ID Variable Name Description Value

F132/F55 UNPRE NUM Unpredictable Number - Field 132 - Tag 9BADBCAB


9F37 (Chip)

F133/F55 TERM SER NUM Terminal Serial Number - Field 133 - Tag 99999999
9F1E (Chip)

F144/F55 CRYPT TXN TYPE Cryptogram Transaction Type - Field 144 - 00


Tag 9C(Chip)

F145/F55 TERMCTRY Terminal Country Code - Field 145 - Tag 840


9F1A (Chip)

F146/F55 TERM TXN DATE Terminal Transaction Date - Field 146 - 010101
Tag 9A (Chip)

F147/F55 CRYPT AMT Cryptogram Amount - Field 147 - Tag 000000012300


9F02 (Chip)

F148/F55 CRYPCURR Cryptogram Currency Code - Field 148 - 840


Tag 5F2A (Chip)

F149/F55 CRYPT CASHBACK AMT Cryptogram Cashback Amount - Field 149 000000000000
- Tag 9F03 (Chip)

NOTE: * These fields contain a drop-down menu from which to select a value. The value
indicated is an example.

Card Variables
Card variables relate to a credit or debit card. Table 5–2 lists the primary fields where the
values are used. However, values may be used in other fields.

Table 5–2: Card Variables and Primary Fields (1 of 3)

Field ID Variable Name Primary Field Value

F002 PAN Primary Account Number - Fields 2, 4034567890123456


35.1 and 45.2

15 Mar 2013 Visa Confidential 5–5


Using Variables Visa Test System – V.I.P.
User’s Guide

Table 5–2: Card Variables and Primary Fields (2 of 3)

Field ID Variable Name Primary Field Value

F014 EXPDATE Expiration Date - Fields 14, 35.3, 0309


45.6 and 48.5 (yymm)

F023 CARD SEQ NUM Card Sequence Number - Field 23 001

F035.04 SVCCODE Service Code - Fields 35.4 and 45.7 123

F035.05 PVV PIN Verification Code - Fields 35.5 12345


and 45.8

F035.06 DISDATA Track2 Discretionary Data - Field 000


35.6

F045.01 FORMAT CODE Track1 Format Code - Field 45.1 B

F045.04 CARD HOLDER NAME Track1 Card Holder Name - Field CARD HOLDER NAME
45.4

F045.09 DISCODE Track1 Discretion Code - Field 45.9 1234567890

F045.10 VISARESV Track 1 Visa Reserved Data - Field N/A


45.10

F052 PIN DATA Personal Identification Number - 1234


Field 52

F125.025 MICRDATA1 MICR Data Segment - Field 125.2 AB009321076470


(POS Check)

F125.034 MICRDATA2 MICR Data Segment - Field 125.3 AN01474600020267210


(POS Check)

F125.048 MICRDATA3 MICR Data Segment - Field 125.4 CK0040099


(POS Check)

F125.057 MICRDATA4 MICR Data Segment - Field 125.5 CK0047777


(POS Check)

F134/F55 GENERIC EMV APPL DATA Generic EMV Issuer Application 22112233445566778899
Data - Field 134 - Tag 9F10 (Chip/ AABBCCDDEEFFFFEE
GENERIC Format) DDCCBBAA9988776655
4433221100

5–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Default Variable Groups
User’s Guide

Table 5–2: Card Variables and Primary Fields (3 of 3)

Field ID Variable Name Primary Field Value

F134/F55 VISA DISCRE DATA Visa Discretionary Data - Field 134 - 010A03A0B0000000000
Tag 9F10 (Chip) 00

F134/F55 VISA DISCRA DATA CCD Visa Discretionary Data - Field 134 - A400000000000000000
Tag 9F10 (Chip/CCD Format) 00000000000

F55 IDD ID Issuer Discretionary Data Identifier : None


Field F55.7.4

F55 PROCESSING CONTROL PROCESSING CONTROL 010A03A0B00000


DATA DATA:F55.7.3

F135/F55 ISS DISCRE DATA Issuer Discretionary Data - Field 135 N/A
- Tag 9F10 (Chip)

F135/F55 ISS DISCRE DATA CCD Issuer Discretionary Data - Field 135 00000000000000000000
- Tag 9F10 (Chip/CCD Format) 0000000000

F136/F55 ARQC Cryptogram ARQC - Field 136 -Tag 0123456789ABCDEF


9F26 (Chip)

F137/F55 APPL TXN CNTR Application Transaction Counter - 00FF


Field 137 - Tag 9F26 (Chip)

F138/F55 APPL INTRCHG PROF Application Interchange Profile - 0000


Field 138- Tag 82 (Chip)

F152/F55 SECONDARY PIN DATA Secondary PIN Data - Field 152 - 1234
Tag C0 (Chip)

F55.21 FORM FACTOR Factor Indicator - Field 55.21 - Tag 00000001


9F6E (Chip)

F55.22 CUSTOMR EXCUSIVE DATA Customer Exclusive Data - Field 00000000000000000000


55.22 - Tag 9F7C (Chip)

15 Mar 2013 Visa Confidential 5–7


Using Variables Visa Test System – V.I.P.
User’s Guide

Issuer Variables
Issuer variables relate to issuer identification and processing. Table 5–3 lists the primary
fields where the values are used. However, values may be used in other fields.

Table 5–3: Issuer Variables and Primary Fields (1 of 2)

Field ID Variable Name Primary Field Value

F010 BILLING RATE Conversion Rate, Cardholder Billing - 61000000


Field 10

F020 ISSCTRY Issuer Country Code - Field 20 840*

F038 APPROVAL Authorization Identification Response - A1B2C3


Field 38

F039 RESP Response Code - Field 39 00*

F044.02 AVS Address Verification Service return value - Y*


Field 44.2

F051 BILLING CURRENCY Currency Code, Cardholder Billing - Field 840*


51

F054.01.03 ISSCUR Issuer Currency Code for (Multi)Currency 840*


Conversion -Field 54.3

F139.01/F55 ARCP Cryptogram ARPC - Field 139.01 - Tag 91 0123456789ABCDE


(Chip) F

F139.01/F55 ARPC CCD Cryptogram ARPC - Field 139.01 - or 12345678


F140.01 - Tag 91 (Chip)

F139.02/F55 CARD STATUS UPDATE Cryptogram CSU - Field 139.02 or Field 00860000
140.02 - Tag 91 (Chip)

F139-03/F55 ARC Cryptogram ARC-Field 139.03 - Tag 91 00


(Chip)

F140.01/F55 GENERIC EMV AUTH Generic EMV/Issuer Authentication Data - 00010203040506070


DATA Field 140-01 - Tag 91 (Chip/GENERIC 8090A0B0C0D0E0F
Format)

F142.01/F55 ISS SCRIPT AFTER Issuer Script - Tag 72 9F180430303031860


AUTH 604DA9F580103

5–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Default Variable Groups
User’s Guide

Table 5–3: Issuer Variables and Primary Fields (2 of 2)

Field ID Variable Name Primary Field Value

F142.01/F55 ISS SCRIPT BEFORE Issuer Script - Tag 71 9F180430303031860


AUTH 604DA9F580103

F142.03/F55 ISS SCRIPT ID Issuer Script ID - Tag 9F18 9F1804303031

F142.04/F55 ISS SCRIPT COMMAND Issuer Script Command - Tag 86 860604DA9F580103

NOTE: * These fields contain a drop-down menu from which to select a value. The value
indicated is an example.

15 Mar 2013 Visa Confidential 5–9


Using Variables Visa Test System – V.I.P.
User’s Guide

System Variables
System variables are not specifically related only to an issuer, acquirer, or a credit or debit
card. Table 5–4 lists the primary fields where the values are used. However, values may
be used in other fields.

Table 5–4: System Variables and Primary Fields

Field ID Variable Name Primary Field Value

F009 SETTLEMENT RATE Conversion Rate, Settlement Amount - 61000000


Field 9

F015 VICFIELD15 Settlement Date - Field 15 1201

F050 SETTLEMENT Currency Code, Settlement - Field 50 840*


CURRENCY

F062.01 VICFIELD62.1 Authorization Characteristics Indicator - A*


Field 62.1

F062.02 VICFIELD62.2 Transaction Identifier - Field 62.2 123456789012345

F062.03 VICFIELD62.3 Validation Code (Downgrade Reason 1234


Code) - Field 62.3

F063.13 CURRENCY PRECISION Currency Precision - Field 63.13 020202

F118.13 F118SEPARATOR Field Separator - Field 118 (JAPAN) 22

H05 DESTSTN Destination Station ID - Field H05 000000

H06 SRCSTN Source Station ID - Field H06 000000

PCR PCR Used in generating field 62.2 9999

NOTE: * These fields contain a drop-down menu from which to select a value. The value
indicated is an example.

User-Defined Variables
Initially, when you first install VTS-V.I.P., the user-defined group of variables is empty. You
can create these variables, and use them in any message in a test.

5–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Opening a Variables Group
User’s Guide

Opening a Variables Group


In the Variables Manager, you open a message format database and then open an
individual variables group within that database. When you select a variables group, it
opens in the right-hand pane of the window.
You can start the Variables Manager directly from the Programs menu or from within the
application. The Variables Manager includes a toolbar with buttons for quick access to
commonly performed tasks.

To open a variables group:


1. Click the Variables Manager toolbar button, or on the Edit menu, click Variables
Manager.

The main Variables Manager window appears.


2. Click the Open toolbar button, or on the File menu, click Open, and click VIP
Variables.

The database for the message format you select appears. The following example
shows the V.I.P. Variables Database.

Figure 5–2: Variables Database

15 Mar 2013 Visa Confidential 5–11


Using Variables Visa Test System – V.I.P.
User’s Guide

You can resize or relocate the main Variables Manager window by using the mouse to
drag the window corner. The window will open to this same position each time you
open the Variables Manager.
3. Click the plus symbol (+) next to the any of the group folders, for instance Acquirer
Groups, to expand and display the groups in that folder.

Figure 5–3: Variables Database

4. Click a variables group to open it in the right-hand pane of the window.

5–12 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Creating a New Variables Group
User’s Guide

Figure 5–4: Variables Group Display

See the next sections “Creating a New Variables Group” or “Modifying a Variable.”

Creating a New Variables Group


Use the Save As feature to create a new variables group by copying an existing group
and renaming it.

To copy a variables group:


1. Open a variables group.
2. Click the Save As toolbar button, or on the File menu, click Save As.

The Save Group As dialog box appears.

Figure 5–5: Save Group As Dialog Box

15 Mar 2013 Visa Confidential 5–13


Using Variables Visa Test System – V.I.P.
User’s Guide

3. Type a new name for your variables group and click OK. Your new group appears.
See the next section for instructions on editing variables in your new group.

Modifying a Variable
This section describes how to edit the value of an existing variable. However, to edit a
user-defined variable, see the “Modifying a User-Defined Variable” section.
As you edit a variable, VTS-V.I.P. validates its minimum length, maximum length, and
validation type (numeric, alphanumeric, alphanumeric/special, or hexadecimal format).
The property of each variable has been created in advance to be used in specific fields,
which have predetermined data types and lengths. For instance, a variable created for
country code only allows a length of three digits and numeric data.
When editing variables, you cannot navigate to other windows. This is necessary for key-
by-key validation of input.
You can copy and paste data from Microsoft Word or Excel.

To edit a variable:
1. Open a variable group.

Figure 5–6: Variable Group Display

2. Enter detailed information about the variables group in the Group Description box.

5–14 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Modifying a Variable
User’s Guide

Figure 5–7: Variable Group Description Box

NOTE: To change the name of a variables group (Group Name), use the Save As feature
on the File menu. If you no longer need the old group, simply delete it.
3. Double-click the variable in the Value column to edit it.
VTS-V.I.P. displays the variable’s minimum length, maximum length, and validation
type (AN, ANS, N, or HEX) at the bottom of the screen for your reference.
As you enter new data, each character is immediately validated. For example, if the
validation type is HEX, only the characters 0-9 and A-F are accepted. Also, no more
than the maximum length number of characters is accepted and the Enter key is not
recognized unless the minimum number of characters is present. To cancel editing
and restore the original value, press ESC.
When you are finished editing, press Enter or the TAB key.

Figure 5–8: Variables Group Display

4. Click the Save toolbar button, or on the File menu, click Save to keep your changes.

15 Mar 2013 Visa Confidential 5–15


Using Variables Visa Test System – V.I.P.
User’s Guide

5. To close the message format database, click the Close Database toolbar button, or
on the File menu, click Close.

6. To close the Variables Manager, on the File menu, click Exit.

Selecting the Default Variables Group


You can select one variables group in each folder (acquirer, issuer, card, or system) as
the default. VTS-V.I.P. uses this default group during test execution.
This is a powerful feature since you can change which variables are used in many
different tests just by changing the default designations.
EXAMPLE
Suppose you set up a test case to use a default variables group
designated as CA Bank. When the test is run, VTS-V.I.P. will use the
CA Bank variables. You can then go back and change the default
group to NY Bank and the next time the same test is run, VTS-V.I.P.
will use the NY Bank variables.
See the “Designating a Variables Group for the Test Case” section for more information
on specifying the variables group for each test case.

To select a default variables group:


1. Open a variables group.
2. Click the Make Default check box.

Figure 5–9: Variable Group Display

3. VTS-V.I.P. prompts you to save changes. The CA Bank variables group displays
Default next to the group name.

5–16 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Associating Card and Issuer Variables Groups
User’s Guide

Figure 5–10: Variables Database

NOTE: The variables group set as the default cannot be deleted. You must first select a
different group as the default in order to delete a variables group.

Associating Card and Issuer Variables Groups


Since a Visa card is always associated with a specific issuer in transaction processing,
the Variables Manager does the same. Card variables are associated with an issuer
variables group.
This section describes how to associate the card and issuer variables groups.

To associate an issuer group with a card group:


1. Open a card variables group.
2. In the Issuer Name drop-down list, select an issuer group.

15 Mar 2013 Visa Confidential 5–17


Using Variables Visa Test System – V.I.P.
User’s Guide

Figure 5–11: Variable Group Display

The issuer variables group is now associated with the specified card group.

Deleting a Variables Group


You can delete an entire group of variables; however, the variables group designated as
the default group cannot be deleted.

To delete a variables group:


1. Open a variables group.
2. Click the Delete toolbar button, or on the File menu, click Delete.

A confirmation dialog box appears.

3. Click Yes to delete the variables group or No to cancel.

5–18 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Printing a Variables Group
User’s Guide

Printing a Variables Group


You can print a copy of any variables group.

To print a variables group:


1. Open a variables group.
2. Click the Print toolbar button, or on the File menu, click Print. The Print Setup dialog
box appears.

3. Specify a printer or select Print to file.


You can also click Print Preview on the File menu to see the variables group as it will look
when printed.

Saving a Variables Group as a Word Document


You can save a variables group as a Microsoft Word document.

To save a variables group as a Word document:


1. Open a variables group.
2. On the File menu, click Export to Word Document. The Save As dialog box appears.
3. Type a file name.

Creating a User-Defined Variable


You can create new variables in the user-defined group.
Unlike other variables, you determine the name and description of user-defined variables.

To create a new variable:


1. Click to open the User Group folder. Initially, this group is empty until you create
variables.

15 Mar 2013 Visa Confidential 5–19


Using Variables Visa Test System – V.I.P.
User’s Guide

Figure 5–12: Variables Manager

2. Click the Add Variable toolbar button, or on the User menu, click Add Variable.

The Add User Variable dialog box appears.

Figure 5–13: Add User Variable Dialog Box

3. Enter the following information for the new variable:


a. Field ID—Type the field where this variable is used.
b. Name—Type the variable name.

5–20 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Modifying a User-Defined Variable
User’s Guide

c. Description—Type a description of the variable.


d. Value—Type the value.
e. Minimum Length—Type a minimum value.
f. Maximum Length—Type a maximum value.
g. Validation Type—Select whether the variable is alphanumeric (AN);
alphanumeric/special characters such as commas, slashes, and dashes (ANS);
numeric (N); or hexadecimal (HEX) format.
4. Click OK. The new variable appears in the table.
VTS-V.I.P. automatically saves any user-defined variables that you create.

Modifying a User-Defined Variable


Once you create a new user-defined variable, you can edit its value just as you would edit
any variable.

To edit a user-defined variable:


1. Click to open the User Group folder. The user-defined variables appear in the right-
hand pane of the window.

Figure 5–14: User Defined Variables

2. Select the variable you want to edit.

15 Mar 2013 Visa Confidential 5–21


Using Variables Visa Test System – V.I.P.
User’s Guide

3. Click the Edit Variable Properties toolbar button, or on the User menu, click Edit
Variable Properties.

The Edit User Variable dialog box appears.

Figure 5–15: Edit User Variable Properties Dialog Box

4. Type updated information in the following boxes:


a. Field ID—Type the field where this variable is used.
b. Name—Type the variable name.
c. Description—Type a description of the variable.
d. Value—Type the value.
e. Minimum Length—Type a minimum value.
f. Maximum Length—Type a maximum value.
g. Validation Type—Select whether the variable is alphanumeric (AN);
alphanumeric/special characters such as commas, slashes, and dashes (ANS);
numeric (N); or hexadecimal (HEX) format.
5. Click OK.
VTS-V.I.P. automatically saves changes you make to any user-defined variables.

NOTE: You can also double-click the Value column to edit the variable. When you are
finished editing, press Enter or the Tab key.

5–22 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using a User-Defined Variable in a Test Case
User’s Guide

Using a User-Defined Variable in a Test Case


This section describes how you can use a user-defined variable in a test case. You should
have already created a user-defined variable.

To use a user-defined variable in a test case:


1. In the main VTS-V.I.P. window, open a test.
NOTE: If you open a test and then make changes to variables, these changes will not
appear in the test case until you close and reopen the test.
2. Select a message and double-click the message, or on the Edit menu, click Message
Editor. The Message Editor window appears.
3. Select a field in the message and click Field Editor or double-click any field in the
Name column.

4. The Field Editor window appears. Under Population Method, click Variable.
5. Under Population Source, in the Variable Name box, select Variable from the drop-
down list.
The validation type and length of the variable must match the format and length
defined for the field or subfield in order to be displayed in the Population Source.
6. Click OK to save your changes and return to the Message Editor.
7. Click OK to close the Message Editor and return to the main VTS-V.I.P. window.

Deleting a User-Defined Variable


You can delete variables only in the user-defined group.

To delete a variable:
1. Open the user-defined variables group.
2. Double-click a cell in the Value column to select the variable you want to delete.
3. Click the Delete toolbar button, or on the File menu, click Delete.

15 Mar 2013 Visa Confidential 5–23


Using Variables Visa Test System – V.I.P.
User’s Guide

A confirmation dialog box appears.

4. Click Yes to delete the variables group or No to cancel.


NOTE: You can delete more than one variable at a time by pressing the CTRL key while
selecting multiple variables in the Value column.

Designating a Variables Group for the Test Case


When VTS-V.I.P. executes a test, it uses the designated variables group. You can
designate a variables group for the entire test, including all test cases within that test, and
also for individual test cases.
If you designate a variables group at the test level (in the Test Properties dialog box),
VTS-V.I.P. also updates all case properties. However, after this test-level update, you can
designate a variables group for individual cases (in the Case Properties dialog box).
If a test is made up of several cases, there may be several different variables groups used
during the test.
This section describes how to designate a variables group for a test case. Designating a
variables group for an entire test is done in a similar manner, but by clicking Properties
under the test, not the case. For a screen shot of the Test Properties dialog box, see
Chapter 4, Creating a Test.
NOTE: You can designate user-defined variables on a field-by-field basis in the Field
Editor.
VTS-V.I.P. uses the issuer variables group that is associated with the card variables group.
For instructions how to associate these groups, see the “Associating Card and Issuer
Variables Groups” section.
If you have created several card groups and associated them with different issuer banks,
you can also specify that VTS-V.I.P. only use the cards associated with a certain issuer.
EXAMPLE
Suppose you are testing with CA Bank and several different cards
have been set up and linked to CA Bank while other cards have been
linked to other banks. By selecting CA Bank from the issuers drop-
down list, only cards that are linked to CA Bank are available in the

5–24 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Designating a Variables Group for the Test Case
User’s Guide

card selection list. Even if you select sequential or random, VTS-V.I.P.


will only use cards associated with the CA Bank each time it
constructs a message.
You can also choose to have VTS-V.I.P. apply variables groups sequentially or randomly.
If you specify sequentially, when you run the test, VTS-V.I.P. selects the first variable
group listed. Then it automatically uses the next variables group in sequence and applies
these variables to the fields in the message. In order to see the effect of selecting
sequential, during test execution you should:
● Have more than one variables group.
● Have more than one outgoing message within a case that uses variables.
● Set the test execution run control to repeat the test more than once or to run
continuously.
If you choose to have VTS-V.I.P. apply variables randomly, it applies variables groups
randomly instead of in sequence. In order to see the effect of selecting random during test
execution you should have more than one variables group.
For details about setting match probability, see “Using Match Probability” in Chapter 7,
Running a Test.

To designate a variables group for a test case:


1. Open a test in the main VTS-V.I.P. window.
2. Click Properties under the case name. The Case Properties dialog box appears on
the right-hand side of the screen.

15 Mar 2013 Visa Confidential 5–25


Using Variables Visa Test System – V.I.P.
User’s Guide

Figure 5–16: Case Properties Dialog Box

3. Under Variable Groups to Use, click a drop-down list to change the associated
variables group, or click Default to use the variables group set as the default.
Click Random or Sequential to specify that VTS-V.I.P. either applies a random
variables group or the next group in sequence.
a. Under Card, when you select a card group, VTS-V.I.P. uses the associated issuer
group.
See the “Processing Cards Offline” section in Chapter 9 for information about
using a chip card reader.
b. Under Issuer, by default, All is selected.
If you click the button next to the Issuer drop-down list and select an issuer, under
Card only cards linked to that issuer will be available in the card drop-down list.
4. Click OK.
NOTE: If you add a new variables group (using Variables Manager), use the Refresh
button (shown) to view the newly added group in the Acquirer, Card, Issuer, or
System drop-down lists.

5–26 Visa Confidential 15 Mar 2013


Modifying a Test 6

Introduction to Test Modification . . . . . . . . . . . . . 6–1

Editing a Message . . . . . . . . . . . . . . . . . . . . 6–5

Editing a Field . . . . . . . . . . . . . . . . . . . . . . . 6–8

Printing Message Content . . . . . . . . . . . . . . . .6–10

Deleting a Case or Message . . . . . . . . . . . . . . .6–10

Adding a Field. . . . . . . . . . . . . . . . . . . . . . .6–11

Using the Bitmap Editor . . . . . . . . . . . . . . . . . .6–12

Viewing a Message in Hex . . . . . . . . . . . . . . . .6–14

Using the TLV Editor . . . . . . . . . . . . . . . . . . .6–15

Introduction to Test Modification


This section describes how to use the Message Editor and Field Editor in VTS-V.I.P. You
can view and change the contents of a message using the Message Editor, and also print
the contents of a message. The Field Editor provides greater control and additional
editing functions. If a field has subfields, you can edit these in the Message or Field
Editor.

15 Mar 2013 Visa Confidential 6–1


Modifying a Test Visa Test System – V.I.P.
User’s Guide

The main use of the Message and Field Editors is to logically construct a value for a
current field. A field is defined with a value or a reference that points to or generates a
value. You can change the value of a field, remove it from a message, specify where VTS-
V.I.P. can find its value, or construct a subfield value for some fields.

NOTE: You can right-click a message to quickly edit it in the Message Editor, view it in
hexadecimal format, copy, rename, or delete it.
In editable fields in the Message or Field Editor, you can right-click to copy, paste,
or delete content.

Population Methods
Fields and subfields include references that describe the source of the data, such as
literal data or whether a field is system-generated. The population methods determine
how VTS-V.I.P. generates a value for the field. Depending on the population method
selected, the value can be entered by you, copied from another message, or generated
by VTS-V.I.P.
The population methods include:
● Literal
● Field in Earlier Message
● Field in Previous Message
● Field in Current Message
● Variable
● Valid Value
● System Generated
● Subfield Level

Literal
Selecting this option tells VTS-V.I.P. that you are providing data in alphanumeric, decimal,
or hexadecimal format. You can type the value for that field or subfield manually.
Specify hexadecimal format by selecting the Hex check box. Checking this option allows
you to put in literal hexadecimal data for a field. Hexadecimal format bypasses all edit
rules and can be used to send data that is normally not allowed. Hexadecimal characters
are 1–9 and A–F.

Field in Earlier, Previous, or Current Message


Selecting one of these options allows you to copy data from an earlier, previous, or
current message into the current message at the time of the test run.

6–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Introduction to Test Modification
User’s Guide

You can copy only from an earlier or previous message within the same test case.
Previous refers to the message immediately before the current message. If VTS-V.I.P.
cannot find the field to be copied from an earlier message, it generates a valid value to
meet the field validation.

Variable
Selecting this function lets you provide a name and a pointer to variables. VTS-V.I.P. only
permits use of the variable if the validation type and length of the variable matches the
format and length defined for the field or subfield.

Valid Value
For an incoming message, Valid Value means that VTS-V.I.P. allows any valid value and
checks the content for validity.
Valid values are values that meet the edit criteria, but do not necessarily represent
specific codes or values used by V.I.P. For example, a valid value for field 32 is a random
numeric value that does not represent a real Acquirer Institution Identification Code. If a
random value is not sufficient for your testing, you must substitute a valid literal value in
the field.

System Generated
For an outgoing message, System Generated means that VTS-V.I.P. generates a value for
you. However, you cannot populate some fields with system-generated values.
<BlueUL>Table 6–1 lists the fields for which System Generated is allowed for outgoing
messages.
NOTE: The accuracy of the data values can be guaranteed only for those fields listed in
<BlueUL>Table 6–1.

Table 6–1: System-Generated Fields for Outgoing Messages

Field ID Name

H1 Header Length

H2 Header Flag and Format

H4 Total Message Length Header Bit Map

H12 Reject Data Group

7 Transmission Date and Time

15 Mar 2013 Visa Confidential 6–3


Modifying a Test Visa Test System – V.I.P.
User’s Guide

Table 6–1: System-Generated Fields for Outgoing Messages

Field ID Name

11 Systems Trace Audit Number

12 Time, Local Transaction

13 Date, Local Transaction

15 Date, Settlement

16 Date, Conversion

37 Retrieval Reference Number

48.3 Departure Date

48.3 Local Date

48.3 Capture Date

48.5 Expiration Date

64 Message Authentication Code (MAC)

73 Date, Action

92 File Security Code

127.3 Purge Date

146 (Chip) Terminal Transaction Date

Subfield Level
Selecting this population method allows you to edit subfields. Only fields that contain
subfields have this option available.

Field Properties
Field properties describe the attributes of the data. For instance, properties might include
exact matching on a field or only matching whether the field is present. You can view or
edit the field properties in either the Message Editor or the Field Editor.

6–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Introduction to Test Modification
User’s Guide

The field properties include:


● Match field.
● Validate field.
● Omit field.

Match Field
Selecting this property designates a field as a match criteria field.
Once you select matching, you can further specify whether to match a field’s Exact Value,
Field Presence, or Field Absence in the Field Editor. When matches occur, VTS-V.I.P.
evaluates all the values in the record for acceptable field edits and expected results of the
test.
Exact Value means this field is a match field, and the data from the incoming field should
exactly match the expected data.
EXAMPLE
In field 2 you expect a particular account number so you set field 2 for
Exact Value matching. Field 2 of the incoming message must contain
the expected account number for VTS-V.I.P. to accept a match on the
incoming message.
Field Presence and Field Absence simply mean that the selected field must be present or
absent in the incoming message in order for VTS-V.I.P. to accept the incoming message
as a match.
If a matching field does not match during a run, you are notified. You can terminate the
test run or continue even though there is a “No Match.”
Matching on a Valid Value field means that the field must be present in the message, no
matter what the value is. Matching on an omitted field indicates the field must be absent in
the incoming message.
NOTE: If no Match Fields are defined in the message, the message always matches
each incoming message. No mismatch occurs.

Validate Field
If selected, VTS-V.I.P. checks the content of this field for validity.
You can use Validate to perform exception testing by entering invalid data for the field.

Omit Field
Checking this option tells VTS-V.I.P. to omit a field from a test message.

15 Mar 2013 Visa Confidential 6–5


Modifying a Test Visa Test System – V.I.P.
User’s Guide

Editing a Message
Use the Message Editor to edit a field or subfield. The Message Editor displays your
changes in bold.

To view or edit a message:


1. Select a message in the main VTS-V.I.P. window.
2. Double-click the message, or on the Edit menu, click Message Editor. The Message
Editor window appears.

Figure 6–1: Message Editor

3. You can change the name of the message by typing a new name in the Msg box, if
desired. You can enter up to 255 alphanumeric characters.
4. In the Case box, the Message Editor shows the name of the Case.
To change the name of a case, double-click or right-click the case name, or click
Properties under the case name in the main VTS-V.I.P. window.
In the upper right-hand corner the Message Editor shows the direction and Message
Type Indicator (MTI) of the selected message.

6–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Editing a Message
User’s Guide

The Field No., Name, and MOC columns are unavailable for editing. The MOC field
shows the necessity of the field and is either Mandatory, Optional or Conditional. See
V.I.P. System BASE I Technical Specifications and the V.I.P. System SMS technical
specifications manuals for more information.
5. Double-click the Match column to select whether the field is set to Yes or No.
6. Double-click the Validate column to select whether the field is set to Yes or No.
7. Double-click the Omit column to select whether the field is set to Yes or No. If set to
Yes, VTS-V.I.P. omits this field from the test message.
8. If the Value column contains data, you can edit it directly or modify it in the Field
Editor. See the “Editing a Field” section for instructions on how to set the Population
Method to Literal.
9. To add a particular usage or change an existing usage for a particular field, right click
on the selected field and select "Add Usage" option from the menu. Select the
required usage from the "Choose Usage" dialog. If the field doesn't have any usage,
the "Add Usage" menu is disabled.
10. Under Display Options, click one of the following in the Show list:
All Fields—Displays all fields.
Business Case Defined—Displays only fields defined in the business function of the
Knowledgebase.
Fields Set for Matching—Displays only fields that contain a Yes in the Match
column.
Fields With Values—Displays only fields containing data (fields that contain a No in
the Omit column).
11. Click Show Headers And Bitmaps to display header fields and bitmaps at the
beginning of the field list.
You can use the following buttons in the Message Editor:
Click OK to save your changes in message content and return to the main VTS-V.I.P.
window.
Click Cancel to return to the main VTS-V.I.P. window without saving any changes.
Click Previous or Next to page forward or backward through the messages in all
cases.

Click Field Editor to edit the field in more detail. See the “Editing a Field” section for
more information.

15 Mar 2013 Visa Confidential 6–7


Modifying a Test Visa Test System – V.I.P.
User’s Guide

Click Add Field to add a field from another message. See the “Adding a Field” section
for more information.

Click Print to print the contents of the message. See the “Printing Message Content”
section for more information.

Editing a Field
Use the Field Editor to access all possible options for a field and to quickly pull information
from other messages. The Field Editor shows some of the information from the Message
Editor and the Match, Validate, and Omit fields can be edited in either the Message Editor
or Field Editor.
The Field Editor displays your changes in bold.

To view or edit a field:


1. Open a message in the Message Editor.
2. Select a field in the message.
3. Click Field Editor or double-click any field in the Name column.

4. The Field Editor window appears.

6–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Editing a Field
User’s Guide

Figure 6–2: Field Editor

The Field Editor shows the field ID, name, type, format, minimum length, and
maximum length of the selected message.
5. If the Population Method is set to Literal, you can enter the Value. The Position box
shows the position of your cursor in the Value box.
6. Under Population Method, click one of the following:
Literal—The data you are providing is in alphanumeric, alphanumeric/special
characters (commas, slashes, and dashes), numeric, or hexadecimal format.
Earlier Msg in this Case—VTS-V.I.P. populates the field with a field from an earlier
message in the same test case. Under Population Source, you can specify which field
in the Msg Name list.
Field in Previous Msg—VTS-V.I.P. populates the field from the previous message in
the same test case.
Field in Current Msg—VTS-V.I.P. populates the field with a field in the current
message. Under Population Source, you can specify which field in the Msg Name list.
Variable—VTS-V.I.P. uses a specified variable.
Valid Value—For incoming messages, VTS-V.I.P. checks the content for validity.
System Generated—For outgoing messages, VTS-V.I.P. generates a value.
Subfield Level—Choose if the field is a subfield.

15 Mar 2013 Visa Confidential 6–9


Modifying a Test Visa Test System – V.I.P.
User’s Guide

7. If you copy from a field in an earlier, previous, or current message, click If Present to
populate this message field only if that field is present in that message.

Figure 6–3: Population Method Fields

8. Under Properties:
a. Click Match to specify the field for matching when you are running test cases.
If you click Match, select Exact Value, Field Presence or Field Absence from
the drop-down list.
b. Click Validate to have VTS-V.I.P. validate this field.
c. Click Omit to remove this field from the test message.
9. Under Population Source:
a. If the Population Method is set to Variable, this box is named Variable Name.
Select a variable from the drop-down list.
b. If the Population Method is set to copy from a field in an earlier, previous, or
current message, this box is named Msg Name. Select a message from the drop-
down list.
c. If the Population Method is set to copy from a field in an earlier, previous, or
current message, also select Field ID.
Click OK to save your changes and return to the Message Editor.
Click Cancel to return to the Message Editor without saving any changes.
Click Default to restore the default values. VTS-V.I.P. sets the values as defined in the
Knowledgebase.

Printing Message Content


You can print the contents of any message from the Message Editor. VTS-V.I.P. will print
all the information shown in the Message Editor for that message. You can also choose to
print to a file.

To print message data:


1. Open a message in the Message Editor.

6–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Deleting a Case or Message
User’s Guide

2. Click Print.

The Print Setup dialog box appears.


3. Specify a printer or select Print to file.

Deleting a Case or Message


You can delete a test case or message.

To delete a case or message:


1. Select the case or message you want to delete.
2. Click the Delete toolbar button, or on the Edit menu, click Delete.

A confirmation message appears.


3. Click Yes to delete the selected item.

Adding a Field
You can add or remove a field using this feature.

To add a field to a message:


1. Select a message in the main VTS-V.I.P. window.
2. Double-click the message, or on the Edit menu, click Message Editor. The Message
Editor window appears.
3. Click Add Field.

The Add Field dialog box appears.

15 Mar 2013 Visa Confidential 6–11


Modifying a Test Visa Test System – V.I.P.
User’s Guide

Figure 6–4: Add Field Dialog Box

4. Select an available field on the left-hand side and click Add.


NOTE: When you add certain fields, a dialog box appears so you can specify the
usage.
5. Click OK. The Message Editor appears to display the new field in the correct position.
NOTE: If you later want to remove this field from the message, you can right-click it and
click Delete, set the field property to Omit, or select the added field and use the
Remove button.

Using the Bitmap Editor


The Bitmap Editor is available for fields 130, 131, 134.3, or 138 in V.I.P. messages. You
can select which services apply to a field, create a bitmap, and convert it to hexadecimal
digits. The Population Method for the field must be set to Literal in the Field Editor to
enable the Bitmap Editor.
The Bitmap Editor contains a table with each of the bits that make up the field along with a
description of the meaning of the bit in the context of chip card processing. You select
whether to turn the bit on or off. From the pattern of on and off bits, VTS-V.I.P. generates
the corresponding hex pattern and inserts it into the field.
You can bypass the Bitmap Editor by entering hexadecimal string values for bitmapped
fields directly in the Literal box of the Field Editor or Message Editor. Once entered, the
hexadecimal value is validated by VTS-V.I.P.
For more information on bitmap values, see the V.I.P. System SMS POS (Visa & Visa
Electron) Technical Specifications and Visa Smart Debit/Visa Smart Credit System
Technical Manual.

6–12 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using the Bitmap Editor
User’s Guide

To use the Bitmap Editor:


1. Open a message in the Message Editor.
2. Open a bitmapped field (130, 131, 134.3 or 138) in the Field Editor.
NOTE: You may have to change the 3rd Bitmap Fields test configuration setting to Yes
so the chip card fields are present in the message. See “About Test
Configuration” in Chapter 4, Creating a Test, for more information.

Figure 6–5: Field Editor

3. Under Population Method, click Literal.


4. Click Bitmap Editor.

The Bitmap Editor window appears.

15 Mar 2013 Visa Confidential 6–13


Modifying a Test Visa Test System – V.I.P.
User’s Guide

Figure 6–6: Bitmap Editor

The Bitmap Editor shows the bit number and description of the selected field.
5. Double-click the On/Off column to set the field to On or Off.
6. Click OK to save your selections. VTS-V.I.P. converts your selections into a
hexadecimal string and places it in the Value box of the Field Editor and Message
Editor.
Click Cancel to return to the Field Editor without saving any changes. The
hexadecimal string value for the field remains unchanged.

Viewing a Message in Hex


You can view your message in hexadecimal format and search for a specific byte number.

To view a message in hex format:


1. Click to select a message.
2. On the View menu, click View Hex. The Hex Viewer appears.

6–14 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using the TLV Editor
User’s Guide

Figure 6–7: Hex Viewer

3. Enter a byte number. VTS-V.I.P. highlights the selected byte.

Figure 6–8: Hex Viewer

4. Click Close.

Using the TLV Editor


Use the TLV Editor to edit Tag-Length-Value (TLV) fields. An example of a TLV field is
Field 123 which contains Address Verification Service (AVS) data. For more information
on TLV fields, see V.I.P. System SMS POS (Visa & Visa Electron) Technical
Specifications.

15 Mar 2013 Visa Confidential 6–15


Modifying a Test Visa Test System – V.I.P.
User’s Guide

You may have to change the test configuration setting so the appropriate fields are
present in the message. See “About Test Configuration” in
Chapter 4, Creating a Test, for more information.

To use the TLV Editor:


1. Open a message in the Message Editor.
2. Double-click Field No, Name, MOC, or Value to open the Field Editor.
3. Under Population Method, click Subfield Level and click OK. The Message Editor
displays the subfields.
4. Select the subfield and double-click to open the Field Editor. The Population Method
for the subfield must be set to Literal.
5. Click TLV Editor.

The TLV Editor window appears.

Figure 6–9: TLV Editor

6. In the Tag box, type a value or select one from the drop-down list.
7. In the Value box, type any value. You can choose between Hex and Text modes for
some fields, such as F123.3.
8. Click OK to save your selections. The TLV Editor automatically calculates the length
and formats the data into the appropriate TLV format. The result is displayed in the
Value field of the Field Editor.
Click Cancel to return to the Field Editor without saving any changes.

6–16 Visa Confidential 15 Mar 2013


Running a Test 7

Introduction to Running a Test . . . . . . . . . . . . . . 7–1

Understanding Message Processing . . . . . . . . . . . 7–1

Setting Test Execution Preferences. . . . . . . . . . . . 7–3

Executing a Test . . . . . . . . . . . . . . . . . . . . . 7–4

Using Match Probability . . . . . . . . . . . . . . . . . . 7–7

About Keys . . . . . . . . . . . . . . . . . . . . . . . . 7–8

Using Keys in VTS-V.I.P. . . . . . . . . . . . . . . . . .7–10

Introduction to Running a Test


This section describes how VTS-V.I.P. handles message processing while it runs a test,
how you can set run control options globally or for an individual test, and how to execute
a test. It also describes match probability and keys.

Understanding Message Processing


VTS-V.I.P. processes messages during test execution as follows:

If you select only one case, VTS-V.I.P. processes messages in the order they appear
in the case.
● If you select more than one case or message within a case:
– Starting with the first case, VTS-V.I.P. still processes messages in the order they
appear in the case.

15 Mar 2013 Visa Confidential 7–1


Running a Test Visa Test System – V.I.P.
User’s Guide

– When VTS-V.I.P. reaches an incoming message, it defers processing to the next


case.
– When VTS-V.I.P. has executed all cases to a point where they are waiting for an
incoming message, it checks the “receive” queue for an incoming message and
compares it to each case's expected incoming message until it finds a match. If
the incoming message does not match any of the current expected incoming
messages, it marks the message as unmatched, logs it, and asks you whether to
keep running the test.
Therefore, all possible outgoing messages are sent before VTS-V.I.P. checks the
incoming message queue.
The following example shows a sample test and the order in which VTS-V.I.P. would
process the messages.

Test 1

Case 1 Case 2 Case 3

Outgoing 0100 Request Msg 1 Outgoing 0100 Request Msg 1 Outgoing 0200 Request Msg 1
Incoming 0110 Response Msg 2 Incoming 0110 Response Msg 2 Outgoing 0200 Request Msg 2
Outgoing 0400 Request Msg 3
Incoming 0410 Response Msg 4

If no cases or messages were selected, VTS-V.I.P. would process all the messages in Test
1 in the following order:

Message Processed VTS-V.I.P. Action

1. Case 1 Outgoing msg 1 An incoming msg is next so VTS-V.I.P. defers to Case 2.

2. Case 2 Outgoing msg 1 An incoming msg is next so VTS-V.I.P. defers to Case 3.

3. Case 3 Outgoing msg 1 N/A

4. Case 3 Outgoing msg 2 Case 3 is complete so VTS-V.I.P. defers back to Case


1.

5. Case 1 Incoming msg 2 Case 1 is complete so VTS-V.I.P. defers to Case 2.

6. Case 2 Incoming msg 2 N/A

7. Case 2 Outgoing msg 3 N/A

7–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Setting Test Execution Preferences
User’s Guide

Message Processed VTS-V.I.P. Action

8. Case 2 Incoming msg 4 N/A

Setting Test Execution Preferences


With Preferences, you can globally set how VTS-V.I.P. will execute all tests. You can
control how VTS-V.I.P. runs individual tests in the Test Execution dialog box described in
the next section.

To change the test execution preferences:


1. On the View menu, click Preferences. The Preferences dialog box appears. Click the
Test Execution tab.

Figure 7–1: Test Execution Preferences

15 Mar 2013 Visa Confidential 7–3


Running a Test Visa Test System – V.I.P.
User’s Guide

2. Under Log ISO Messages, click Yes to log messages sent or received during test
execution in the main log file.
3. Under Run Control, click one of the following:
– 0 - Continuous Loop—VTS-V.I.P. will run all tests continuously.
– 1 - Repeat—VTS-V.I.P. will repeat all tests the number of times you specify. Also
type how many times you want to repeat the test in the Repeat text box.
– 2 - Run for Time—VTS-V.I.P. will run all tests for the amount of time you specify.
Also type values in the hour and minute boxes.
4. Under Stop On Error, click Yes to specify that VTS-V.I.P. stop running all tests when it
detects an error.
VTS-V.I.P. categorizes messages into Informational, Warning, and Fatal depending on
the severity of the error. If you select Stop On Error, during test execution VTS-V.I.P.
ignores Information and Warning messages and only stops on Fatal messages.
5. In the Wait For Start Line box, type an amount of time in milliseconds that VTS-V.I.P.
should try to start the communications line. If VTS-V.I.P. cannot start the line in this
time limit, it notifies you.
6. In the Wait For Stop Line box, type an amount of time in milliseconds that VTS-V.I.P.
should try to stop the communications line. If it cannot stop the line in this time limit, it
notifies you and brings the line to a forced stop.
7. In the Transaction Number box, type a value for VTS-V.I.P. to use for Field 11—
System Trace Audit Number and Field 37—Retrieval Reference Number. This
number is used to match messages in a transaction set. VTS-V.I.P. also increments
this number each time it sends an outgoing message.
8. Click OK.

Executing a Test
When you execute a test in VTS-V.I.P., it automatically starts the Communications
Handler, if it is not already running, and processes your test message. See Chapter 3 for
more information on the Communications Handler.
Before executing a test, you can choose any combination of cases or messages or both
to execute by pressing the SHIFT key or CTRL key while selecting cases and messages.
Use CTRL+A to select all messages.
When VTS-V.I.P. determines that an incoming message is unmatched, it asks whether you
want to continue running the test.
As VTS-V.I.P. runs your test, it opens a dialog box so you can see statistics during your
test run. You can also specify run control options and run the test again.

7–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Executing a Test
User’s Guide

To execute a test:
1. Open a test and select a test case or cases.
2. Click the Execute Test toolbar button, or on the File menu, click Execute Test.

3. The Communications Handler starts, if it is not already running. Once the line is up,
the Test Execution dialog box appears.

Figure 7–2: Test Execution Dialog Box

The Test Execution dialog box shows the following statistics while the test runs:

Selected Cases—Shows the number of cases you have selected.
● Selected Msgs—Shows the number of messages you have selected.

Sent Total —Shows how many messages VTS-V.I.P. has sent.

Received Total—Shows how many messages VTS-V.I.P. has received.
● Received Unmatched—Shows how many unmatched messages VTS-V.I.P. has
received.
● Received Rejects—Shows how many rejected messages VTS-V.I.P. has received.

15 Mar 2013 Visa Confidential 7–5


Running a Test Visa Test System – V.I.P.
User’s Guide

● Elapsed Loops—Indicates the number of times VTS-V.I.P. has run the test.
● Elapsed Time—Indicates how long the test has been running.
● Current Message—Shows the name of the incoming or outgoing message that VTS-
V.I.P. is processing.
● In Progress/Stopped—Displays a flashing “In Progress” while the test is executing
and shows the percentage of the test that has been completed. When the test has
stopped, displays “Stopped” and shows the percentage of the test completed before
VTS-V.I.P. stopped.
You can use the following buttons in the Test Execution dialog box:
Click Stop to terminate the current run.

Click Pause to temporarily stop test execution to correct message errors as they
occur.

Click Resume to begin running the test at that point.

Once the test has run, click Return to return to the main VTS-V.I.P. window.

Or click Restart to repeat the test.

You can also specify run control options and run the test again.
4. Click to select the duration of the test run as Continuous Loop, Repeat, or Run For
a specified amount of time.
5. Select the number of times to repeat the test or the amount of time to run it, and type
a value or click the arrows to select a value.
6. Click Log ISO to log messages in the main log.
7. Click Stop On Error to stop running the test when VTS-V.I.P. detects a Fatal error
message. It does not stop if it detects Informational or Warning error messages.
8. Click Continue On Mismatch to keep running the test when the incoming message
doesn’t match the expected result.

7–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using Match Probability
User’s Guide

Using Match Probability


When you run a test with repeated cases, you can tell VTS-V.I.P. which fields in the
incoming message to use as a match. You can also define the order of matching by
setting the case probability. The following example shows a random mix of responses.
EXAMPLE
Suppose you wanted to create a test that returned an approval for a
given account number 85% of the time and a decline the other 15%.
Here are two cases and their settings that will do that:

Case 1 Case 2

Account Number XXX Account Number XXX

Match Probability = 85% Match Probability = 100%

Field 39 = 00 Field 39 = 05

Once VTS-V.I.P. finds a match, it then applies the probability. It allows


up to 85% of all the matches to return an approval response (Field 39
= 00). The other 15% are not allowed to match. They are then
compared to Case 2, which matches (probability = 100%), and returns
a decline (Field 39 = 05).
NOTE: If you run 100 transactions, you may receive 87 approvals instead of 85. VTS-
V.I.P. randomly generates a check for the 85%. This means each message has a
85% chance to be approved after it matches. The percentage returned is
approximate.
You can set match probability for the entire test, including all test cases within that test,
and also for individual test cases. If you apply match probability at the test level (in the
Test Properties dialog box), VTS-V.I.P. also updates all case properties. However, after
this test-level update, you can modify match probability for individual cases (in the Case
Properties dialog box).

To set match probability:


1. Open a test in the main VTS-V.I.P. window and click the test case to open it.
2. Click Properties under the test name or case name. The Test Properties or Case
Properties dialog box appears on the right-hand side of the screen.

15 Mar 2013 Visa Confidential 7–7


Running a Test Visa Test System – V.I.P.
User’s Guide

Figure 7–3: Case Properties

3. In the Match Probability box, type a value (0–100%).


4. Click OK.
See the “Designating a Variables Group for the Test Case” section in
Chapter 5, Using Variables, for more information about the Case Properties dialog box.

About Keys
The data contained in certain fields in a financial transaction message must be protected
against unauthorized access. An example of such data is the personal identification
number (PIN) of the cardholder. To provide security, such fields are encrypted using the
Data Encryption Standard (DES) algorithm. To encrypt data using DES, an encryption key
is required. The key is either an 8-byte (single DES) or a 16-byte (triple DES) binary value
that is normally expressed as 16 or 32 hexadecimal digits, respectively. The DES
algorithm accepts the clear (unencrypted) data item along with the key as input and
produces an encrypted data item and key as output. The DES algorithm will also accept
an encrypted data item and key as input and produce the clear data item as output. Thus,
provided that both the sender and receiver have the same key, sensitive data can
successfully be transmitted in a financial transaction.
In VTS-V.I.P., several different keys are maintained and used for encryption and
decryption. The so-called working keys, WK_1 or WK_2, are used to secure the
cardholder’s PIN. Through the Dynamic Key Exchange (DKE) Service, it is possible for a
new working key to be sent to an acquirer or issuer in an online message. Because this
new working key must itself be secure, it is encrypted using a key known as the Zone
Control Master Key (ZCMK). A Visa chip card message also contains encrypted fields

7–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. About Keys
User’s Guide

known as cryptograms. These cryptograms are generated in VTS-V.I.P. using the


VSDC_MDK key. Finally, in certain messages VTS-V.I.P. also generates a Message
Authentication Code (MAC) using the MAC_1 or MAC_2 key.
See the PIN Security Requirements and the Card Technology Standards for more
information about encryption in Visa messages.
See Appendix C, “Security and Keys,” in the VCMS Testing and Certification Guide—
V.I.P. System Member Version for more information on keys.

Dynamic Key Exchange


The Dynamic Key Exchange (DKE) Service enables SMS members to change Data
Encryption Standard (DES) cryptographic keys with Visa through the use of online
messages. The Dynamic Key Exchange process can be used to transmit WK_1, WK_2,
MAC_1, or MAC_2 keys. The key used to encrypt the new key contained in the DKE
message is the ZCMK.
There are two types of Dynamic Key Exchange transactions. Both types are made up of a
0800 request message and an 0810 response message:
● Key Request Transaction
● Key Delivery Transaction
The Key Request Transaction originates with a member (either acquirer or issuer) and is
processed by the VIC. It asks the VIC to initiate the key exchange process. The 0810
response sent by the VIC to the member only acknowledges receipt of the request. It
does not contain a new key. For some members, the key exchange process originates at
the VIC on a time-scheduled basis and a Key Request Transaction is never used.
A new key is generated by the VIC, or by VTS-V.I.P. playing the role of the VIC, and sent
to the member. The 0800 Key Delivery Message contains the new key. The 0810 Key
Delivery Response returned by the member acknowledges receipt of the new key. To
insure that financial messages with PIN blocks can be completed during a key exchange
session, the alternate working key (the WK not in use) is changed while the active key is
used for PIN block encryption.
The new key must be encrypted before it can be inserted into the 0800 Key Delivery
Message. A separate key, the ZCMK, is used for this purpose. Additionally, a four-digit
check value is generated by the VIC and included in the 0800 Key Delivery Message to
enable the member to validate the new key.
See the V.I.P. System Services manual for more details about the Dynamic Key Exchange
Service.

15 Mar 2013 Visa Confidential 7–9


Running a Test Visa Test System – V.I.P.
User’s Guide

PIN Processing in VTS-V.I.P.


PIN processing in VTS-V.I.P. is similar in some aspects to PIN processing in VTS2000.
The value of the PIN shown in field 52 when editing the message and in the log is the
clear text (unencrypted) value. You can type this clear (unencrypted) PIN in field 52 using
the Field Editor. At run time, VTS-V.I.P. combines the clear PIN with the account number in
field 2 to create what is known as the PIN block. It then uses a working key (WK_1 or
WK_2) to encrypt the PIN block, which ultimately becomes field 52 in the outgoing
message.
At run time, when an incoming financial message is received (VTS-V.I.P. playing the role
of the issuer), the encrypted PIN block is shown in field 52. VTS-V.I.P. decrypts the PIN
block and the clear text value is shown in field 52 of the log. It uses the working key
(WK_1 or WK_2) to decrypt the PIN block.
If one VTS-V.I.P. machine sends a financial transaction (with PIN) and another VTS-V.I.P.
machine receives it, the clear text value of the PIN block in field 52 should be the same in
both logs, provided both machines have the same values for WK_1 and WK_2.
As an alternative to clear PINs, you can enter hex data directly into field 52 through the
Field Editor. This places the hex value directly into the message; it does not go through
the PIN block building or encryption process.
If the first 8 bytes of WK_1 are identical to the last 8 bytes, single DES will be used. If the
two “halves” of WK_1 are different, triple DES will be used.
The Zone Key Index in field 53.4 determines whether WK_1 or WK_2 will be used to
encrypt the PIN block.
The Security Format in Field 53.1 determines whether to create and encrypt the PIN
block. If Security Format is 20, VTS-V.I.P sends encrypted PIN Data in Field 52 and if the
value is not 20, VTS-V.I.P sends clear (unencrypted) PIN Data.

Using Keys in VTS-V.I.P.


You can set the value of each key in Preferences. Keys have a global effect on all tests
run in VTS-V.I.P.
Table 7–1 lists the keys you set in Preferences.

Table 7–1: Key Fields in Preferences

Field Description

AWK_1 Acquirer Working Key 1

AWK_2 Acquirer Working Key 2

7–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using Keys in VTS-V.I.P.
User’s Guide

Table 7–1: Key Fields in Preferences

Field Description

IWK_1 Issuer Working Key 1

IWK_2 Issuer Working Key 2

VSDC_MDK Chip Master Derivation Key

ZCMK Dynamic Exchange Key

MAC_1 MAC Key 1

MAC_2 MAC Key 2

VSDC Triple DES Triple DES or Single DES

To enter keys:
1. On the View menu, click Preferences. The Preferences dialog box appears. Click the
Keys tab.

15 Mar 2013 Visa Confidential 7–11


Running a Test Visa Test System – V.I.P.
User’s Guide

Figure 7–4: Keys Properties

2. Click Acquirer Working Keys or Issuer Working Keys.


3. Type values in the appropriate fields (hexadecimal digits only).
4. Under VSDC Triple DES, click Yes to have VTS-V.I.P. use Triple DES and No to use
Single DES.
See Chapter 9, Using Card Readers, for more information on chip card processing in
VTS-V.I.P.

5. Click OK.

7–12 Visa Confidential 15 Mar 2013


Obtaining Test Results 8

Introduction to Obtaining Test Results . . . . . . . . . . 8–1

About Log Viewer Messages . . . . . . . . . . . . . . . 8–1

Using the Log Viewer . . . . . . . . . . . . . . . . . . . 8–2

Using the Raw Message Viewer . . . . . . . . . . . . . 8–7

Printing Messages . . . . . . . . . . . . . . . . . . . .8–10

Deleting Messages . . . . . . . . . . . . . . . . . . . .8–10

Introduction to Obtaining Test Results


VTS-V.I.P. captures all messages and identifies them by severity and origin. Use the Log
Viewer to view these messages.
In addition, the Communications Handler logs the raw messages it is sending and
receiving. You can view these raw messages in the Communications Handler window
while it is running, or save these messages and view them at any time in the Raw
Message Viewer.

About Log Viewer Messages


There are three types of error messages:

Fatal—Fatal messages alert you to serious problems that require immediate action. In
most cases, if you receive a critical message, you should click OK and terminate the
run.
● Warning—Warning messages notify you about common, ordinary errors. You can
take action immediately or respond to the message at a later time.

15 Mar 2013 Visa Confidential 8–1


Obtaining Test Results Visa Test System – V.I.P.
User’s Guide

● Informational—Informational messages provide general information about the run.


These messages are usually not associated with an error.
In addition to severity, messages are identified by type or source (also called Log ID):
● System—System messages provide information about the application. These
messages can range from informational to fatal.
● User—User messages are related to your activity as you create, edit, and delete
tests, messages, and fields.
● ISO—ISO messages indicate the messages that were sent or received as a result of
executing a test.
● Parser—Parser messages are returned by a special parser function within VTS-V.I.P.
and most likely to do with an error in parsing an incoming message. The parser does
not work on outgoing messages.
● Comm Line—Comm Line messages provide information about the status and activity
of the Communications Handler.
VTS-V.I.P. logs all messages. However, in Preferences, you can set the type of messages
the Log Viewer appears. The Log Viewer contains an additional display filter so you can
further narrow the types of messages displayed.
EXAMPLE
At the beginning of a test, you may want to view all types of
messages. Later in the test, you may find it useful, and more space-
efficient for your computer, to view only certain messages.
Likewise, you may need to view all messages to find the context of an
error. However, when you are establishing a communications line, you
may only wish to see messages regarding the Communications
Handler.

Using the Log Viewer


VTS-V.I.P. logs all messages in the Vts3Default.log file regardless of origin or severity, and
if selected, also logs the ISO messages in a test-specific log file. You can select this
option in Preferences, Test Execution tab.
Use the Log Viewer to view all messages or find a particular one. The Log Viewer displays
the types of messages you choose in Preferences. You can further narrow this selection
with the Display Filter.
You can control whether to display the Log Viewer Toolbar and status bar by using the
View menu. Navigate through the displayed messages with the Next and Previous
buttons.

8–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using the Log Viewer
User’s Guide

Also, you can use Export in the Log Viewer to save selected messages or the entire log
file as a text file or Microsoft Word file. To save only selected messages, press the CTRL
key to select the messages and then click Export.
You can also use the Log Comparison feature to accomplish this. See Chapter 11,
Automated Log Comparison for more information.

To use the Log Viewer:


1. Click the View Detail Log toolbar button, or on the View menu, click Detail Log.

The Log Viewer window appears.

Figure 8–1: Log Viewer

Log messages contain the following:


– Severity—Informational, Warning, or Fatal
– Log ID—Source of message (System, User, ISO, Parser, Comm Line)
– Date and time—When the message occurred
– Text—Message content
– Case Name—Name of the related case
– Msg Name—Name of the related message
– Field Id—The field, if any, where the error occurred
NOTE: The following are for Development use only and will be removed in the future.
– File—Source code file name
– Line—Source code line number

15 Mar 2013 Visa Confidential 8–3


Obtaining Test Results Visa Test System – V.I.P.
User’s Guide

Drag the scroll bar on the right-hand side to view messages within the page. A page
contains about 150 log messages.
In Preferences, you set which types of messages to display in the Log Viewer. To
further narrow this selection, change the Log Viewer Options.
2. On the View menu, click Options. The Options dialog box appears.

Figure 8–2: Options Dialog Box

3. Select the check boxes of the type of messages you want to display and click OK.
4. Customize your layout by selecting the column headings in the Column area.
You can use the following navigation buttons to move through the messages:
Click Next Page to go to the next page of the log.

Click Previous Page to go to the previous page of the log.

Click Jump to Beginning to go to the top of the log.

8–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using the Log Viewer
User’s Guide

Click Jump to End to go to the end of the log.

Click Refresh to update the screen.

5. Double-click a log entry to review details. The System Message dialog box appears.

Figure 8–3: System Message Dialog Box

6. Once you review the details, click OK to close the dialog box.
7. If you double-click an ISO log entry, the corresponding Incoming Message or
Outgoing Message dialog box appears in a format similar to the Message Editor.
If you selected Validate in the Message Editor for a field, the Incoming Message
dialog box displays any invalid values in red. To only display these invalid values,
select the Show Errors Only check box.

15 Mar 2013 Visa Confidential 8–5


Obtaining Test Results Visa Test System – V.I.P.
User’s Guide

Figure 8–4: Incoming Message Dialog Box

8. In the Incoming Message log window, select F55 Tag ID Matching if you need to
match the tag IDs in Field 55.
9. Once you review the details, click Close.
10. If you double-click the bitmap (BMP) fields (identifiable by pink icon) in an ISO log
entry, the corresponding Bitmap Settings dialog box appears. You can see which
fields are present (labeled “on”) in the message.

8–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using the Raw Message Viewer
User’s Guide

Figure 8–5: Bitmap Settings Dialog Box

11. Once you review the details, click OK.


12. On the File menu, click Exit to close the Log Viewer.

Using the Raw Message Viewer


As you send and receive test messages, the Communications Handler captures these
raw messages in their original hexadecimal format, as they appear before they are parsed
by VTS-V.I.P. You can either view raw messages while the Communications Handler is
running, or save them in a separate file and view them later.
In order to save raw messages in a separate file, you must first set the Communications
Handler to log the raw messages, and then use the Raw Message Viewer to view them.
Set this option before starting the communications line. To change options on the general
tab, you have to stop the communications line, change the settings, and restart the line.
Also, you can use Export in the Raw Message Viewer to save the log file as a text file or
Microsoft Word file. You can export a selected raw message, a raw hex dump of a
message, or all raw messages.

To log raw messages in the Communications Handler:


1. Click the Start Communications toolbar button, or on the Tools menu, click Start
Communications.

15 Mar 2013 Visa Confidential 8–7


Obtaining Test Results Visa Test System – V.I.P.
User’s Guide

The Communications Handler window appears.


2. Select Tools, then Protocol Options. The Communications Handler Settings dialog
box appears.

Figure 8–6: General Settings

3. Click the Save raw messages check box.


4. In the File box, type a path and file name, or click Browse to locate a specific file.
5. Click Apply.
6. Close the Communications Handler.
The main VTS-V.I.P. window and the Communications Handler both contain toolbar
buttons that you can use to start the Raw Message Viewer.

8–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Using the Raw Message Viewer
User’s Guide

To use the Raw Message Viewer:


1. Click the View Raw Messages toolbar button, or on the View menu, click Raw
Messages.

The Raw Message Viewer window appears.

Figure 8–7: Raw Message Viewer

Raw messages contain the following:


● Msg—The message serial number
● Date and time—When the message was transmitted

Direction—Whether message is incoming or outgoing

Length—Number of bytes in the message
● Field—Header or field number
● Hex Value—The content of the message in hexadecimal format

15 Mar 2013 Visa Confidential 8–9


Obtaining Test Results Visa Test System – V.I.P.
User’s Guide

Printing Messages
You can print the contents of the messages in the Log Viewer or Raw Message Viewer.

To print messages:
1. Open the Log Viewer or Raw Message Viewer.
2. On the File menu, click Print.

Deleting Messages
You can delete all messages in the Log Viewer or Raw Message Viewer, or choose
particular messages based on date. In the Log Viewer, you can also delete multiple
messages by pressing the CTRL key while selecting the messages.

To delete messages:
1. Open the Log Viewer or Raw Message Viewer.
2. On the File menu, click Delete.

The Delete Log dialog box appears. (This example shows the Delete Log dialog box
in the Log Viewer.)

Figure 8–8: Delete Log Dialog Box

8–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Deleting Messages
User’s Guide

3. Choose to delete selected messages (in Log Viewer), all messages, or a range of
messages. You can only select a date that falls between the dates of the oldest and
newest log message.
4. Click OK.

15 Mar 2013 Visa Confidential 8–11


Using Card Readers 9

Introduction to Using Card Readers . . . . . . . . . . . 9–1

Chip Card Readers . . . . . . . . . . . . . . . . . . . . 9–2

Installing Chip Card Reader Software. . . . . . . . . . .9–12

Contactless and Magstripe Readers . . . . . . . . . . .9–17

Equinox Card Reader Terminal . . . . . . . . . . . . . .9–24

Processing Cards Offline . . . . . . . . . . . . . . . . .9–28

Processing Offline Without a Card Reader or Card . . . .9–31

Processing Cards Online . . . . . . . . . . . . . . . . .9–31

Introduction to Using Card Readers


This chapter explains how to read test cards using VTS-V.I.P. and various card readers. It
provides an overview of card processing and directions for installing card reader software.
VTS-V.I.P. supports several types of card readers:

Castles EZPROX contactless card reader
● GemPC Twin and GemCore Keyboard USB Pro Cherry Version 1.00 chip card
readers
● Magtek for magstripe card reader
● ViVOpay 4000 contactless card reader using MSD standard (supports Contactless
specification 1.4.2)
● ViVOpay 5000 contactless card reader (supports Contactless specification 2.0.2)
● Equinox Terminal (supports Magstripe, Contactless and Contact Chip Card Reader)

15 Mar 2013 Visa Confidential 9–1


Using Card Readers Visa Test System – V.I.P.
User’s Guide

It also describes the following methods of card processing available with


VTS-V.I.P.:
● Offline card processing

Offline card processing without a card reader or card
● Online card processing

Chip Card Readers


VTS-V.I.P. supports two chip card readers that are EMV Level 1-compliant (GemPC Twin
and GemCore Keyboard USB Pro Cherry Version 1.00).
These chip card readers conform to the EMV Integrated Circuit Card Specifications, a set
of requirements designed to ensure interoperability between chip cards and terminals on
a global basis. The EMV Level 1-compliant chip card readers allow a complete online chip
card processing flow.
Table 9–1 lists chip card readers supported by VTS-V.I.P.

Table 9–1: Overview of VTS-V.I.P.-Supported Chip Card Readers

Chip Card Reader Model EMV Level 1 Supports Supported in Supported in Supported in
Compliant Issuer Scripts Windows XP Windows Vista Windows 7

GemPC Twin
X X X X X

GemCore Keyboard USB


X X X
Pro Cherry Version 1.00

NOTE: The EMV Level 1-compliant chip card readers supported by VTS-V.I.P. have
been tested against Acquirer Device Validation (ADV) Tool Kit chip cards. Chip
cards not included in the ADV Tool Kit may not work as desired.

9–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Chip Card Readers
User’s Guide

VTS-V.I.P. reads the Application Identifier (AID) from the chip card and checks its validity
against the values listed in Table 9–2.

Table 9–2: Valid Application Identifiers (AID)

Application Identifiers (AID) Type

A0000000032020 VPay

A0000000030201 Canadian Visa Debit

A0000000030005 Visa Vale

A0000000031010 Visa

A0000000032010 Electron

A0000000033010 Interlink

A0000000036010 Domestic Visa Cash Stored Value

A0000000036020 International Visa Cash Stored Value

A0000000037010 Visa Horizon

A0000000038002 Dynamic Passcode Authentication

A0000000038010 PLUS

A0000000039010 Loyalty

A000000003999910 Proprietary ATM

A0000000041010 MasterCard

A0000000043060 Maestro

A00000002501 AMEX AIEPS

A0000000291010 AMEX AIEPS ALIAS ID

15 Mar 2013 Visa Confidential 9–3


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Chip Card Processing


In chip card processing, additional fields are added to the message and an Authentication
Request Cryptogram (ARQC) is generated for field 136. VTS-V.I.P. generates the ARQC
using data within the message and an encryption key stored in Preferences. The 16-byte
Master Derivation Key (MDK) used in the cryptogram generation process is stored in the
VSDC_MDK working key. The value is entered and shown in hexadecimal format.
Chip cryptogram encryption also involves the Data Encryption Standard (DES) algorithm,
and a process known as triple DES. VTS-V.I.P. supports triple DES in Preferences. You
must set the VSDC Triple DES working key to Yes. For more information, see the “About
Keys” section in Chapter 7, Running a Test.
In order for the chip fields to be included in a test message, you must set the Chip Fields
configuration setting to Yes. For more information, see the “About Test Configuration”
section in Chapter 4, Creating a Test.
In order for VTS-V.I.P. to generate a value for the ARQC, field 136 must be
system-generated in the Message Editor. Other fields in the message, related to the chip
card or not, will be populated according to the method indicated with each one, such as
copy from variable, literal, and so forth.
VTS-V.I.P. includes two methods of interacting with chip cards, offline and online. Offline
chip card processing uses the Variables Manager. In offline chip card processing, VTS-
V.I.P. reads data off the chip card and places it into a card variables group. You can use
this data again and again. VTS-V.I.P. can also perform offline chip card processing without
a chip card reader or a chip card.
In online chip card processing, VTS-V.I.P. interacts with the chip card, and uses this data
only in the current message.

Issuer Authentication
Using a EMV Level 1-compliant chip card reader with VTS-V.I.P. enables you to validate
that you can support issuer authentication. In issuer authentication, the chip card confirms
that it is communicating with the valid issuer of the card.
VTS-V.I.P. acting as the acquirer generates a message to the issuer. The issuer receives
the authorization message and responds with a message containing the ARPC and
ARPC Response Code in field 139. VTS-V.I.P. receives the information, parses the ARPC
and ARPC Response Code, and forwards this data (via the EXTERNAL AUTHENTICATE
command) to the card where it is validated.
VTS-V.I.P. acting as the issuer generates the ARPC and ARPC Response Code and
sends them to the acquirer in the response message.

9–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Chip Card Readers
User’s Guide

Issuer Scripts
Using a EMV Level 1-compliant chip card reader with VTS-V.I.P. also enables you to
validate that you can support issuer scripts. Issuer scripts are commands that allow the
issuer to change information on the chip card after the card has been issued. For
example, the issuer can rewrite or update a counter on the card to provide more restricted
usage. Issuer scripts are sent to the VSDC card in the response message.
When VTS-V.I.P. is acting as the issuer, it will send issuer scripts to the acquirer in the
response message (fields 55 and 142). This tests the acquirer’s ability to correctly accept
issuer script data in response messages and forward this information to the terminal.
VTS-V.I.P. supports the generation of only two issuer scripts, PUT DATA and UPDATE
RECORD.
When VTS-V.I.P. is acting as the acquirer it will receive the script in the response
message, act as the terminal to parse the issuer script data from fields 55 and 142 and
build issuer script commands, and send issuer script commands to the card via the card
reader. VTS-V.I.P. acting as the acquirer will accept any valid script from the issuer.

Chip Card Fields


In chip card processing, fields 130 to 149 are added, as needed, depending on the type of
message.
The difference between offline and online chip card processing is whether the chip card
fields are saved in a permanent card variables group in Variables Manager or in a
temporary card variables group created by VTS-V.I.P. during test execution, only for a
specific message.
For either online or offline chip card processing to work correctly, the population method of
the chip card fields in the message must be Copy From Variable. If any other population
method (for example, Literal or System Generated) is specified for a particular field in a
message, the value in the card variables group (either permanent or temporary) is
ignored.
If you specify a literal value, it over-writes the value placed in the message, but does not
change the value sent to the card reader.
EXAMPLE
Suppose you want to have VTS-V.I.P. use online chip card processing
but also have a literal value in field 145 (terminal transaction country
code), as seen through the Message Editor. VTS-V.I.P. will use the
terminal transaction country code from the acquirer variables group
and will also use the literal value from the Message Editor to construct
the message. The message and cryptogram will be out of sync. To
avoid this, the population method should be Copy From Variable, not
Literal.

15 Mar 2013 Visa Confidential 9–5


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Table 9–3 shows the chip card fields, the source of the data, and which variable VTS-V.I.P.
uses.

Table 9–3: Source and Variables Used for Chip Card Fields (1 of 3)

Field Source of Data Variable

Field 2—Primary Account Number Chip card PAN, Card Group


(PAN)

Field 23—Card Sequence Number Chip card CARD SEQ NUM, Card Group

Field 35—Track 2 Data Chip card PAN (35.1), EXPDATE (35.3),


SVCCODE (35.4), PVV (35.5),
DISDATA (35.6), Card Group

Field 41—Card Acceptor Terminal ID Terminal CARD ACCEPTOR TERM ID,


Acquirer Group

Field 130/F55 Tag 9F33—Terminal Terminal TERM CAP PROF, Acquirer Group
Capability Profile

Field 131/F55 Tag 95—Terminal Terminal TERM VERI RESULTS, Acquirer


Verification Results (TVR) Group

Field 132/F55 Tag 9F37— Terminal UNPRE NUM, Acquirer Group


Unpredictable Number

Field 133/F55 Tag 9F1E—Terminal Terminal TERM SER NUM, Acquirer Group
Serial Number

Field 134.1/F55 Tag 9F10—Derivation Chip card VISA DISCRE DATA, Card Group
Key Index

Field 134.2/F55 Tag 9F10— Chip card VISA DISCRE DATA, Card Group
Cryptogram Version

Field 134.3/F55 Tag 9F10—Card Chip card VISA DISCRE DATA, Card Group
Verification Results (CVR)

Field 135/F55 Tag 9F10—Issuer Chip card ISS DISCRE DATA, Card Group
Discretionary Data

Field 136/F55 Tag 9F26—Cryptogram Chip card ARQC, Card Group


Can be System Generated in
offline mode

9–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Chip Card Readers
User’s Guide

Table 9–3: Source and Variables Used for Chip Card Fields (2 of 3)

Field Source of Data Variable

Field 137/F55 Tag 9F26—Application Chip card APPL TXN CNTR, Card Group
Transaction Counter

Field 138/F55 Tag 82—Application Chip card APPL INTRCHG PROF, Card
Interchange Profile Group

Field 139.1/F55 Tag 91— Issuer N/A


Authorization Response Cryptogram
Can be System Generated in
(ARPC)
offline mode

Field 139.2/F55 Tag 91—ARPC Issuer N/A


Response Code
Can be System Generated in
offline mode

Field 142—Issuer Script Issuer N/A


after auth: 142.01/F55 Tag 72 Optional field
before auth: 142.01/F55 Tag 71
ID: 142.03/F55 Tag 9F18
command: 142.04/F55 Tag 86

Field 143—Issuer Script Results Issuer N/A


Optional field

Field 144/F55 Tag 9C—Cryptogram Terminal CRYPT TXN TYPE, Acquirer


Transaction Type Group

Field 145/F55 Tag 9F1A—Terminal Terminal TERMCTRY, Acquirer Group


Country Code

Field 146/F55 Tag 9A—Terminal Terminal TERM TXN DATE, Acquirer Group
Transaction Date

Field 147/F55 Tag 9F02—Cryptogram Terminal CRYPT AMT, Acquirer Group


Amount

Field 148/F55 Tag 5F2A—Cryptogram Terminal CRYPCURR, Acquirer Group


Currency Code

Field 149/F55 Tag 9F03—Cryptogram Terminal CRYPT CASHBACK AMT,


Cashback Amount Acquirer Group

15 Mar 2013 Visa Confidential 9–7


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Table 9–3: Source and Variables Used for Chip Card Fields (3 of 3)

Field Source of Data Variable

F55.21 Tag 9F6E – Form Factor Chip Card FORM FACTOR, Card Group
Indicator

F55.22 Tag 9F7C - Customer Chip Card CUSTOMR EXCUSIVE DATA,


Exclusive Data Card Group

User Interface
Due to a structure change in the format of Issuer Authentication Data (that is, F140 and
Tag 91 of F55) for VIS type of cards with CVN 18, there are a couple of setting changes in
the field editor to distinguish between a VIS type of cards between CVN 10/14 and CVN
18.
The CVN 10/14 cards still carry a fixed length of 10 bytes (8 bytes ARPC + 2 bytes Auth.
Response Code) of Issuer Authentication Data on F140 and Tag 91 of F55. However, the
CVN 18 cards have 4 bytes ARPC, 4 bytes CSU, and an optional 1-8 bytes of Proprietary
Authentication Data (PAD).
The following image shows the current field setting for VIS cards with CVN 10/14, which is
used in the current release (that is, prior to version 20). Note that F140.1 or F55.17.3
(ARPC) is at the top field level (no subfield).
The following image shows Field Editor setting/display on F140 for VIS cards with CVN
10/14.

9–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Chip Card Readers
User’s Guide

Figure 9–1: Message Editor

The following image shows Field Editor setting/display on Tag 91 of F55 for VIS cards with
CVN 10/14.

15 Mar 2013 Visa Confidential 9–9


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Figure 9–2: Message Editor

The screen snapshot below is the current field setting for VIS cards with CVN 18. Note
that F140.1 or F55.17.3 (ARPC) is set at the subfield (has 2 subfields) level. These
subfields (see screen snapshot) contains ARPC VIS (4 bytes) and CSU (4 bytes).
NOTE: F140.3 or F55.17.5 (PAD) are being omitted since this is an optional field. If this
PAD subfield is un-omitted, F140.2 or F55.17.4 (ARPC RC) should be omitted.
Forget to omit or un-omit these subfields will result an incorrect length which will
be rejected by VCMS.
Currently, only F55.17.3 that can be set at subfield level which contains ARPC
VIS and CSU.
Field Editor setting/display on F140 for VIS cards with CVN 18:

9–10 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Chip Card Readers
User’s Guide

Figure 9–3: Message Editor

Field Editor setting/display on Tag 91 of F55 for VIS cards with CVN 18:

Figure 9–4: Message Editor

15 Mar 2013 Visa Confidential 9–11


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Installing Chip Card Reader Software


This section describes how to install software for the GemPC Twin or GemCore Keyboard
USB Pro Cherry Version 1.00 chip card reader. Contactless and magstripe readers are
discussed in brief later in this chapter. If you have a different card reader, contact your
Visa representative to make sure the reader is supported and for installation instructions.
As mentioned earlier, you can perform offline chip card processing without a chip card
reader attached. First, connect the chip card reader to the USB port on your VTS-V.I.P.
computer. Contact your Visa representative if you need assistance. Then, follow the
appropriate section depending on your chip card reader and operating system.

Installing Software for the GemPC Twin


For the GemPC Twin chip card reader, you need to first install the driver and then verify
that the necessary software components have been installed on your computer.

Installing the Driver for the GemPC Twin


You can install the driver from the Gemplus Web site or from the VTS-V.I.P. CD.

To install the GemPC Twin driver from the Web site:


1. Type the following in the address bar of your browser window, and press Enter:
http://support.gemalto.com/index.php?id=pc_usb_tr_and_pc_twin
NOTE: The Gemplus Web site may change from the screen shot shown here.

Figure 9–5: Gemplus Web Site

9–12 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Chip Card Readers
User’s Guide

2. Click GemPCTwin PC/SC 32 bit drivers for Windows XP and Vista.


3. Follow the prompts to install the driver.

To install the GemPC Twin driver from VTS-V.I.P.:


1. Go to C:\Program Files (x86)\Vts3\Appl\SmartCardDriver\GemPC Twin
2. Enter into the sub folder as per the Operating System installed in your workstation.
3. Choose whether your GemPC Twin device is connected with USB/Serial port.
4. Next verify your OS and select either 32 Bit or 64 Bit.
5. Once selected, Double click on the respective .msi file.
6. Follow the prompts to install the driver.

Verifying Software Components for the GemPC Twin


The Microsoft Smart Card Manager software necessary to run the chip card reader was
installed with Windows XP. You must be set up as an administrator on the computer in
order to verify the components.
NOTE: Do not install the SCBASE.EXE or SMCLIB.EXE components.

To check the status of the Microsoft Smart Card Manager:


1. Right-click the My Computer desktop icon and click Manage. The Computer
Management Console starts.
2. Click the plus symbol (+) next to Services and Application, and click Services.
3. Double-click the Smart Card service. The service status should be “Started.”
4. If the status is not started, in the Startup Type drop-down list, click Automatic.
5. Click Apply to start the service.
6. Close the Computer Management Console.

Installing Software for the GemCore Keyboard USB Pro Cherry


For the GemCore Keyboard USB Pro Cherry chip card reader, you need to first install the
driver and then verify that the necessary software components have been installed on
your computer.

Installing the Driver for the GemCore Keyboard USB Pro Cherry
You can install the driver from the Cherry Web site or from the VTS-V.I.P. CD.

To install the GemCore Keyboard USB Pro Cherry driver from the Web site:
1. Type the following in the address bar of your browser window, and press Enter:

15 Mar 2013 Visa Confidential 9–13


Using Card Readers Visa Test System – V.I.P.
User’s Guide

http://www.cherrycorp.com/english/advanced-line/keyboard-smart-card-
home-banking-smartboard-g83-6733.htm
NOTE: The Cherry Web site may change from the screen shot shown here.

Figure 9–6: Cherry Web Site

2. Drag the scroll box to view the bottom of the page and click Download software. The
Cherry Support Download dialog box appears.

9–14 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Chip Card Readers
User’s Guide

Figure 9–7: Cherry Support Download Dialog Box

3. In the product list, click SmartBoard, G83-6733 (if not already selected).
4. In the Operating System list, click Windows XP.
5. Click Next. The Software/Manual Download dialog box appears.

15 Mar 2013 Visa Confidential 9–15


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Figure 9–8: Cherry Support Software/Manual Download Dialog Box

6. Click Download and follow the prompts to install the driver.

To install the GemCore Keyboard USB Pro Cherry driver from the CD:
1. Go to C:\Program Files\Vts3\Appl\Smart Card Driver.
2. Double-click SmartBoard_G83-6733.exe.
3. Follow the prompts to install the driver.

Verifying Software Components for the GemCore Keyboard USB Pro


Cherry
The Microsoft Smart Card Manager software necessary to run the chip card reader was
installed with Windows XP. You must be set up as an administrator on the computer in
order to verify the components.
NOTE: Do not install the SCBASE.EXE or SMCLIB.EXE components.

To check the status of the Microsoft Smart Card Manager:


1. Right-click the My Computer desktop icon and click Manage. The Computer
Management Console starts.
2. Click the plus symbol (+) next to Services and Application, and click Services.
3. Double-click the Smart Card service. The service status should be “Started.”
4. If the status is not started, in the Startup Type drop-down list, click Automatic.

9–16 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Contactless and Magstripe Readers
User’s Guide

5. Click Apply to start the service.


6. Close the Computer Management Console.

Contactless and Magstripe Readers


Besides chip card, two other types of card readers are supported by VTS-V.I.P.:
contactless and magstripe:
● Castles EZPROX contactless card reader
● Magtek for magstripe
NOTE: The Magtek magstripe reader is not suported in Windows Vista.
● ViVOpay 4000 contactless card reader using MSD standard (supports Contactless
specification 1.4.2)
● ViVOpay 5000 contactless card reader (supports Contactless specification 2.0.2)
Contactless is a new type of card reader requiring no physical contact to read card data.
The card is held in close proximity to the reader, and the reader gathers data.
Magstripe readers are more commonly known. Cardholders swipe cards through
magstripe card readers, and the card readers read and process card data.

Installing Contactless and Magstripe Readers and Software


This section describes how to install reader software for contactless and magstripe
readers. Chip card reader installation was discussed earlier in this chapter. If you have a
different kind of reader, contact your Visa representative to make sure the reader is
supported and for installation instructions.
First, connect the card reader to the USB port on your VTS-V.I.P. computer. You can refer
to the instructions that came from the manufacturer with your card reader. Contact your
Visa representative if you need assistance.
The installation software is provided with the VTS-V.I.P. setup.exe. The setup.exe files for
these card readers can be found at:
C:\Program Files\VTS3\Appl\
● Castle
● Magtek

Vivotech 4000
● Vivotech 5000
NOTE: The Magtek reader is not supported in Windows Vista.

15 Mar 2013 Visa Confidential 9–17


Using Card Readers Visa Test System – V.I.P.
User’s Guide

For more information, you can visit the manufacturer web sites.
● For the Castles EZPROX:
http://www.castech.com.tw/en/in-products-
03.aspx?id=P_00000039&cid=C_00000010&pname=EZPROX&cname=Contactless
+Reader
● For the Magtek:
http://www.magtek.com/support/software/programming_tools/drivers/
usb_hid_swipe.asp

Installing the Castles EZPROX Driver

To install the Castles EZPROX driver:


1. Navigate to C:\Program Files (x86)\Vts3\Appl\Castle Driver\USB Driver.
2. Right-click ezprox.inf, the setup file, and run Install.
3. Follow the installation steps provided by the installation program.
4. Attach the reader (select this from VTS-V.I.P. applications).
5. Set configuration options.
a. From the VTS-V.I.P. menu, select View > Preferences.
b. Click the VivoTech 5000 / Castle Settings tab.

9–18 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Contactless and Magstripe Readers
User’s Guide

Figure 9–9: Preferences Dialog Box

c. Choose the EMV parameters you want, then click OK.

To install the Castles EZPROX driver for Win7:


1. Navigate to C:\Program Files (x86)\Vts3\Appl\Castle Driver\Windows7\X Prox
Driver0111\V1.0.0.0.
2. The interface for Ezprox is USB or RS232. If the interface is USB then when we
connect the CL reader to PC then will have "find new device" message display. Just
need to follow the direction to browse the new driver folder to install it. If it still cannot
work, we need to remove the old driver from device manager panel and then re-install
new driver again.

Installing the Magtek Driver

To install the Magtek driver:


1. First, download the USB HID Swipe Reader Driver from the MagTek web site. It can
be found at the following link:
– http://www.magtek.com/support/software/programming_tools/drivers/
usb_hid_swipe.asp

15 Mar 2013 Visa Confidential 9–19


Using Card Readers Visa Test System – V.I.P.
User’s Guide

For your convenience, VTS-V.I.P. has all of the above setup files included in the install
program and is available at the following directory:
C:\Program Files\Vts3\Appl\Magtek
2. Select the subfolders based on the Operating System installed in your workstation.
3. Right-click MTHIDSR.inf, the setup file, and run Install.
This install will take a fraction of a second.
4. For Windows XP Double-click MTHIDCFG.exe.
For Windows Vista right click MTHIDCFG.exe and run as administrator.
5. Select the lowest available COM port from the HID Swipe Reader List box (in this
case COM5).
6. Click OK.

Figure 9–10: HID Virtual Serial Port Configuration Utility

7. Restart your computer.


8. Attach the magstripe reader, and you should be able to detect this through VTS-V.I.P.
IMPORTANT
The reader should not be connected to the computer until the driver is
installed and the port is selected. When you select the com port,
select the lowest com port available.

9–20 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Contactless and Magstripe Readers
User’s Guide

Installing the ViVOpay 4000 Driver

To install the ViVOpay 4000 driver:


1. Navigate to C:\Program Files\VTS3\Appl\Vivotech\Driver. Select the subfolders based
on the Operating System installed in your workstation.
( VTS-V.I.P. pre-installs the driver setup files in your VTS-V.I.P. install directory folder,
usually at this location.)
2. Double-click the setup file *.exe.

Figure 9–11: ViVOpay 4000 Driver Installer

3. Follow the installation steps provided by the installation program.

15 Mar 2013 Visa Confidential 9–21


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Figure 9–12: ViVOpay 4000 Driver Installer

4. Click Finish.

Figure 9–13: ViVOpay 4000 Driver Installer

9–22 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Contactless and Magstripe Readers
User’s Guide

5. Attach the reader (select this from VTS-V.I.P. applications).

To install the ViVOpay 4000 driver for Win7:


1. Navigate to C:\Program Files
(x86)\Vts3\Appl\Vivotech\Driver\Windows7\PL2303_Prolific_DriverInstaller_v1.7.0\.
2. Right click PL2303_Prolific_DriverInstaller_v1.7.0.exe and run as administrator.
3. Follow the prompts to install the driver.

Installing the ViVOTech 5000 Driver

To install the ViVOTech 5000 driver:


1. Navigate to C:\Program Files\VTS3\Appl\Vivotech\Driver. Select the subfolders based
on the Operating System installed in your workstation.
2. Double-click the setup file, *.exe.
3. Follow the installation steps provided by the installation program.
4. Click finish.
5. Attach the reader (select this from VTS-V.I.P. applications).
6. Set configuration options.
a. From the VTS-V.I.P. menu, select View > Preferences.
b. Click the VivoTech 5000 / Castle Settings tab.

15 Mar 2013 Visa Confidential 9–23


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Figure 9–14: Preferences Dialog Box

c. Choose the VivoTech 5000 Visa TTQ parameters you want, then click OK.

To install the ViVOpay 5000 driver for Win7:


1. Navigate to C:\Program Files
(x86)\Vts3\Appl\Vivotech\Driver\Windows7\PL2303_Prolific_DriverInstaller_v1.7.0\.
2. Right click PL2303_Prolific_DriverInstaller_v1.7.0.exe and run as administrator.
3. Follow the prompts to install the driver.

Equinox Card Reader Terminal


Equinox Payments offers a wide-array of payment terminals that serve as content delivery
platforms in both customer-activated and merchant-activated settings. For customer-
activated applications, Equinox has created the L5000 series, a line of user-friendly
payment terminals that incorporate the most comprehensive package of leading-edge
features on the market, including integrated NFC/contactless technology, EMV chip
reading and POS signature capture-all on a large, brilliant-color display.

9–24 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Equinox Card Reader Terminal
User’s Guide

The L5000 series, like all Equinox customer-activated terminals, seamlessly integrates
with the vast majority of electronic cash registers used by large-scale retailers throughout
the U.S. This terminal offers modular Contactless Reader, Signature Capture, PIN entry
etc. The NFC reader also works with Google Wallet, ISIS and so forth.

Installing the Equinox Terminal Driver

To install the Equinox Terminal driver:


1. Hypercom L5xx Serial Driver Installation
The L5xx USB to RS232 driver supports the USB gadget serial device. To install
Hypercom L5xx Serial driver, administrative privilege is required. Right click
Command Prompt (Start -> All Programs -> Accessories -> Command Prompt) and
select "Run as administrator" from the menu. Select the correct path for the driver as
per the system (in this case Windows7-x64).
Run the Hypercom serial driver with the option /commit. As shown below:
C:\Program Files (x86)\Vts3\Appl\Equinox\L5000 Serial Driver\x64 -
64Bit\win7>Hypercom_L5xxx_Serial_Installer.exe /commit
This will install the driver in any of the available COM Port. If you want to specify the
COM port number, please run as shown below:
C:\Program Files (x86)\Vts3\Appl\Equinox\L5000 Serial Driver\x64 -
64Bit\win7>Hypercom_L5xxx_Serial_Installer.exe /commit /COM10
(Where 10 is the port number chosen for the install.)
Please see the options shown in Figure 9–15 to check the list of available COM Ports,
Changing the Port number and Uninstallation and so forth.

15 Mar 2013 Visa Confidential 9–25


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Figure 9–15: Hypercom Serial Driver Installation

To verify successful installation, please attach the Equinox terminal to the system. A
new registry entry "\Device\thcdcacm0" should be listed under
"HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM".
2. FPE Interface Driver Installation
The Equinox Forms Processing Engine (FPE) Server is an in-proc COM server that
communicates to the Equinox Serial Server or Equinox TCP/IP Server and provides
API to drive Equinox Multi-Lane terminals. This driver is required to enable
communication between the terminal and the VTS application.
Install the Equinox FPE Interface driver from the VTS Install directory path. For ex:
"C:\Program Files (x86)\Vts3\Appl\Equinox\FPE Interface\ FPEInterfaceSetup.EXE".
3. Sentinel Driver Installation
This driver provides licensing encryption for applications that use Sentinel Keys.
Install the Sentinel System driver from the VTS Install directory path. For ex:
"C:\Program Files (x86)\Vts3\Appl\Equinox\Sentinel System Driver\Sentinel System
Driver.EXE".

9–26 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Equinox Card Reader Terminal
User’s Guide

Installing the packinglist for the Equinox Terminal

To install the Equinox Terminal packinglist:


The terminal user should load the packinglist to the terminal to start interacting with any
application. This can be done using the VTS tool (VariableManager) or using the USB
removable storage device.
1. Download Packinglist through VTS
If the packinglist is not installed in the terminal, VariableManager will prompt for
downloading the packinglist to the terminal. This is prompt only for the first time.
Please click on the "OK" button to start downloading.
The user can delete the file list from the terminal and reload the packing list using
VariableManager or USB removable storage device as mentioned above.
Once the download is complete, the terminal reboots. Please close the
VariableManager and restart only after the terminal is ready.
Now select "Equinox Terminal" and click on "Read Card" button adjacent to the
dropdown control. Please wait for the below messagebox to pop-up before producing
the card to the terminal.
The swipe form must be loaded to the terminal and lights blinking for accepting card to
read. Now flash the card to the contactless reader or swipe in the magstripe as the
case may be. Please click on the OK button of the above mentioned messagebox.
You can see the card data displayed in the grid of VariableManager.
2. Download Packinglist using USB memory stick
Alternately, the user can copy the packinglist (C:\Program Files
(x86)\Vts3\Appl\Equinox\dl) in a USB removable storage device and store it in the
terminal. Please copy all the files located in the mentioned path.
To download a packinglist to the terminal from a USB memory stick:
a. Ensure the DL folder containing the correct packinglist is installed on the USB
memory stick.
b. From the main menu in the terminal, select Utility -> Download -> USB Memory.
The terminal displays the following message, "Please insert USB stick in USB
host port for packinglist download."
c. Insert the USB memory stick into the USB host port. The packinglist installation
starts. When the installation is successful, the terminal reboots.
d. Remove the USB memory stick from the USB host port.

15 Mar 2013 Visa Confidential 9–27


Using Card Readers Visa Test System – V.I.P.
User’s Guide

Processing Cards Offline


In offline card processing, VTS-V.I.P. reads data off the card and places it into a card
variables group through the Variables Manager. You can then use this card variables
group in the same way you would use a card variables group that contains manually
entered data. These are static values, which you can use again and again. You can also
read multiple cards, saving them as different variables groups.

Saving the Card Data in a Variables Group


The first part of offline card processing involves saving the card data in a variables group.

To save the card data in a card variables group:


1. Click the Variables Manager toolbar button, or on the Edit menu, click Variables
Manager.

2. Open an acquirer variables group and modify the variables to be sent to the card.
3. Open a card variables group.
4. Select a card reader from the Card Reader Attached drop down menu. VTS-V.I.P.
supports contactless, chip card, and magstripe.

Figure 9–16: Variables Group Display

5. Click Read Card. The Select Acquirer Group dialog box appears.

9–28 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Processing Cards Offline
User’s Guide

Figure 9–17: Select Acquirer Group Dialog Box

6. Select the acquirer group you previously modified. VTS-V.I.P. uses the variables in
this group as terminal input data.
7. This step is for chip cards only. If the card has multiple applications, the Select ICC
Application dialog box appears.

Figure 9–18: Select ICC Application Dialog Box

8. Select which card application to use. VTS-V.I.P. reads the card and inserts the data in
the card variables group.
9. On the File menu, click Save As to save the card data in a new variables group.

10. On the File menu, click Exit to close the Variables Manager.

Running the Test With Offline Card Data


The second part of offline card processing involves setting the 3rd Bitmap Fields
configuration setting so the card fields are present, and designating that VTS-V.I.P. use
that card variables group for that particular test case when you run the test.

15 Mar 2013 Visa Confidential 9–29


Using Card Readers Visa Test System – V.I.P.
User’s Guide

This procedure describes how to designate a variables group for a test case. You can also
designate a variables group for an entire test (in the Test Properties dialog box), which will
designate it for all cases in that test. For more information, see the “Designating a
Variables Group for the Test Case” section in Chapter 5, Using Variables.

To run a test using the offline card data:


NOTE: Steps 1-5 are for chip cards only. For contactless and magstripe, continue
with step 6.
1. Open a test in the main VTS-V.I.P. window and click the test case to open it.
2. Click Config in the Test Area. The Test Configuration dialog box for that test appears
on the right-hand side of the screen.
3. Double-click the cell in the Y/N column to set the 3rd Bitmap Fields setting to Yes.

Figure 9–19: Test Configuration Dialog Box

4. Click OK to save your selections. VTS-V.I.P. adds the card fields to the message and
the main VTS-V.I.P. window appears.
5. Check that you have defined the VSDC_MDK keys for properly encrypting and
decrypting the ARQC and ARPC. See Chapter 7, Running a Test, for more
information on entering keys.
6. Click Properties under the case name. The Case Properties dialog box appears on
the right-hand side of the screen.

9–30 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Processing Offline Without a Card Reader or Card
User’s Guide

Figure 9–20: Case Properties Dialog Box

7. Under Variable Groups to Use, select the card variables group used to save the card
values from the drop-down list.
Next, run the test as described in “Executing a Test” in Chapter 7. When you run the test,
VTS-V.I.P. uses the values in this card variables group which are saved from the card.

Processing Offline Without a Card Reader or Card


If you do not have a card reader attached or a card, you can still perform offline card
processing in VTS-V.I.P.
With VTS-V.I.P. in the role of the acquirer, set field 136 (ARQC) to be system-generated in
the Field Editor in the outgoing 0100 message. VTS-V.I.P. generates a valid 16-
hexadecimal ARQC using the triple DES method and either literal input or a variable from
the acquirer group.

Processing Cards Online


In online card processing, VTS-V.I.P. interacts with the card, sending the appropriate
terminal information from the acquirer and issuer group you select and certain fields from
the message itself. VTS-V.I.P. retrieves the data and ARQC and uses them to populate the
various fields in the message. This data is not stored in a card variables group; it is used
only in the current message. VTS-V.I.P. logs the values of all fields in the messages that
are sent or received.
This procedure describes how to designate a variables group for a test case. You can also
designate a variables group for an entire test (in the Test Properties dialog box), which will
designate it for all cases in that test. For more information, see the “Designating a
Variables Group for the Test Case” section in Chapter 5, Using Variables.

15 Mar 2013 Visa Confidential 9–31


Using Card Readers Visa Test System – V.I.P.
User’s Guide

To perform online card processing:


NOTE: Steps 1-4 are for chip cards only. For contactless and magstripe, continue
with step 5.
1. Open a test in the main VTS-V.I.P. window and click the test case to open it.
2. Click Config in the Test Area. The Test Configuration dialog box for that test appears
on the right-hand side of the screen.
3. Click the cell in the Y/N column until the 3rd Bitmap Fields setting reads Yes.

Figure 9–21: Test Configuration Dialog Box

4. Click OK to save your selections. VTS-V.I.P. adds the card fields to the message and
the main VTS-V.I.P. window appears.
5. Click Properties under the case name. The Case Properties dialog box appears on
the right-hand side of the screen.

9–32 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Processing Cards Online
User’s Guide

Figure 9–22: Case Properties Dialog Box

6. Under Card, click Card Reader.


NOTE: Use the Refresh button to re-read the card if you are using multiple cards.

7. Click OK.
Next, run the test as described in the “Executing a Test” section in Chapter 7. When you
run the test, VTS-V.I.P. attempts to connect to the card reader. If successful, all test case
properties are saved.

15 Mar 2013 Visa Confidential 9–33


Using Card Readers Visa Test System – V.I.P.
User’s Guide

9–34 Visa Confidential 15 Mar 2013


Exporting and Importing Tests
and Files 10

Introduction to Exporting and Importing Tests and Files .10–1

Exporting Files . . . . . . . . . . . . . . . . . . . . . .10–2

Importing Files . . . . . . . . . . . . . . . . . . . . . .10–3

Introduction to Exporting and Importing Tests and Files


You can use the export feature to save a test so you can copy it from your computer to
another computer running VTS-V.I.P. Once you have created the exported archive file, use
the import feature to import the test.
NOTE: Copy and Export are not the same function. A copied database cannot be
imported. In order to import, the database has to be exported and then imported.
However, the exported database can be copied and imported.
VTS-V.I.P. tests contain the following components:
● Test configuration database (.stf)
● Variables database (.sva)

Raw Message File (.raw)

System Log (.log)
● ISO Log (.log)
By default, an export file contains the test configuration database. You can select whether
to include the other components. However, you must be logging raw messages or have
data in the logs to be able to include them.

15 Mar 2013 Visa Confidential 10–1


Exporting and Importing Tests and Files Visa Test System – V.I.P.
User’s Guide

When you import a test, you can select which components to import, depending on which
were included in the export file.

Exporting Files
The following section describes how to create an export file. You must first open the test
you want to export, otherwise the export menu is unavailable.
When you create an export file, it automatically contains the test configuration database.

To export a VTS-V.I.P. file:


1. Open a test.
2. On the Tools menu, click Export. The Export dialog box appears.

Figure 10–1: Export Dialog Box

3. Click the appropriate check boxes to include the following components:


– Raw Message File—If you select this option on the General tab in the
Communications Handler Settings dialog box, VTS-V.I.P. logs raw messages.
(See the “Using the Raw Message Viewer” section in Chapter 8.) If selected, the
Export dialog box shows the path of the file.
– System Log—This is the log of system messages that provide information
about the VTS-V.I.P. application.

10–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Importing Files
User’s Guide

– ISO Log—If you select this option in Preferences, Test Execution tab, VTS-V.I.P.
logs the ISO messages sent or received during test execution. If selected, VTS-
V.I.P. saves this file with the same name as the test.
– Variables Database—This is the Variables Manager database associated
with the test.
4. Type the name of the file in the Export File box, or click Browse to select the export
file name and path.
5. Click OK. VTS-V.I.P. creates the export file. When finished, an Export Complete
message appears.

Importing Files
The following section describes how to import a file. The test should already be saved
using the Export feature in VTS-V.I.P.

To import a VTS-V.I.P. file:


1. On the Tools menu, click Import. The Import dialog box appears.

Figure 10–2: Import Dialog Box

2. Click Browse to select the exported file in the Archive (.zip) File Name box.

15 Mar 2013 Visa Confidential 10–3


Exporting and Importing Tests and Files Visa Test System – V.I.P.
User’s Guide

3. When you identify and select the file, VTS-V.I.P. shows which components exist in the
exported file by automatically selecting those check boxes. If you do not want to
include a component, clear the check box.
4. Click OK.
5. A message box asks if you want to save changes. Click Yes.
6. The Save As dialog appears. Select a location for your file and click Save. VTS-V.I.P.
imports the file.

Import Warning Messages


This section provides warning messages.
● Mandatory field in VTS-V.I.P. template not present in VTS2000 template. Default
will be used.
Description: A field was not available in the VTS2000 template but is mandatory in the
corresponding VTS-V.I.P. template. The most likely cause is that the VTS-V.I.P.
template has incorrectly indicated that this field is mandatory.
Action: Report this to your Visa representative. Please provide a copy of the VTS2000
database being converted and a copy of the Vts3Default.log file.
● Field found in VTS2000 template not present in VTS-V.I.P. template.
Description: A field with a value was found in the VTS2000 template, but that field is
not available in VTS-V.I.P. template. This may indicate a problem in the VTS-V.I.P.
template.
Action: Report this to your Visa representative. Please provide a copy of the VTS2000
database being converted and a copy of the Vts3Default.log file.

10–4 Visa Confidential 15 Mar 2013


Automated Log Comparison 11

Introduction . . . . . . . . . . . . . . . . . . . . . . . .11–1

About Comparing Log Files . . . . . . . . . . . . . . . .11–1

Opening Automated Log Comparison . . . . . . . . . .11–2

Comparing Log Files . . . . . . . . . . . . . . . . . . .11–3

Introduction
Automated Log Comparison provides a very fast and accurate means of detecting
differences in test results, giving users, developers, QA analysts, regional certifiers, and
members better productivity. Testing efforts are simplified by providing an automated
comparison of member logs run prior to and after member host changes are introduced.

About Comparing Log Files


The Automated Log Comparison utility compares two ISO log files. The following checks
are made on the selected files:
● Whether the file exists
● Whether the Log File is the file generated by VTS-V.I.P. application
If either checks returns an negative result, an error messages appears.
The Option dialog box provides user with a means to exclude certain fields from
comparing with each other. These fields should be omitted from the comparison because
they will be different among the logs.

15 Mar 2013 Visa Confidential 11–1


Automated Log Comparison Visa Test System – V.I.P.
User’s Guide

For example, some fields may contain valid differences:


● Date & Time
● System Generated Fields
● Fields of Transmission
● Retrieval Reference Number
Only the values of matching field ids will be compared. If the value turns out to be
different, then both fields are stored in difference objects. Even if the field ID does not
match, a difference object is created.
The following set of fields are displayed in the output report
● Field ID is same and its data are different
● Fields present in <LogFile1> and not in <LogFile2>
● Fields not present in <LogFile1> and present in <LogFile1>
NOTE: Excluded fields are ignored.

Opening Automated Log Comparison


Automated Log Comparison is an MFC dialog-based application. This utility handles only
.log extension files generated by VTS-V.I.P.

To view the Automated Log Comparison utility:


1. From the View menu option, select Log Comparison. The Automated Log
Comparison window appears.

Figure 11–1: Automated Log Comparison Dialog Box

11–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Comparing Log Files
User’s Guide

There are three menu bar options:


● File
● Tools
● Help
And the toolbar contains three buttons:
● Start Log Comparison
● Stop Log Comparison
● Help

Comparing Log Files


These should be ignored during log comparison.

To exclude fields:
1. From the Tools menu, select Options.

Figure 11–2: Options Dialog Box

2. The Options dialog appears.

15 Mar 2013 Visa Confidential 11–3


Automated Log Comparison Visa Test System – V.I.P.
User’s Guide

Figure 11–3: Options Dialog Box

3. In the Exclude area, click to select the fields you want to exclude from the log
comparison. Enter the location where you want the file saved.
4. Click Apply and then click OK to close the Options dialog.
Once you have selected the fields you want excluded, you are ready to compare log files.

To compare log files:


1. From the File menu, select Compare Log.

Figure 11–4: Automated Log Comparison Dialog Box

11–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Comparing Log Files
User’s Guide

2. The log comparison function executes. When finished, a Log Comparison Completed
message appears.

3. Click OK to close the dialog.


NOTE: If needed, select File>Stop Compare to end the log comparison.

To view the log comparison results:


1. From the File menu, select View Recent Target File.
2. Wordpad opens displaying the log comparison field differences. When finished, close
the file by clicking the X icon in the upper-right corner.

15 Mar 2013 Visa Confidential 11–5


Using VTS-V.I.P. with VCMS 12

Introduction to Using VTS-V.I.P. with VCMS . . . . . . .12–1

Testing With VCMS . . . . . . . . . . . . . . . . . . . .12–1

Setting VCMS Preferences . . . . . . . . . . . . . . . .12–6

Logging On to VCMS . . . . . . . . . . . . . . . . . . .12–8

Introduction to Using VTS-V.I.P. with VCMS


This section describes VCMS loopback testing including how the VAP and VTS-V.I.P. are
connected to VCMS, the various loopback modes, and logging on to VCMS.

Testing With VCMS


VCMS loopback testing is the last step before going online with the V.I.P. System. The
VisaNet Loopback uses a network connection between the VAP and the VCMS test
system in a test environment. This arrangement most closely replicates the V.I.P.
production environment with the VTS-V.I.P. computer attached to the test port of the VAP
and assuming the role of the acquirer or issuer.
Figure 12–1 illustrates how VTS-V.I.P. is connected to the VAP serial port and VCMS in
VisaNet Loopback mode, and shows how a request and response message travels from
the acquirer member host to VTS-V.I.P. acting as the issuer and back.

15 Mar 2013 Visa Confidential 12–1


Using VTS-V.I.P. with VCMS Visa Test System – V.I.P.
User’s Guide

Figure 12–1: Message Flow in VisaNet Loopback Mode

Acquirer Host

VCMS Loopback
Response Request

Request

Response

VAP VCMS VIC


Serial Test Port

VTS-V.I.P. acting as Issuer Host

If you plan to test VTS-V.I.P. with the VisaNet Certification Management Service (VCMS),
it offers the following loopback modes:
● Local Loopback—Routes messages to and from the member host using the VTS-
V.I.P. test port connection to the VAP without a connection to the VCMS test system.
Local Loopback uses communications interfaces that are identical to those used for
online VCMS testing.

VisaNet Loopback—Routes messages to and from VTS-V.I.P. and the member host
through the VAP and VCMS test systems. VisaNet Loopback mode provides a
simulation of a complete V.I.P. processing cycle.

None—Routes messages to and from the member's host to either another member's
host, or a Visa certification lab. Because VTS-V.I.P. is not in the routing path for this
loopback mode, it prohibits test execution until the loopback mode is changed to
either Local Loopback or VisaNet Loopback.
For Windows XP or Windows Vista, the member line uses TCP/IP.
The test port line from VTS-V.I.P. to the VAP uses the TCP/IP protocol, and the VCMS line
connected to the VAP uses the IP protocol. These VCMS testing protocols are shown in
Figure 12–2.

12–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Testing With VCMS
User’s Guide

Figure 12–2: VCMS Testing Protocols

For Test Port


Windows XP line uses
and TCP/IP
Windows
Vista,
Acquirer member line VAP
VTS-V.I.P.
Host uses TCP/IP Serial Test
VCMS Loopback acting as
Port
Issuer Host
VCMS VIC line uses IP

VCMS
VIC

CR Message Processing
Whenever a connection to a VAP goes to Up status, the VAP sends a Connection Report
(CR) message. This CR message contains information regarding the station IDs identified
in the VAP configuration.
Using the station IDs, VCMS establishes station pairing between the member host and
VTS-V.I.P. This is further explained in the “Station Pairing” section.

The CR message contains the following seven station slots:



VAP
● Member credit station ID
● Member MIS station ID

Member CAS station ID

VTS-V.I.P. credit station ID

VTS-V.I.P. MIS station ID

VTS-V.I.P. CAS station ID

When logging into VCMS, you can choose whether to pair two credit stations for BASE I
testing or to pair a MIS and CAS station for SMS testing.

15 Mar 2013 Visa Confidential 12–3


Using VTS-V.I.P. with VCMS Visa Test System – V.I.P.
User’s Guide

If you select the credit station ID for VTS-V.I.P., it automatically inserts a credit station ID
for the member host. If you select a CAS station ID for VTS-V.I.P., it automatically inserts a
MIS station ID for the member host.
You can override these automatic selections by editing the partner station ID.

Station Pairing
This section describes how the V.I.P. System matches and routes messages to their
proper destinations, and how VTS-V.I.P. accomplishes this through station pairing.
The V.I.P. System compares information in key data fields to match messages within a
transaction. These messages include the original request, original response, and any
subsequent messages. For instance, the Retrieval Reference Number (Field 37) is a key
data element for matching a message to others within a given transaction set. The
reference number must be the same for all messages in the set.
As well as matching messages, the V.I.P. System routes requests to their proper
destination. Usually V.I.P. routes requests based on the account number in the message.
The issuer associates each issuer BIN (a range of card numbers for a specific card
program, such as Visa Classic) with a specific issuer processing center.
In some cases, V.I.P. uses data other than the account number to determine message
routing. Also, issuers can control which processing center receives requests for their
cardholders by designating multiple processing centers and specifying the types of
transactions that should be routed to each processing center.
A single processing center can have any number of physical network stations, based on
volume and business needs. Network stations send a sign-on message (0800) to V.I.P. to
notify it when they are available to send and receive messages.
In the test environment, messages cannot be matched and routed in this manner; instead,
VCMS establishes station pairing between the member host and VTS-V.I.P. so traffic from
one station always goes to the other station.
Just as network stations notify V.I.P. that they are available by sending a sign-on
message, a network station has to sign on and sign off when connecting to and
disconnecting from VCMS.
When switching to VisaNet Loopback mode, VTS-V.I.P. sends a sign-on message (0800)
that contains the station IDs of the member host and VTS-V.I.P. It inserts the station IDs
into Header Field 5—Destination Station ID and Header Field 6—Source Station ID. Once
VCMS receives this 0800 message, it pairs together the two network stations and routes
subsequent messages according to that pairing.

12–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Testing With VCMS
User’s Guide

Other Non-ISO Messages


VTS-V.I.P. also has the capability to process several kinds of messages needed in the
VisaNet Loopback mode.
Time Query (TQ) and Time Broadcast (TB) messages ensure that the VAP is
synchronized with the VCMS VIC. The VAP sends a TQ message to the VCMS VIC.
VCMS responds with a TB message, and the VAP can synchronize its timeclock.
The IP VAP sends a Heart Beat message (HBM) or responds to one, to tell VCMS that it
is still active and connected.
VTS-V.I.P. can send or respond to an Endpoint Session (ES) message just as an IP VAP
would do.

Changing Loopback Mode


The loopback mode is controlled on the VAP. With VTS-V.I.P., you can send a loopback
query to find out the current loopback mode of the VAP and issue a remote shell
command to change the loopback mode on the VAP.
When you choose VisaNet Loopback mode, VTS-V.I.P. changes the mode on the VAP
through a remote shell command to VisaNet and sends a 0800 sign-on message to
VCMS.
If you change the status from VisaNet Loopback to any other mode, VTS-V.I.P. issues a
remote shell command to change the mode, and the VAP, in response, also stops the
VCMS VIC line.

15 Mar 2013 Visa Confidential 12–5


Using VTS-V.I.P. with VCMS Visa Test System – V.I.P.
User’s Guide

Table 12–1 shows how this loopback query works depending on which mode you select in
VTS-V.I.P. and the current loopback mode of the VAP.

Table 12–1: Changing VCMS Loopback Mode

Current Loopback Mode Desired Loopback Mode How Loopback Query Works

VisaNet Local 1. VTS-V.I.P. sends a sign-off message.


2. VTS-V.I.P. sends a remote shell command to
change the loopback mode on the VAP to Local.

None 1. VTS-V.I.P. sends a sign-off message.


2. VTS-V.I.P. sends a remote shell command to
change the loopback mode to None.

Local VisaNet 1. VTS-V.I.P. sends a remote shell command to


change the loopback mode to VisaNet.
2. VTS-V.I.P. sends a sign-on message.

None VTS-V.I.P. remote shell command to change the


loopback mode to None.

None VisaNet 1. VTS-V.I.P. sends a remote shell command to


change the loopback mode to VisaNet.
2. VTS-V.I.P. sends a sign-on message.

Local VTS-V.I.P. sends a remote shell command to change


the loopback mode to Local.

IMPORTANT
It is strongly recommended that you always exit in Local Mode to
avoid having to manually set the mode on the VAP.

Setting VCMS Preferences


You can set several preferences related to logging on to VCMS.

To set up the VCMS Login preferences:


1. On the View menu, click Preferences. The Preferences dialog box appears. Click the
VCMS Login Parameters tab.

12–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Setting VCMS Preferences
User’s Guide

Figure 12–3: Preferences Dialog Box

2. In the CR Msg Timeout box, type the amount of time VTS-V.I.P. will wait for a CR
(Connection Report) message to be sent from the VAP. Once this time limit is
exceeded, it automatically stops and restarts the line in order to “force” the VAP to
send a CR message. If the VAP still does not send a CR message, you will receive an
error message.
3. VTS-V.I.P. inserts a default value into the IPC Timeout box. The Inter-Process Call
(IPC) is used by the name pipes between the Communications Handler and VTS-V.I.P.
to delay sending or receiving messages. You only need to change this value because
of the speed of the hardware on which VTS-V.I.P. is installed.
4. In the SignOn/Off Reply Timeout box, type the amount of time VTS-V.I.P. should wait
for an 0810 response to the 0800 sign-on request sent as a result of the VCMS logon
process.
5. In the Wait For VIC box, type the amount of time to wait for the line from the VAP to
the VIC to brought up.
6. In the Start/Stop Line Timeout box, type the amount of time to start or stop the line to
the VAP.

15 Mar 2013 Visa Confidential 12–7


Using VTS-V.I.P. with VCMS Visa Test System – V.I.P.
User’s Guide

7. In the Loopback Mode Timeout box, type the amount of time to query or change the
loopback mode on the VAP.
8. Click OK.

Logging On to VCMS
This section describes how to log on to VCMS.
IMPORTANT
It is strongly recommended that you always exit in Local Mode to
avoid having to manually set the mode on the VAP.
1. Click the Login to VCMS toolbar button, or on the Tools menu, click VCMS Login.

The Communications Handler starts, if it is not already running.


VTS-V.I.P. may need to bring down and restart the line, depending on whether a CR
(Connection Report) message has been received and processed. The CR message is
the source of information regarding the stations identified on the VAP for testing
purposes within the VCMS subsystem.
Once the line is up, VTS-V.I.P. connects to the VAP operating system.
The VCMS Login dialog box appears.

12–8 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Logging On to VCMS
User’s Guide

Figure 12–4: VCMS Login Dialog Box

2. VTS-V.I.P. sends a remote shell command to query the loopback mode status. In the
Loopback Mode box, it displays None, Local, or VisaNet.
Click Query if VTS-V.I.P. does not automatically query the loopback mode.
To change the loopback mode, by clicking None, Local or VisaNet, see Table 12–1
for a description of what VTS-V.I.P. will do, based on the current loopback mode.
3. Under Stations IDs, the VTS-V.I.P. drop-down list displays the three VTS-V.I.P. station
IDs as defined by the VAP. Select one.
4. After you select a station ID, VTS-V.I.P. automatically selects the corresponding
member host’s station ID, which appears in the Member Host drop-down list.
5. If you want to change any station IDs, click Edit. The Edit Partner Station ID dialog
box appears.

15 Mar 2013 Visa Confidential 12–9


Using VTS-V.I.P. with VCMS Visa Test System – V.I.P.
User’s Guide

Figure 12–5: Edit Partner Station ID Dialog Box

6. Type a new station ID and click OK.


7. Click Close to save the settings, and close the VCMS Login dialog box.

12–10 Visa Confidential 15 Mar 2013


Using VTS-V.I.P. with EAS/Visa MG 13

Introduction to Using VTS-V.I.P. with EAS/Visa MG . . .13–1

Station Pairing and Depairing . . . . . . . . . . . . . . .13–3

Secure Member Connection (SMC). . . . . . . . . . . .13–4

Introduction to Using VTS-V.I.P. with EAS/Visa MG


This section describes how to test through EAS/Visa MG.

Menu Bar and Buttons


The EAS/Visa MG menu item appears under the Tools menu.

15 Mar 2013 Visa Confidential 13–1


Using VTS-V.I.P. with EAS/Visa MG Visa Test System – V.I.P.
User’s Guide

Figure 13–1: Tools Menu

An EAS/Visa MG button has been added to the toolbar.

Select either options to open the EAS/Visa MG Pairing dialog box.

Figure 13–2: EAS/Visa MG Pairing Dialog Box

13–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Station Pairing and Depairing
User’s Guide

Station Pairing and Depairing


The new station ID pairing and depairing functionality allows VTS-V.I.P. to interact with an
Extended Access Server or the Visa MG, providing users the option to pair or depair
stations.
In the EAS/Visa MG pairing dialog box, station IDs that need to be paired are selected
from the Visa Test System and Member Host boxes. Only 1:1 station pairing is allowed.
VTS-V.I.P. and the member host station IDs can be added using the Add Station ID’s
button. When users click the Add Station ID’s button, the Add Station ID’s dialog box
opens.

Figure 13–3: Add Station ID’s Dialog Box

Visa Test System and Member Host station IDs that need to be paired can be added here.
Clicking OK will save any changes made in this dialog box.
To pair two station IDs, users can click the Pair button. Then the paired station IDs are
displayed in the Station Paired box. The paired station can be depaired by selecting the
pair and clicking Depair.
Users may also choose either Automatic Depair on Exit, or Prompt for Depairing on Exit. If
users select Prompt for Depairing on Exit, the Depair confirmation box appears, as shown
in the following figure. The Close button is provided to exit the EAS dialog box.

Figure 13–4: Depair Dialog Box

15 Mar 2013 Visa Confidential 13–3


Using VTS-V.I.P. with EAS/Visa MG Visa Test System – V.I.P.
User’s Guide

Secure Member Connection (SMC)


The VTS-V.I.P. tool supports the following Secure Member Connection (SMC) messages.
● VTS-V.I.P. Acting as a CLIENT
– Logon Message
– Logoff Message
– Station Assignment Message
– Heartbeat Message
● VTS-V.I.P. Acting as a SERVER:
– Heartbeat Message
– Shutdown Message

Setting up the Communication Handler for Secure Member Connection

To set up the communication handler for Secure Member Connection:


1. From the VTS main menu, select Tools > Protocol Options.
2. On the General tab, select the Secure Member Connection check box.

Figure 13–5: General Settings

13–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Secure Member Connection (SMC)
User’s Guide

3. On the TCP/IP tab, set the IP Address and Port Number.

Figure 13–6: TCP/IP Settings

When your connection is up, the Communication Handler SMC menu and tool bars
will be enabled in the VTS tool.

15 Mar 2013 Visa Confidential 13–5


Using VTS-V.I.P. with EAS/Visa MG Visa Test System – V.I.P.
User’s Guide

Figure 13–7: SMC Menu

Adding Auto Generation for Heart Beat Messages


By default, VTS-V.I.P. allows for an Auto SMC Heart Beat message every 90 seconds. To
stop auto Heart Beat messages, set the time to 0 (zero) seconds. This is a editable field,
so you can adjust the time interval as needed.

Setting up Stunnel
Stunnel is a third-party open source application that you can use to encrypt your TCP
communications. You will find the application for download, as well as all Stunnel
documentation, at http://www.stunnel.org/ or http://www.openssl.org/.

13–6 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Secure Member Connection (SMC)
User’s Guide

Editing SMC Message: To edit the SMC messages please click the SMC
Edit menu

Table 13–1: List of SMC Message Edit Menus

Message Name Editable Fields

Edit LogOn Msg Edit Logon Message is used to modify the following
fields :
1. TransCodeIdentifier
2. MessageIndicators
3. OriginatorID
4. TransmissionDateAndTime
5. UserID
6. UserPassword
7. ResponseCode

Here, TransCodeIdentifier field is the key field. So, user


cannot modify it.

Edit logoff Msg Edit Logoff Message is used to modify the following
fields :
1. TransCodeIdentifier
2. MessageIndicators
3. OriginatorID
4. TransmissionDateAndTime
5. ResponseCode

Here, TransCodeIdentifier field is the key field. So, user


cannot modify it.

Edit StationAssign Edit Station Assignment Message is used to modify the


following fields :
1. TransCodeIdentifier
2. MessageIndicators
3. OriginatorID
4. TransmissionDateAndTime
5. StationID
6. ResponseCode

Here, TransCodeIdentifier field is the key field. So, user


cannot modify it.

15 Mar 2013 Visa Confidential 13–7


Using VTS-V.I.P. with EAS/Visa MG Visa Test System – V.I.P.
User’s Guide

Table 13–1: List of SMC Message Edit Menus

Message Name Editable Fields

Edit HeartBeat Msg Edit HeartBeat Message is used to modify the following
fields :
1. TransCodeIdentifier
2. MessageIndicators
3. OriginatorID
4. TransmissionDateAndTime
5. ResponseCode

Here, TransCodeIdentifier field is the key field. So, user


cannot modify it.

Edit Shutdown Msg Edit Shutdown Message is used to modify the following
fields :
1. TransCodeIdentifier
2. MessageIndicators
3. OriginatorID
4. TransmissionDateAndTime
5. ResponseCode
6. ShutdownTimeout

Here, TransCodeIdentifier field is the key field. So, user


cannot modify it.

13–8 Visa Confidential 15 Mar 2013


Using VTS-V.I.P. with Add Fields 14

Introduction to Using VTS-V.I.P. with Add Fields . . . . .14–1

Procedure to Add Fields in Multiple Messages . . . . . .14–3

Introduction to Using VTS-V.I.P. with Add Fields


This section describes how to perform mass updates of messages within existing
databases (.stf files) when new fields are added. The application is enhanced such that
when new fields are added, the selected messages are updated with the appropriate data
rather than having to update each message individually.

Menu Bar and Buttons


The Message AddFields menu item appears under the Edit menu.

15 Mar 2013 Visa Confidential 14–1


Using VTS-V.I.P. with Add Fields Visa Test System – V.I.P.
User’s Guide

Figure 14–1: Edit Menu

An Add Fields button has been added to the toolbar.

Select either options to open the select fields dialog box.


NOTE: When you select any message, Add Fields button will be enabled.

14–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Procedure to Add Fields in Multiple Messages
User’s Guide

Procedure to Add Fields in Multiple Messages


To use Add Fields:
1. Select the messages using 'Control' key in the main VTS-V.I.P. window as shown in
Figure 14–2.

Figure 14–2: Main VTS-V.I.P. Window

2. Click toolbar button Add Fields or on the edit menu, click Message AddFields.
NOTE: When you select any message, Add Fields button will be enabled.
3. The Select Fields dialog box appears with all ISO fields as shown in Figure 14–3.

15 Mar 2013 Visa Confidential 14–3


Using VTS-V.I.P. with Add Fields Visa Test System – V.I.P.
User’s Guide

Figure 14–3: Select Fields Dialog Box

4. Select an available field on the left-hand side and click Add.


NOTE: When you add certain fields, a dialog box appears so you can specify the usage.
5. Click OK. The new field will be added in the message in correct position.
NOTE: If you later want to remove this field from the message, open the message in
Message Editor then right-click it and click Delete or set the field property to
Omit.

14–4 Visa Confidential 15 Mar 2013


Using VTS-V.I.P. with Script Generator 15

Introduction to Using VTS-V.I.P. with Script Generator . .15–1

Procedure to Create Script from a Defined Database . .15–3

Introduction to Using VTS-V.I.P. with Script Generator


This section describes how to Create Scripts (excel file) automatically from the defined
databases (.stf files) for transaction details. List of selected fields are included in the
transaction detail. This feature will enable the user to select fields of an open database
they want to see on the script and save the script in a specified location.

Menu Bar and Buttons


The Script Generator menu item appears under the Edit menu.

15 Mar 2013 Visa Confidential 15–1


Using VTS-V.I.P. with Script Generator Visa Test System – V.I.P.
User’s Guide

Figure 15–1: Edit Menu

An Script Generator button has been added to the toolbar.

Select either options to open the select fields dialog box.

15–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Procedure to Create Script from a Defined Database
User’s Guide

Procedure to Create Script from a Defined Database


To create script (excel file):
1. Open a defined database (.stf file) in the left panel of the VTS-V.I.P application.
2. Click toolbar button Script Generator or on the edit menu, click Script Generator.
3. VTS-V.I.P will start retrieving data, please wait it may take several minutes as shown
in Figure 15–2.

Figure 15–2: Retrieving Data Dialog

4. After retrieving all data, the Select Fields dialog box appears with all not omitted ISO
fields of messages as shown in Figure 15–3.

Figure 15–3: Select Fields Dialog Box

15 Mar 2013 Visa Confidential 15–3


Using VTS-V.I.P. with Script Generator Visa Test System – V.I.P.
User’s Guide

5. Select an available field on the left-hand side and click Add.


NOTE: If you want to remove this field from Added Fields list box, click the Remove
button.
6. After selecting fields click the Next button.
7. The Create Script dialog box appears as shown in Figure 15–4.

Figure 15–4: Create Script Dialog Box

8. Browse a location to save the script and click on Finish button.


NOTE: By Default the destination path is 'User_Test_Scripts' folder under C:\Program
Files.
9. After clicking Finish button a message box will appear as shown in Figure 15–5.

15–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P. Procedure to Create Script from a Defined Database
User’s Guide

Figure 15–5: Message Box

10. Click the Yes button to open the script (excel) file or No to close.
This script (excel) file contains following transaction details:

Case #: Case number
● MTI: MTI of the Case
● Test Description: Description of the message
● Selected Fields (From 'Select Fields' dialog): Field value of the outgoing message.
● Comments

15 Mar 2013 Visa Confidential 15–5


Index
Numerics online chip card processing, 9–32
setting match probability, 7–7
3rd Bitmap, 4–14
changes, in system, 2–4
3rd Bitmap Expanded, 4–9
changing
3rd Bitmap Fields, 4–9
case name, 4–7, 6–6
A loopback mode, 12–5
test properties, 4–5
adding
chip card processing
a field, 6–11
description of, 9–4
a test case, 4–7
fields, 9–5
message delay, 4–20
installing reader, 9–12
test description, 4–5
offline method, 9–28
Address Verification Service (AVS), 4–9, 4–14
online method, 9–31
associating card and issuer variables groups, 5–17
chip card readers, 9–1 to 9–2
automated log comparison, 11–1
comm line messages, 8–2
AVS. See Address Verification Service
communication cards
B requirements, 2–3
Bitmap Editor Communications Handler
description of, 6–12 choosing a protocol
using, 6–12 overview, 2–1, 3–3
bitmap, viewing from a field, 8–6 TCP/IP, 3–3, 3–5, 3–10
bypass VCMS stations, 4–9 configuring modem eliminator, 3–13
configuring RAS files, 3–7
C connecting a dial-up modem, 3–10
card reader connecting a null modem, 3–6
chip, 9–1 display, 3–2
contactless, 9–1 messages, 8–2
magstripe, 9–1 setting up connectivity
card reader, installing LAN, 3–4
contactless, 9–19 serial port using SLIP (direct), 3–8
magstripe, 9–19 serial port using SLIP (modem), 3–10
card readers setting up the RAS phone book, 3–8
contactless, 9–17 communications protocols
magstripe, 9–17 choosing
Card Verification Value (CVV) Service, 4–10, 4–15 overview, 2–1, 3–3
Case Properties dialog box TCP/IP, 3–3, 3–5, 3–10
changing case name, 4–7, 6–6 requirements, 2–2
designating variables group, 5–25 components, of VTS-V.I.P., 1–4, 2–3
offline chip card processing, 9–30 configuration, test, 4–8
configuring

15 Mar 2013 Visa Confidential Index–1


Visa Test System – V.I.P.
User’s Guide

modem eliminator, 3–13 variables, 5–14


Remote Access Service (RAS), 3–7 editors
connecting bitmap, 6–12
dial-up modem, 3–10 field, 6–8
null modem, 3–6 message, 6–5
Connection Report (CR) message, 12–3 TLV, 6–15
connectivity, of Communications Handler encrypting keys, 7–8
overview, 3–2 Endpoint Session (ES) message, 12–5
contactless card reader, 9–1, 9–17, 9–19 example of
copying data from another message, 6–2 associating different cards with issuers, 5–24
CPS. See Custom Payment Service chip card processing, 9–5
creating match probability, 7–7
export file, 10–2 message processing, 7–2
new test, 4–3 test configuration setting, 4–8
new variables group, 5–13 using Log Viewer filters, 8–2
user-defined variable, 5–19 using variables, 5–16
Currency Precision Service, 4–10, 4–15 executing a test, 7–4
cursor place indicator, 1–2, 6–9 exporting
Custom Payment Service (CPS) messages to a Word document, 8–3
test configuration setting, 4–10, 4–15 raw messages to a Word document, 8–7
transactions, 1–5 test cases to a Word document, 4–7
test files, 10–2
D variables to a Word document, 5–19
Data Encryption Standard (DES), 7–8, 9–4
default variables, 5–4 F
delay fatal messages, 8–1
inserting in message, 4–20 features, 1–2
deleting field 118, 4–11, 4–16
Log Viewer messages, 8–10 field 55, 4–10, 4–15
messages, 6–10 field 59, 4–10, 4–15
Raw Message Viewer messages, 8–10 field 62, 4–10, 4–16
user-defined variable, 5–23 Field Editor
variables group, 5–18 populating fields, 6–2
DES. See Data Encryption Standard using, 6–8
description of test (test properties), 4–5 field properties
designating a variables group description of, 6–4
for the entire test, 4–5 match, 6–5
for the test case, 5–24 omit, 6–5
dial-up modem, connecting, 3–10 validate, 6–5
directories, viewing, 2–10, 2–12 filters, setting for Log Viewer, 8–2
DKE. See Dynamic Key Exchange Service Full Authorization Service, 4–11, 4–16
downloading
chip card reader driver, 9–12 to 9–13
H
Dynamic Key Exchange (DKE) Service, 7–9 Heart Beat message, 12–5
Help
E Desk Support, 1–13
editing online, 2–14
a field, 6–8 hexadecimal format
a message, 6–5 editing, 6–2
test properties, 4–5 viewing, 6–14
user-defined variables, 5–21

Index–2 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P.
User’s Guide

I M
importing a test, 10–3 magstripe card reader, 9–1, 9–17, 9–19
Incoming Message dialog box, 8–5 main
informational messages, 8–2 toolbar, 2–6
inserting a message delay, 4–20 window display, 2–5
installing match probability, 7–7
chip card reader software, 9–12 matching fields, 6–5
prerequisites, 2–1 Matching on a Valid Value, 6–5
VTS-V.I.P., 2–4 Message Editor
Intra-Country Data (field 118), 4–16 populating fields, 6–2
invalid values, 8–5 using, 6–5
ISO messages, 8–2 message format
issuer authentication, 9–4 hexadecimal, 6–14
issuer scripts, 9–5 other, 1–3
test configuration setting, 4–11, 4–16
K Message Type Indicator (MTI), 4–3
keys messages
description of, 7–8 Connection Report (CR), 12–3
setting, 7–11 deleting, 6–10
Knowledgebase deleting from Log Viewer, 8–10
description of, 2–3, 4–3 deleting from Raw Message Viewer, 8–10
display, 2–5, 4–3 editing, 6–5
Endpoint Session (ES), 12–5
L
Heart Beat, 12–5
limitations inserting a delay, 4–20
of VTS-V.I.P., 1–13 overview, 8–1
literal data, 6–2 printing, 6–10
Local Loopback mode printing from Log Viewer, 8–10
changing, 12–5 printing from Raw Message Viewer, 8–10
defined, 1–9, 12–2 processing order, 7–1
log comparison, automated, 11–1 saving as a Word document, 8–3
Log Server icon, 2–5 sources, 8–2
Log Viewer Time Broadcast (TB), 12–5
deleting messages, 8–10 Time Query (TQ), 12–5
displaying invalid values, 8–5 values for outgoing, 6–3
printing, 8–10 Microsoft Smart Card Manager components, verifying,
setting filters, 8–2 9–13, 9–16
toolbar, 8–2 modem
using, 8–2 dial-up, 3–10
viewing bitmap, 8–6 null, 3–6
logging on to VisaNet Certification Management Service modem eliminator
(VCMS), 12–8 configuring, 3–13
loopback mode recommended settings, 3–14
changing, 12–5 sample settings, 3–14
defined, 1–9, 12–2 modifying
none, 1–10, 12–2 messages, 6–5
user-defined variables, 5–21
variables, 5–14
multicurrency processing, 1–13
Multicurrency Service, 4–11, 4–16

15 Mar 2013 Visa Confidential Index–3


Visa Test System – V.I.P.
User’s Guide

N text execution, 7–3


working keys, 7–11
name of case, changing, 4–7
viewing
National Net Settlement Service, 4–11, 4–16
directories, 2–10, 2–12
navigating VTS-V.I.P., 2–5
internal message template IDs, 2–11
Network ID, 4–12, 4–17
signons, 2–11
none loopback mode, 1–10, 12–2
VTS-V.I.P. version, 2–9
null modem, connecting, 3–6
printing
O a variables group, 5–19
from Log Viewer, 8–10
offline
from Raw Message Viewer, 8–10
chip card processing, 9–28
messages, 6–10
testing with direct connection, 1–5
processing order of messages, 7–1
testing with VAP, 1–8
properties
omitting fields, 6–5
case, 5–25
online
test, 4–6
certification testing, 1–11
protocols
chip card processing, 9–31
choosing, 2–1
Help features, 2–14
for VCMS, 12–2
testing with VCMS, 1–9
TCP/IP direct, 3–5
opening a variables group, 5–11
TCP/IP LAN, 3–3
Outgoing Message dialog box, 8–5
TCP/IP modem, 3–10
overview
TCP/IP, overview, 3–3
of chip card processing, 9–4
of Log Viewer messages, 8–1 R
of match probability, 7–7
RAS. See Remote Access Service
of raw messages, 8–7
Raw Message Viewer
of TCP/IP communications protocols, 3–3
deleting messages, 8–10
of test configuration, 4–8
printing, 8–10
of variables, 5–2
saving messages as a Word document, 8–7
of working keys, 7–8
using, 8–7
P Remote Access Service (RAS)
configuring, 3–7
parser messages, 8–2
setting up phone book, 3–8
pausing test execution, 1–2, 7–2, 7–4
requirements, 2–2
PDOL Related Data, 4–17
resume running a test, 1–2, 7–2, 7–4
PIN processing, 7–10
running a test, 7–4
populating with a variable, 6–3
population method S
from other message, 6–2
saving as a Word document
from variable, 6–3
messages, 8–3
hexadecimal format, 6–2
raw messages, 8–7
literal, 6–2
test cases, 4–7
on subfield level, 6–4
variables group, 5–19
System Generated, 6–3
selecting a default variables group, 5–16
types, 6–2
services
Valid Value, 6–3
Address Verification Service (AVS), 4–9, 4–14
preferences
Card Verification Value (CVV) Service, 4–10, 4–15
setting
Currency Precision Service, 4–10, 4–15
for VCMS logon, 12–6
Custom Payment Service (CPS), 4–15

Index–4 Visa Confidential 15 Mar 2013


Visa Test System – V.I.P.
User’s Guide

Dynamic Key Exchange (DKE) Service, 7–9 saving as a Word document, 4–7
Full Authorization Service, 4–11, 4–16 setting preferences, 7–3
Multicurrency Service, 4–11, 4–16 structure, 4–1
National Net Settlement Service, 4–11, 4–16 using a user-defined variable, 5–23
special account numbers, 4–11, 4–17 validation code, 1–5
VisaNet Certification Management Service (VCMS), Visa-supplied, 4–7
1–1, 12–1 test configuration
setting 3rd Bitmap Expanded, 4–9
default variables group, 5–16 3rd Bitmap Fields, 4–9
Log Viewer filters, 8–2 Address Verification Service (AVS), 4–9
match probability, 7–7 bypass VCMS stations, 4–9
RAS phone book, 3–8 Card Verification Value (CVV) Service, 4–10
test execution preferences, 7–3 changing, 4–19
variables group for a test case, 5–24 Currency Precision Service, 4–10
variables group for an entire test, 4–5 Custom Payment Service (CPS), 4–10
VCMS logon preferences, 12–6 description of, 4–8
working keys, 7–11 field 118, 4–11
signons, viewing, 2–11 field 55, 4–10
sorting columns in Variables Manager, 5–2 field 59, 4–10
sources of messages, 8–2 field 62, 4–10
special account numbers, 4–11, 4–17 Full Authorization Service, 4–11
starting VTS-V.I.P., 2–4 message format setting, 4–11
station pairing, 12–4 Multicurrency Service, 4–11
steps to using VTS-V.I.P., 2–13 National Net Settlement Service, 4–11
subfields Network ID, 4–12
editing, 6–4 special account numbers, 4–11
support, for VTS-V.I.P., 1–13 Test Execution dialog box, 7–5
supported chip card readers, 9–2 Test Properties dialog box
system adding a test description, 4–6
changes, 2–4 setting match probability, 7–7
components, 1–4, 2–3 test properties, editing, 4–5
messages, 8–2 testing
requirements, 2–2 basic steps, 2–13
System Generated, 6–3 environments, 1–1
offline, with direct connection, 1–5
T
offline, with VAP, 1–8
TCP/IP online certification, 1–11
direct protocols, 3–5 online, with VCMS, 1–9 to 12–2
LAN protocols, 3–3 Time Broadcast (TB) message, 12–5
modem protocols, 3–10 Time Query (TQ) message, 12–5
protocols, overview, 3–3 TLV Editor, 6–15
test toolbar
case, adding, 4–7 in main window, 2–6
creating, 4–3 Log Viewer, 8–2
description, adding, 4–5 Variables Manager, 5–11
export file, 10–2 Transaction ID, 1–5
import file, 10–3
processing order of messages, 7–1
resume running, 1–2, 7–2, 7–4
running, 7–4

15 Mar 2013 Visa Confidential Index–5


Visa Test System – V.I.P.
User’s Guide

U VTS-V.I.P. version, 2–9


Visa Smart Debit/Visa Smart Credit processing, 9–1
uninstalling VTS-V.I.P., 2–16
VisaNet Access Point (VAP), offline testing, 1–8
user messages, 8–2
VisaNet Certification Management Service (VCMS)
using
bypass VCMS stations test configuration setting,
Bitmap Editor, 6–12 4–14
Log Viewer, 8–2 description of, 1–1, 12–1
Raw Message Viewer, 8–7 Local Loopback mode, 1–9, 12–2
Visa-supplied tests, 4–7 logging on to, 12–8
V none loopback mode, 1–10, 12–2
online testing, 1–9
Valid Value, 6–3
testing protocols, 12–2
validating fields, 6–5
VisaNet Loopback mode, 1–10, 12–2
validations, VTS-V.I.P. performs, 1–13
VisaNet Integrated Payment (V.I.P) System
VAP. See VisaNet Access Point
description of, 1–1
variables
working with VTS-V.I.P., 1–5
associating card and issuer groups, 5–17
VisaNet Loopback mode
creating a new group, 5–13
changing, 12–5
default values, 5–4
defined, 1–10, 12–2
deleting a group, 5–18
diagram of, 12–1
designating for the entire test, 4–5
Visa-supplied test, using, 4–7
designating for the test case, 5–24
VSDC. See Visa Smart Debit/Visa Smart Credit
editing, 5–14
VTS2000
opening a group, 5–11
description of, 1–2
overview, 5–2
VTS-V.I.P.
populating with, 6–3
features, 1–2
printing, 5–19
installing, 2–4
saving as a Word document, 5–19
Log Server icon, 2–5
selecting a default group, 5–16
navigating, 2–5
user-defined
requirements, 2–2
creating, 5–19
starting, 2–4
definition of, 5–10
steps to using, 2–13
deleting, 5–23
support, 1–13
editing, 5–21
system components, 1–4, 2–3
using in a test, 5–23
test environments, 1–5
Variables Manager
test structure, 4–1
sorting columns, 5–2
toolbar, 2–6
toolbar, 5–11
VCMS. See VisaNet Certification Management Service W
verifying warning messages, 8–1
Microsoft Smart Card Manager components, 9–13, working keys
9–16
description of, 7–8
version, of VTS-V.I.P., 2–9
setting, 7–11
VIC. See VisaNet Interchange Center
viewing
a message in hex, 6–14
directories, 2–10, 2–12
internal message template IDs, 2–11
messages, 8–2
signons, 2–11

Index–6 Visa Confidential 15 Mar 2013

You might also like