Professional Documents
Culture Documents
Replacement The July 2006 MasterCard Credit Authorization Simulator replaces your
existing manual.
What is in the new This new version reflects changes effective July 2006.
version?
Please refer to:
• “Summary of Changes” for a comprehensive list of changes reflected in
this update.
• “Using this Manual” for a complete list of the contents of this manual.
Questions? If you have questions about this manual, please contact the Customer
Operations Services team or your regional help desk. Please refer to
“Using this Manual” for more contact information.
MasterCard is Please take a moment to provide us with your feedback about the material
Listening… and usefulness of the MasterCard Credit Authorization Simulator using the
following e-mail address:
publications@mastercard.com
To locate these changes online—search on the date next to the revision bar. On the Adobe Reader
toolbar, click Search. In the Search pane, type Jul 2006 and then click Search.
Updated screen shots Inserted new and updated screen shots. Entire manual
Added a warning This warning describes the adverse affects when a member Chapter 2, Chapter 4
concerning changing changes the simulator PC date and time to a future date. and Chapter 5
the PC’s date and time
Updated Network Added new Network Options and descriptions to the Chapter 3, Chapter
Options and corresponding tables. 4, and Chapter 5
descriptions
Added new BIN Table Added new BIN table options and their descriptions. Chapter 3, Chapter 4
options
Added new Acquirer Added new Acquirer Table options and their descriptions. Chapter 3, Chapter 5
Table options
Added new Added new procedures for adding an instruction to set a Chapter 4, Chapter 5
procedures future settlement date in the simulator.
Added a new chapter Appendix A describes the features available with the Appendix A
Professional version of the MasterCard Credit Authorization
Simulator.
Page 1 of 1
MasterCard Credit
Authorization
Simulator
July 2006
Copyright The information contained in this manual is proprietary and
confidential to MasterCard International Incorporated (MasterCard)
and its members.
Trademarks Trademark notices and symbols used in this manual reflect the
registration status of MasterCard trademarks in the United States.
Please consult with the Customer Operations Services team or the
MasterCard Law Department for the registration status of particular
product, program, or service names outside the United States.
1-636-722-6100
www.mastercard.com
Audience................................................................................................................. 1
Overview ................................................................................................................ 1
Times Expressed..................................................................................................... 2
Revisions ................................................................................................................. 3
Related Information................................................................................................ 3
Support ................................................................................................................... 4
Member Relations Representative ................................................................... 5
Regional Representative................................................................................... 5
Simulator Support ............................................................................................ 5
Chapter 1 Overview
Introduction .........................................................................................................1-1
Starting the MasterCard Credit Authorization Simulator..............................1-2
Simulator Modules...............................................................................................1-3
Navigator .......................................................................................................1-4
Test Preparation ............................................................................................1-5
Test Monitor ................................................................................................1-13
Test Results..................................................................................................1-15
CD-ROM Distribution....................................................................................2-6
Distribution for Upgrade Versions ...............................................................2-7
Purpose...................................................................................................................1
Audience.................................................................................................................1
Overview ................................................................................................................1
Times Expressed.....................................................................................................2
Revisions .................................................................................................................3
Related Information................................................................................................4
Support ...................................................................................................................4
Member Relations Representative ...................................................................5
Regional Representative...................................................................................6
Simulator Support ............................................................................................6
Purpose
The MasterCard Credit Authorization Simulator documents how to use the
MasterCard Credit Authorization Simulator to conduct detailed offline testing of
the member host. Members test their host to ensure correct message formats
and compliance with processing requirements defined in the Customer
Interface Specification manual and the Authorization System Manual.
Audience
MasterCard provides this manual for members and their authorized agents.
Specifically, the following personnel should find this manual useful:
• Technical support staff
• Communications personnel
• Development personnel
Overview
The following table provides an overview of this manual:
Chapter Description
Table of Contents A list of the manual’s chapters and subsections. Each
entry references a chapter and page number.
Using this Manual A description of the manual’s purpose and its contents.
1 Overview An explanation of what you need to know about the
MasterCard Credit Authorization Simulator before you
start testing.
2 Installation Instructions A description of the steps necessary for setup and
installation of the MasterCard Credit Authorization
Simulator.
3 Simulator Configuration An explanation of how to configure the MasterCard Credit
Authorization Simulator.
4 Issuer Testing An explanation of how to perform Issuer Testing using
the MasterCard Credit Authorization Simulator.
5 Acquirer Testing An explanation of how to perform Acquirer Testing using
the MasterCard Credit Authorization Simulator.
Chapter Description
Jul
A Professional A description of the features available with the 2006
Version Professional version of the MasterCard Credit
Authorization Simulator.
Excerpted Text
At times, this document may include text excerpted from another document. A
note before the repeated text always identifies the source document. In such
cases, we included the repeated text solely for the reader’s convenience. The
original text in the source document always takes legal precedence.
Language Use
The spelling of English words in this manual follows the convention used for
U.S. English as defined in Merriam-Webster’s Collegiate Dictionary.
MasterCard is incorporated in the United States and publishes in the United
States. Therefore, this publication uses U.S. English spelling and grammar
rules.
An exception to the above spelling rule concerns the spelling of proper nouns.
In this case, we use the local English spelling.
Times Expressed
MasterCard is a global company with locations in many time zones. The
MasterCard operations and business centers are in the United States. The
operations center is in St. Louis, Missouri, and the business center is in
Purchase, New York.
Revisions
MasterCard periodically will issue revisions to this document as we implement
enhancements and changes, or as corrections are required.
Related Information
The following documents and resources provide information related to the
subjects discussed in this manual. For descriptions of these documents, please
refer to the List of Manuals in the Member Publications product on MasterCard
2
OnLine®.
• Authorization System Manual
• Customer Interface Specification
• Data Communications Manual
Members that use the Cirrus® service and logo or that process online debit
transactions should refer to the debit processing manuals recommended by the
Customer Operations Services team.
For definitions of key terms used in this document, please refer to the
MasterCard Dictionary on the Member Publications home page (on
MasterCard OnLine® and the MasterCard Electronic Library CD-ROM).
Support
Please address your questions to the Customer Operations Services team as
follows:
Fax: 1-636-722-7192
Asia/Pacific:
Japan/Guam helpdesk.tokyo@mastercard.com
Korea korea_helpdesk@mastercard.com
Europe css@mastercard.com
For the name of your U.S. Member Relations representative, contact your local
Member Relations office:
Atlanta 1-678-459-9000
Chicago 1-847-375-4000
Purchase 1-914-249-2000
San Francisco 1-925-866-7700
Regional Representative
The regional representatives work out of the regional offices. Their role is to
serve as intermediaries between the members and other departments in
MasterCard. Members can inquire and receive responses in their own
languages and during their offices’ hours of operation.
For the name of the location of the regional office serving your area, call the
Customer Operations Services team at:
Simulator Support
For MasterCard Credit Authorization Simulator support, contact your Simulator
Support Specialist via e-mail:
Introduction .........................................................................................................1-1
Starting the MasterCard Credit Authorization Simulator..............................1-2
Simulator Modules...............................................................................................1-3
Navigator .......................................................................................................1-4
Setting the Test Mode .............................................................................1-5
Test Preparation ............................................................................................1-5
Transaction File Pane (Issuer Testing)...................................................1-6
Profiles Pane ...........................................................................................1-7
Transaction Profiles Pane .................................................................1-7
Card Profiles Pane ............................................................................1-8
Merchant Profiles Pane.....................................................................1-9
Data Elements Pane................................................................................1-9
Subelements Pane.................................................................................1-10
Test Preparation Toolbar ......................................................................1-10
Network Response Profile Pane...........................................................1-12
Issuer Response Profile Pane (Acquirer Testing) ................................1-12
Test Monitor ................................................................................................1-13
Transaction Navigation .........................................................................1-14
Test Monitor Toolbar ............................................................................1-15
Test Results..................................................................................................1-15
Table View ............................................................................................1-16
Log with Parsed Message Detail...........................................................1-17
Log with the Key Data..........................................................................1-18
Test Results Toolbar .............................................................................1-18
Introduction
The MasterCard Credit Authorization Simulator provides members the ability to
conduct detailed offline testing. The simulator software is a 32-bit, Microsoft®
Windows application that runs on a PC with Microsoft® Windows® 2000 with
Service Pack 3 or higher, or Microsoft® Windows® XP Professional with Service
Pack 1 or higher. Members must install the simulator application software on
a Pentium III 1GHz or compatible PC. Members establish the connection
between the simulator PC and their host using a member provided network
interface card (NIC) for TCP/IP connectivity. The resulting interface simulates
the actual interface between the member host and the MasterCard interface
processor (MIP).
The simulator provides virtually all the testing capabilities that are available
with online testing. With the simulator, members can conduct extensive
preparations for online testing in an offline environment. By performing
simulator testing, members can replicate the tests and procedures for
scheduled online testing. This procedure will minimize the time required to
perform online testing.
Authorization Request/0100
Authorization Request/0100
Note Members cannot conduct IPS Host Testing and APS Host Testing simultaneously.
Step Action
1. On the PC desktop, double-click the MasterCard Simulators folder icon to
open the folder. You can also use the Start button to access the simulator.
Step Action
2. Double-click the MasterCard Credit Authorization Simulator icon to launch the
application.
Jul
2006
Note The appearance of the desktop folder is dependent on the selected Windows
display properties.
Simulator Modules
The MasterCard Credit Authorization Simulator consists of the following
modules:
• Navigator
A navigational pane that allows access of all the simulator modules from
one central location. From here members:
− Set the testing mode
− Access configuration parameters
− Access main simulator modules
− Access documentation
− Access System Administration
− View archived test logs
• Test Preparation
From here, members may create and/or modify user profiles, user response
profiles, and transaction files.
• Test Monitor
Members run simulator testing of transaction files within this module.
• Test Results
This module allows members to view and analyze test results and manage
the test log.
Navigator
The simulator’s main window displays the Navigator pane. From here
members may navigate to all the main modules of the simulator.
The Navigator pane is organized using tabs and corresponding icons allowing
members to navigate quickly and easily to the following:
• Simulator modules
• Information (related documentation)
• System administration
• Simulator Add-Ins
Jul
2006
Step Action
1. Double-click the MasterCard Credit Authorization Simulator icon to launch the
simulator application.
2. From the Navigator pane, select the Testing tab.
3. Select a Test Mode from the drop-down list.
Test Preparation
The Test Preparation window is comprised of two individual panes; the
Transaction File pane and the Profile pane (Figure 1.4). From the Test
Preparation window members may:
Jul
2006
Jul
2006
Profiles Pane
Profiles are building blocks used by the simulator to create transaction
messages. A transaction message is composed of different fields and tags
which can be specified within a profile type. The Test Preparation module
uses the profiles as a reference base when creating a transaction message.
The Profiles pane, located in the lower half of the Test Preparation window
provides a work area for displaying and working with the Transaction, Card,
and Merchant Profiles.
Members may use the standard Microsoft function of click and drag or double-
click a profile to move the Transaction Profiles into the Transaction File Pane
to quickly create a transaction file.
The Card Profiles pane contains a pre-defined Reference Card Profile category
that is organized by Standard or Chip cards, product type, and U.S. or Non-
U.S. region (Figure 1.7).
Members may create and modify Card Profiles in the User Card Profile
category. The Transaction Profiles reference the Card Profiles to create
transaction messages.
Jul
2006
Subelements Pane
Jul
The Subelements pane lists and displays all ISO-specified subelements for data 2006
elements 35, 43, 45, 48, 55, 112, 120 and 124 (Figure 1.10). Members may use
the standard Microsoft function of click and drag to move subelements from
this pane onto a transaction in the Transaction File pane thereby adding or
overwriting existing subelements for the corresponding data elements with a
specified value.
Jul
2006
Table 1.1 describes the Test Preparation Toolbar buttons and their function.
Button Description
Jul
New transaction file. 2006
Adds an instruction.
Button Description
Moves to the last selected transaction.
Jul
2006
Jul
2006
Test Monitor
The Test Monitor window is comprised of two individual panes, the
Transaction File pane, and the Test Activity Log pane (Figure 1.13).
These panes provide a workspace to execute test sessions and monitor the
testing activity. The Transaction File pane displays the active transaction file,
while the lower pane (Test Activity Log pane) displays the test session activity.
Profile tabs allow members to access the different profile “hits” information.
Transaction Navigation
Members have the ability to navigate from a transaction within the two panes
of the Test Monitor to the exact transaction in either the Test Preparation or
Test Results module. This navigation ability is only allowed from the Test
Monitor module outward to the Test Preparation or Test Results module.
Members may not use the double-clicking transaction navigation to return to
the Test Monitor from the other modules.
Jul
2006
Table 1.2 describes the Test Monitor Toolbar buttons and their function.
Button Description
Opens an existing transaction file.
Test Results
The Test Results window displays the Sequential and Historical logs for the
simulator testing sessions. From here members may view the simulator log for
test result analysis. Members also manage the simulator log from this window
controlling the log data base organization.
The Test Results window provides the following views to facilitate with the test
results analysis:
• Table View
• Log with Parsed Message Detail (default)
• Log with the Key Data
Table View
The Table view (Figure 1.14) displays the test results information in dynamic
columns that change with the selection of different records in the log. For
example, when an “information” record is selected, the columns adjust
accordingly, displaying the record name, a time stamp, and a description.
However, when a “message” record is selected then the columns change to
display the record name, a time stamp, and specific data elements.
Jul
2006
Table 1.3 describes the Test Results Toolbar buttons and their function.
Button Description
Shows the log in table view.
Requirements.......................................................................................................2-1
Configuration Requirements .........................................................................2-1
Requirements
The MasterCard Credit Authorization Simulator is an integral part of the
MasterCard Test Program. The MasterCard Credit Authorization Simulator is
mandatory for all members and processors that connect directly to the
Banknet® telecommunications network.
Configuration Requirements
To install the MasterCard Credit Authorization Simulator, the member or
processor must provide the hardware and software identified in Table 2.1
Item Description
Computer/Processor • Pentium® III 1 GHz CPU or compatible system
minimum
• Pentium® 4 2.0 GHz recommended
Operating System Windows 2000 Professional with service pack 3 or
higher, or Windows XP Professional with service pack 1
or higher
Memory • 256 MB minimum
• 512 MB recommended
Hard Disk Available hard disk space:
• 500 MB minimum
• 1.0 GB recommended
Display Super VGA (1024 X 768) with 65,536 colors or higher-
resolution display adapter
Monitor 17 inch or larger color display
Drive CD-ROM drive or access to CD-ROM over a computer
network
USB Port Active Universal Series Bus (USB) port or a USB hub
Peripheral/Miscellaneous Microsoft mouse or compatible pointing device
Table 2.2 defines the MasterCard supplied hardware and software. Table 2.3
lists the software and documentation distributed via MasterCard OnLine®
Browser Edition.
Item Description
MasterINQ software A baseline ISO 8583 message generation
engine on which the MasterCard Credit
Authorization Simulator is installed as an
add-on to the baseline platform.
MasterCard Credit Authorization Simulator Microsoft® Windows 2000® or Windows
software XP Professional® compatible 32–bit
applications
MasterCard Credit Authorization Simulator Documentation provided in PDF format.
manuala
a MasterCard OnLine Browser Edition is the distribution method for all updates and revisions.
Follow these steps to download the MasterINQ Base Platform application file
from MasterCard OnLine Browser Edition:
Step Action
1. Start a MasterCard OnLine Browser Edition session.
2. From the Featured Products & Services pane, select MasterCard Simulator
Suite.
4. Locate and click the MasterINQ Base Platform Install File link.
Step Action
5. Click Save in the File Download dialog box.
Step Action
1. Start a MasterCard OnLine Browser Edition session.
2. From the Featured Products & Services pane, select MasterCard Simulator
Suite.
Fax: 1-636-722-7994
E-mail: mcps_support@mastercard.com
The Online Solutions and Services Help Desk is available 24 hours a day,
seven days a week.
CD-ROM Distribution
As an alternate method for obtaining the MasterCard Credit Authorization
Simulator, members can request distribution of the application on a CD-ROM.
However, members located outside the U.S. region can incur greater import or
customs duties. When the MasterCard Credit Authorization Simulator
application software is included on the distribution CD-ROM, the declared
value of the shipment will be USD 9,500.00. If the MasterCard Credit
Authorization Simulator application software is not provided on the CD-ROM,
the declared value of the shipment is less than USD 600.00.
Step Action
1. If necessary, contact your MasterCard Regional Office Representative for
MasterCard OnLine access.
2. Initiate the dial or proxy process following the browser software
manufacturer’s instructions.
3. Start the selected browser and go to the MasterCard OnLine homepage
(http://www.mastercardonline.com).
4. From Featured Products & Services, select the MasterCard Simulator Suite link.
5. From MasterCard Credit Authorization Simulator, select Order/Upgrade.
6. Complete the required information and submit the request.
CD-ROM Distribution
As an alternate method for obtaining the current MasterCard Credit
Authorization Simulator upgrade version, members can request distribution of
the application on a CD-ROM using the following procedures:
Step Action
1. If necessary, contact your MasterCard Regional Office Representative for
MasterCard OnLine access.
2. Initiate the dial or proxy process following the browser software
manufacturer’s instructions.
3. Start the selected browser and go to the MasterCard OnLine homepage
(http://www.mastercardonline.com).
4. From Featured Products & Services, select the MasterCard Simulator Suite link.
5. From MasterCard Credit Authorization Simulator, select Order/Upgrade.
6. Complete the required information and submit the request.
MasterCard will bill members USD 395.00 plus shipping and handling, for the
current MasterCard Credit Authorization Simulator version application on
CD-ROM. For members located outside the U.S. region, the declared value of
the upgrade CD-ROM shipment will be USD 395.00.
Software Installation
You must have administrative privileges to install the MasterCard Credit
Authorization Simulator and associated software. The member’s Information
Services/Information Technology (IS/IT) department or representative should
review all procedures before installing the required MasterCard Credit
Authorization Simulator hardware and software.
Step Action
1. Place the MasterCard Credit Authorization Simulator CD in the CD-ROM drive.
2. Click the Start button, and select Run.
3. In the Open box, type C:\*\Acrobat\Setup.exe. (* equals the directory path
the member selected when downloading the file from MasterCard Online.)
(If necessary, modify the path)
4. Click OK. Allow the Install Wizard to guide you through the installation
process.
Note If you did not receive a MasterCard Credit Authorization Simulator CD, you may
download the Adobe Acrobat Reader software from http://www.adobe.com/.
Step Action
1. Click the Windows Desktop Start button, and select Run.
2. Click Browse to locate the MasterCard Credit Authorization Simulator
executable file (crsimxx_x.exe).
• Select C:\* 1\crsim_sim\crsimxx_x.exe 2 if you downloaded the MasterCard
Credit Authorization Simulator applications using MasterCard OnLine®.
(If necessary, modify the path)
• Select D:\Simulator\crsimxx_x.exe if you received the MasterCard Credit
Authorization Simulator applications on CD-ROM. (If necessary, modify
the path)
3. Select crsimxx_x.exe and click OK to begin the MasterCard Credit Authorization
Simulator installation program. The system briefly displays the progress
indicator.
4. Click Next to continue.
5. Read the MasterCard Test Simulator Software License Agreement carefully, and
click the I accept the terms of the license agreement radio button to accept the
terms of the agreement and click Next.
1 * equals the directory selected by the member when downloading the file from MasterCard
Online.
2 xx_x equals the current version simulator.
Step Action
6. Click the Anyone who uses this computer (all users) radio button and then click
Next.
Step Action
11. Read the MasterINQ Software License Agreement carefully, and click the I
accept the terms of the license agreement radio button to accept the terms of
the agreement and then click Next.
12. Click Next.
13. Click Install to begin the installation of the MasterINQ base platform files.
14. Click Finish.
15. Click OK in the message indicating the installation of the USB Hardware
Token Device Driver.
16. Click Next.
17. Read the Rainbow Sentinel Driver Software License Agreement carefully, and
click the I accept the terms of the license agreement radio button and click
Next.
20. Click Install to begin the installation of the USB Hardware Token Device
Driver.
21. Click Finish.
22. Click Finish when setup is complete.
23. Continue with Hardware Installation.
Hardware Installation
The member’s Information Services/Information Technology (IS/IT)
department or representative should review all procedures before installing the
required MasterCard Credit Authorization Simulator hardware.
Jul
Warning Members should not change the simulator’s PC date to a future date as this will 2006
cause the simulator’s security hardware token license to update the token
access date. As a result, when the PC date is reset to the current date the
license date becomes expired. An expired license date in the license file causes
the security token to deny member access to the simulator.
In some instances, if the PC date is manually changed to a distant future date, a
new hardware token may be required to operate the simulator. A hardware
token replacement fee will apply.
See Chapters 4 and 5 for details about adding an instruction to test with a
future settlement date.
E-mail: credit.sim@mastercard.com
This section describes the upgrade installation steps for the MasterCard Credit
Authorization Simulator.
Step Action
1. Click the Windows Desktop Start button, and select Run.
2. Click Browse to locate the MasterCard Credit Authorization Simulator
executable file (crsimxx_x.exe).
• Select C:\* 7\crsim_sim\crsimxx_x.exe 8 if you downloaded the MasterCard
Credit Authorization Simulator applications using MasterCard OnLine®.
(If necessary, modify the path)
• Select D:\Simulator\crsimxx_x.exe if you received the MasterCard Credit
Authorization Simulator applications on CD-ROM. (If necessary, modify
the path.)
3. Select crsimxx_x.exe, and click OK to begin the MasterCard Credit
Authorization Simulator installation program. The system briefly displays the
progress indicator.
4. Click Next to continue.
5. Read the MasterCard Test Simulator Software License Agreement carefully, and
click the I accept the terms of the license agreement radio button to accept the
terms of the agreement and click Next.
6. Click Install to start copying files.
7. Click OK in the message indicating the installation of the USB Hardware
Token Device Driver.
8. Click Next.
7 * equals the directory selected by the member when downloading the file from MasterCard
Online.
8 xx_x equals the current version simulator.
Step Action
9. Click the Repair radio button.
Configuration Options.........................................................................................3-1
Accessing Configuration Options .................................................................3-1
Test Mode Options .................................................................................3-3
Network Options ..............................................................................3-3
Timers ...............................................................................................3-5
Modifying Timer Values ...................................................................3-5
AID - FID ..........................................................................................3-6
Currency Rates ........................................................................................3-7
Adding a Currency Rate ...................................................................3-7
Modifying a Currency Rate...............................................................3-9
Deleting a Currency Rate .................................................................3-9
BIN Table ................................................................................................3-9
Crypto Keys...........................................................................................3-13
MChip Key Sets...............................................................................3-14
Adding an MChip Key Set........................................................3-15
Modifying Key Values in “MChipKeySet_User” ......................3-15
Modifying Parameters in “MChipKeySet_User”.......................3-17
Setting a M/Chip Key Set as the Default MChip Key Set .......3-18
Selecting MChip Key Logging..................................................3-18
PIN Key Sets ...................................................................................3-19
Key Exchange Process .............................................................3-19
Triple DES Encryption..............................................................3-20
Creating PIN Key Sets (User)...................................................3-21
Modifying PIN Key Sets (User) ................................................3-22
HMAC Keys.....................................................................................3-24
Creating HMAC Keys (User) ....................................................3-24
Modifying HMAC Keys (User) .................................................3-25
Deleting HMAC Keys (User) ....................................................3-26
CVC Keys ........................................................................................3-26
Creating a CVC Key Set (User) ................................................3-26
Modifying CVC Keys (User).....................................................3-27
Deleting CVC Keys (User)........................................................3-29
CVC3 Keys ......................................................................................3-29
Configuration Options
Members may customize the MasterCard Credit Authorization Simulator to their
specific testing needs by configuring the various options described in this
section before performing advanced testing. The MasterCard Credit
Authorization Simulator saves options configured through the Set Options
function and references these defined options for simulator processing.
Options are dynamic and may be changed during testing.
Testing Mode
Options
Use the following procedure to select a testing mode and to access the
simulator configuration options:
Step Action
1. Double-click the MasterCard Credit Authorization Simulator desktop icon.
2. From the Navigator pane, select a testing mode from the drop-down list.
Network Options
Step Action
1. From the Options dialog box, select the Test Mode Options tab. Jul
2006
Option Description
Treat Data Integrity Edits as Performs data integrity edit and if error found, stops
Production Format Errors 0100 message processing and sends a 0110 message
with a format error.
0800 Group Sign-On Selects Sign-on selects the active PIN key set as configured
PIN Key Set in the PIN Key set option.
Network Always Forward Ignores all errors and continues processing of 0100
Request Messages message.
Network Always Forward Ignores all errors and continues processing of 0110
Response Messages message.
Always Return DE 48 to When selected, the simulator always returns DE 48
Acquirer to the acquirer.
Show Information Messages When this option is selected, each unannounced DE
for Unannounced DE 48 48 subelement is identified in the history log file
Subelements with a message “Unannounced DE 48 subelements
are present and are being passed through the
network.”
Include Test Description into When this option is selected, the simulator writes the
Test Logs transaction description in the history log providing
an easier means of locating a specific transaction in
either the Test Monitor or Test Results component.
Issuer supports DE 48/SE 58 This option indicates that the issuer does or does not
receive DE 48, subelement 58 in 0100 and 0400
messages.
Issuer supports Refund This option indicates that the issuer can or cannot
transaction process refund transactions where the value in DE 3,
subfield 1 is equal to “20” in the 0100/110,
0120/0130, and 0400/0410 messages.
Issuer supports Balance This option indicates whether the issuer can or
Inquiry transaction cannot receive ATM Balance Inquiry transactions
where the value in DE 3, subfield 1 is equal to “30”
and DE 48, position 1 (TCC) is equal to “Z” in the
0100/0400 messages.
Acquirer supports DE 123 This option indicates that the issuer can or cannot
receive DE 123.
Acquirer supports MSI This option indicates that the acquirer can or cannot
(Maestro) acquire Maestro (MSI) branded transactions.
Acquirer supports CIR (Cirrus) This option indicates that the acquirer can or cannot
acquire Cirrus (CIR) branded transactions.
Timers
Timer values define the amount of time the simulator will wait for a response
from the host computer before the transaction “times out.” The system
automatically assigns each timer to a specific class of messages. The default
configuration has timer values that mirror production needs. The member may
adjust the timer values within the Timers option as needed.
Step Action
1. From the Navigator pane, select the testing mode.
2. Click the Set Options icon to display the Options dialog box.
3. Select the Test Mode Options tab.
4. Expand the Data group by clicking the corresponding plus sign.
Jul
2006
Step Action
6. Double-click a timer value to display the Edit Timer Value dialog box.
7. Type over the existing value with a new value and click OK
8. Repeat steps 5 and 6 for each timer value as needed.
9. Close the Options dialog box when finished.
AID - FID
The AID - FID data options allow the member to set the DE 32—Acquiring
Institution ID Code and DE 33—Forwarding Institution ID Code default values
for simulator processing.
Use the following procedure to set the default value for DE 32 and DE 33:
Step Action
1. From the Navigator pane, select the testing mode.
2. Click the Set Options icon to display the Options dialog box.
3. Select the Test Mode Options tab.
4. Expand the Network/Data group by clicking the corresponding plus sign.
Jul
2006
Step Action
5. Double-click a value to display the Edit Value dialog box.
6. Highlight and type over the value with a different value as needed.
7. Click OK.
8. Repeat steps 5 through 7 for each Data field as needed.
9. Close the Options dialog box when finished.
Currency Rates
The MasterCard Credit Authorization Simulator provides a pre-populated
currency rates table in the Options dialog box. Members typically will not
need to modify the table. However, members may add additional currency
rates or modify existing currency rate entries in the currency table as needed.
Use the following procedure to add a currency rate to the Currency Rates
table:
Step Action
1. From the Navigator pane, select a testing mode.
2. Click the Set Options icon to display the Options dialog box.
Step Action
3. Select the Currency Rates tab to display the Currency Rates table.
4.
Click the Add a new rate button.
5. In the Add Rate dialog box, enter the appropriate values in the corresponding
fields.
Members may sort and move data in the Currency Table using the following
navigational buttons:
Use the following procedure to modify a currency rate in the Currency Rates
table:
Step Action
1. From the Navigator pane, select a testing mode.
2. Click the Set Options icon to display the Options dialog box.
3. Select the Currency Rates tab to display the Currency Rates table.
4. Double-click an existing rate to display the Edit Rate dialog box.
5. Enter the appropriate value in the corresponding field as needed.
6. Click Change when finished.
Step Action
1. From the Navigator pane, select Set Options.
2. Select the Currency Rates tab.
3. Click a currency to highlight the entire row.
4. Click the Delete button. Answer appropriately to a confirmation message
validating the delete action.
BIN Table
Within the Options/BIN Table pane, issuers may enter a BIN range and
indicate the following for the specified BIN account range:
• Minimum and Maximum Account Range
Indicates the minimum and maximum account ranges.
• Issuer Currency Code
Jul
The value entered does not affect any AMCC processing as of the 06.2 2006
release of the simulator. This field has been replaced by the Cardholder
Billing Currency Code field.
• Financial Network Code
The value entered here becomes the default value for Network Data
(DE 63) for the specified account range only.
• M/Chip On Behalf
When selected, the simulator performs the following M/Chip services for
the issuer.
Note When selecting M/Chip on Behalf of Issuer, option 03 – Dynamic M/Chip Stand-
In, issuers must select the Network performs Stand-In Processing option as well
to ensure correct simulator processing.
• AAV
When selected, the simulator performs the following Accountholder
Authentication Value (AVV) Validation services for the issuer.
• PWCB Option
When selected, the SBT or PBT option together with the “Network
performs Stand-In processing” option will indicate that the simulator
performs Stand-In processing for the PIN-based (PBT) or Signature-based
(SBT) Purchase With Cash Back transactions.
Crypto Keys
From the Crypto Keys tab of the Options dialog box, members may define the
following cryptographic keys to be used during simulator processing:
• MChip Key Sets
• PIN Key Sets
• HMAC Key Sets
• CVC Key Sets
• CVC3 Key Sets
Note All default key sets, for any crypto key category, are displayed in red text. This
allows you to quickly identify the active default key sets.
Within the MasterCard Credit Authorization Simulator, members can input the
Master Keys required for various algorithms used in M/Chip data processing by
entering the appropriate values in the MChip Key Sets. The keys are
represented in Triple DES – double key format. These keys are used in
calculating ICC Master and Session keys for each transaction.
Table 3.2 indicates the Simulator M/Chip Key names and their ICC Master Key
equivalent. See the M/Chip 4 Security & Key Management manual for details
concerning ICC Master Key derivation.
Within the Crypto Keys pane, the MChip Keys are defined as “Reference” and
“User.” The keys contained in the “MChipKeySet_Reference” may not be
modified by the member, as these contain the system default key values.
However, the member may copy and paste any of the groups from the
“MChipKeySet_Reference” into the “MChipKeySet_User” where the values can
be modified.
Issuing members provide their own test Master Key clear key components in
the “MChipKeySet_User” category of the Crypto Key Sets pane.
Use the following procedure to add a new MChip Key Set to the
“MChipKeySet_User” category:
Step Action
1. From the Navigator pane, select Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
3. Click on a key set in the MChipKeySet_User group.
4.
Click the Add new group button.
Use the following procedure to modify key values of a key set in the
“MChipKeySet_User” category:
Step Action
1. From the Crypto Keys pane, expand an MChip Key Set by clicking the
corresponding plus sign.
2. Double-click a key value to modify it.
Step Action
3. From the Key Data Wizard, select the number of key components by clicking
the corresponding radio button.
Members may select the “Enforce Odd Parity” option if their hardware security
module (HSM) requires odd parity.
4. Click Next.
5. In the Key Components dialog box, type a clear key component in each
component field.
Members should not use production keys in the MasterCard Credit
Authorization Simulator.
6. Click OK.
7. Repeat Steps 2 through 6 for each key as needed.
Table 3.3 describes the parameters that are available in the PARMS folder:
Table 3.3—PARMS
Parameter Description
Application Selection specifies the application version used in cryptographic
calculation/validation.
Crypto Selection specifies the data format used in cryptographic
calculation/validation.
Default Set the Group ID with the corresponding M/Chip Keys and
parameters as the default for smart card processing within the
simulator.
MIT Crypt Logging Toggles on or off the MIT Crypt Log. This log records
information about the smart card interim cryptographic
calculations.
APS Validations Toggles on or off the validation of specific acquirer
cryptographic calculations.
Step Action
1. From the Crypto Keys pane, expand an MChip Key Set by clicking the
corresponding plus sign.
2. Expand Parms by clicking the corresponding plus sign.
3. Double-click Applications or Crypto to modify as needed.
4. Select a Crypto Type by clicking the corresponding radio button.
5. Click Next.
Step Action
6. Select the Application Type and click OK.
Use the following procedure to set an MChip Key Set with the associated
MChip keys and parameters as the default for simulator M/Chip processing:
Step Action
1. From the Crypto Keys pane, expand an MChip Key Set by clicking the
corresponding plus sign.
2. Expand Parms by clicking the corresponding plus sign.
3. If the Default Value field is set to “No,” double-click the value to change the
value to “Yes.”
Note You may not toggle a selected Default Value of “Yes” back to “No.” The
Default Value will need to be changed in another M/Chip Key Set to set all
other M/Chip Key Set Default values to “No” as only one M/Chip Key Set may
be set to be the default at one time.
Members may select the creation of a text log file that records information
about the smart card interim cryptographic calculations. This text log is
located in the main simulator directory, Credit xx_x\BIN. When selected; the
simulator appends the data to the M/Chip Crypto log. The default name for
the log is “destrace.txt.”
Step Action
1. From the Crypto Keys pane, expand an M/Chip Key Set by clicking the
corresponding plus sign.
2. Expand Parms by clicking the corresponding plus sign.
3. Double-click the M/Chip Crypto Log value to select/deselect creation of an
M/Chip processing log file for that specific M/Chip Key Set.
Within the MasterCard Credit Authorization Simulator, members can control the
key encryption key (KEK) (also known as the communication key) definition
by entering the appropriate value in the PIN Key Set table located in the
Options dialog box. Members may define PIN Key sets for multiple Group
IDs.
For online testing with the MasterCard Test Facility (MTF), MasterCard and the
member exchange the clear key used to create the communication key. Each
clear key is 16 hexadecimal digits with odd parity on each pair of digits. The
communication key is created by the clear key components being “Exclusive
OR’ed” (XOR’d) together creating the communication key in its clear text
value. The clear text value indicates that the key is unencrypted.
Note The simulator automatically XORs key components that are entered by the
member, thus eliminating the need to XOR key components manually. See
Creating PIN Key Sets (User) for more information.
The key encryption key (KEK) value is used to encrypt the PIN Encryption Key
(PEK) (also known as the working key) when sent in a Network Management
Request/0800 dynamic key exchange message. MasterCard recommends that
members use the default value for the PIN Encryption Key.
Triple DES encryption helps to reduce fraud losses by making it more difficult
for criminals to decrypt cardholder information such as PINs. The Triple DES
approach uses three passes through the DES algorithm. By increasing the
number of passes through the DES algorithm and increasing the number of bits
(key size) used in encryption, the resulting data is more difficult to decipher.
Members will have the option to encrypt PIN information using the single DES
key algorithm or a triple DES key algorithm with double- or triple-length keys.
Within the MasterCard Credit Authorization Simulator, members can define the
type of encryption method by entering the appropriate value(s) in the Crypto
Keys of the Options dialog box.
As with Single DES, Triple DES uses the KEK key to encrypt the PEK key in
the Network Management Request/0800 (Class 1) key exchange message and
uses the PEK key to encrypt the ANSI PIN Block in a PIN based transaction.
MasterCard provides pre-defined Reference PIN Key Sets that act as the default
key sets. Members may not modify the Reference PIN Key Sets but may create
and modify User PIN Key Sets by following the steps below.
Use the following procedure to create a PIN Key Set in the User category:
Step Action
1. From the Navigator pane, click Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
Step Action
7. Select the DES type by clicking a corresponding radio button.
Use the following procedure to modify a PIN Key Set in the User category:
Step Action
1. From the Navigator pane, select Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
MasterCard recommends that members use the default value(s) for the PIN
Encryption Key for simulator testing.
3. Expand a PIN Key set by clicking the corresponding plus sign to display the
key parameters associated with that group.
4. Expand the KEK key parameters.
Step Action
5. Double-click a key to launch the Key Data Wizard.
9. Click OK.
10. Repeat steps 5 through 9 for each key.
HMAC Keys
Within the simulator, members may create HMAC key sets to support the
MasterCard® SecureCode™ Accountholder Authentication Value (AAV)
Verification Service.
Use the following procedure to create a HMAC Key Set in the User category:
Step Action
1. Within the Options dialog box, select the Crypto Keys tab.
2. Click any User category HMAC Key group.
3.
Click the Adds a new group button.
4. In the Add new HMAC key dialog box, enter a key identifier and description.
5. Click OK. By default the simulator creates all sixteen keys with the same key
value.
Step Action
6. Double-click any HMAC key to launch the Edit HMAC Key dialog box. From
here you may edit a range of keys or a single key.
Use the following procedure to modify HMAC Keys in the User category:
Step Action
1. Within the Options dialog box, select the Crypto Keys tab.
2. Expand any HMAC Key User category group.
3. Double-click a key to display the Edit HMAC Key dialog box.
Use the following procedure to delete a HMAC Key set in the User category:
Step Action
1. Within the Options dialog box, select the Crypto Keys tab.
2. Click any HMAC Key User category group.
3. Click Delete.
4. Answer appropriately to a confirmation message validating the delete action.
CVC Keys
The card validation code is a two-part security feature identified as CVC 1 and
CVC 2. Within the simulator, members may use the CVC Key Set feature in the
Options dialog box to calculate the CVC using the data encryption standard
(DES) method. From the Crypto Keys tab, members may create CVC keys in a
user category for use in CVC calculation within the simulator.
MasterCard provides pre-defined Reference category CVC Keys that act as the
system default key sets. Members may not modify the Reference Keys but may
create and modify User Keys by following the steps below.
Use the following procedure to create a CVC Key Set in the User category:
Step Action
1. Within the Options dialog box, select the Crypto Keys tab.
2. Click any User category CVC Key group.
3.
Click the Add group button.
4. In the Add new CVC2 key dialog box, enter a Key Index and description.
Step Action
5. Click Next.
6. Click OK.
Use the following procedure to modify a CVC Key Set in the User category:
Step Action
1. From the Navigator pane, select Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
3. Expand a CVC Key Set by clicking the corresponding plus sign to display the
key parameters associated with that group.
4. Expand the key parameters.
Step Action
5. Double-click a key to launch the Key Data Wizard.
9. Click OK.
10. Repeat steps 5 through 9 for each key.
Use the following procedure to delete a CVC Key set in the User category:
Step Action
1. From the Navigator pane, click Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
3. Expand the CVCKeySet_User group by clicking the corresponding plus sign.
4. Click a CVC Key Set group to highlight the row.
5.
Click the Delete button. Answer appropriately to a confirmation message
validating the delete action.
CVC3 Keys
MasterCard provides pre-defined Reference category CVC3 Keys that act as the
system default key sets. Members cannot modify the Reference category keys
but may create and modify User category keys by following the steps below.
Use the following procedure to create a CVC3 Key set in the User category:
Step Action
1. From the Navigator pane, select Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
Step Action
3. Click on the CVC3KeySet_User category icon.
4.
Click the Adds a new group toolbar button.
5. In the Add CVC3 Key Index dialog box, enter a Key Index and description.
6. Click OK.
7. Expand the newly created CVC3 Key Set and the corresponding IMK group.
Step Action
8. Double-click a key to launch the Key Data Wizard.
Use the following procedure to modify a CVC3 Key in the User category:
Step Action
1. From the Navigator pane, select Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
3. Expand a CVC3 Key Set by clicking the corresponding plus sign to display the
key parameters associated with that group.
4. Expand the key parameters.
5. Double-click a key to launch the Key Data Wizard.
6. Select the number of key components by clicking the corresponding radio
button.
7. In the Key Components dialog box, type the clear key components in the
component fields.
8. Click OK.
9. Repeat steps 5 through 8 for each key.
Table 3.4 describes the parameters that are available in the CVC3 PARMS
folder:
Parameter Description
CVC3 Crypto Log Toggles on or off the CVC3 Crypto Log. This log records
information about the CVC3 cryptographic calculations.
Position of PAN Indicates the position of the PAN sequence number in the
Sequence Number discretionary data of the Track 1 or Track 2 data.
Length of Indicates the length of the Track 1 or track 2 discretionary data.
Discretionary Data The DD length for Track 1 cannot exceed 24 bytes. The DD
length for Track 2 cannot exceed 13 bytes.
Length of ATC Indicates the length of the Application Transaction Counter
(ATC) in the discretionary data. When the card expiration date
is valid for 2 years or less the minimal length of the ATC is 3
digits. When the card expiration date is valid for more than 2
years, the minimal length of the ATC is 4 digits.
Position of ATC Indicates the position of the Application Transaction Counter
(ATC) in the discretionary data. The position is determined as
shown in the examples below.
Parameter Description
Length of UN Indicates the length of the unpredictable number (UN) in the
discretionary data.
Position of UN Indicates the position of the unpredictable number (UN) in the
discretionary data. The position is determined as shown in the
examples below.
Length of CVC3 Indicates the length of the CVC3 in the discretionary data.
Position of CVC3 Indicates the position of CVC3 in the discretionary data. The
position is determined as shown in the example below.
The CVC3 Parameters may be defined for both Track 1 and Track 2 data.
The CVC3 for a length of 3 in Track 1 DD is located in “20, 21, 22.” The value
“22” should be entered as the Position of CVC3.
484746454443424140393837363534333231302928272625 242322212019181716151413121110 9 8 7 6 5 4 3 2 1
PCVC3TRACK1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
The ATC for a length of 3 in Track 1 DD is located in “14, 15, 16” and the UN
for a length of 3 is located in “06, 07, 08”. The value ‘16’ should be entered as
the Position of ATC; the value “08” should be entered as the Position of UN.
484746454443424140393837363534333231302928272625242322212019181716151413121110 9 8 7 6 5 4 3 2 1
PUNATCTRACK1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 0 0 0 0 0 1 1 1 0 0 0 0 0
484746454443424140393837363534333231302928272625242322212019181716151413121110 9 8 7 6 5 4 3 2 1
PPSEQTRACK1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1
DD x x C3 C2 C1 x x x A3 A2 A1 x x x x x U3 U2 U1 x x x x nUN
The CVC3 for a length of 3 in Track 2 DD is located in “02, 03, 04.” The value
“04” should be entered as the Position of CVC3.
16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1
PCVC3TRACK2 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 0
The ATC for a length of 3 in Track 2 DD is located in “10, 11, 12” and the UN
for a length of 3 is located in “05, 06, 07”’. The value ‘12’ should be entered as
the Position of ATC; the value “07” should be entered as the Position of UN.
1615 14 13 12 11 10 9 8 7 6 5 4 3 2 1
PUNATCTRACK2 0 0 0 0 1 1 1 0 0 1 1 1 0 0 0 0
16151413121110 9 8 7 6 5 4 3 2 1
PPSEQTRACK2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
13 12 11 10 9 8 7 6 5 4 3 2 1
DD x A3 A2 A1 x x U3 U2 U1 x x x nUN
Use the following procedure to modify parameters of a CVC3 Key Set in the
“CVC3KeySet_User” category:
Step Action
1. From the Crypto Key Set pane, expand a CVC3 Key Set by clicking the
corresponding plus sign.
2. Expand Parms by clicking the corresponding plus sign.
3. Right-click either the Track 1 or Track 2 folder. The procedure is the same for
modifying either track data.
Step Action
5. Highlight and type over the values in the left-side column with the new data as
needed.
The right column displays the values in HEX format for reference only.
6. Click OK.
Members may select the creation of a text log file that records information
about the CVC3 cryptographic calculations. This text log is located in the main
simulator directory, MasterINQxxx\Bin. When selected, the simulator appends
the data to the Crypto log.
Step Action
1. From the Crypto Key Set pane, expand a CVC3 Key Set by clicking the
corresponding plus sign.
2. Expand PARMS by clicking the corresponding plus sign.
3. Double-click the CVC3 Crypto Log value to select/deselect creation of an
processing log file for that specific CVC3 Key Set.
Use the following procedure to delete a CVC3 Key set in the User category:
Step Action
1. From the Navigator pane, select Set Options.
2. In the Options dialog box, click the Crypto Keys tab.
3. Click a CVC3 Key Set to highlight the row.
4.
Click the Delete button. Answer appropriately to a confirmation message
validating the delete action.
TCP/IP
The MasterCard Credit Authorization Simulator is configured by default as a
server. When a test mode is selected, the simulator waits for a connection to
the specified Port (6034) which is the standard TCP/IP configuration found on
the MasterCard interface processor (MIP). The simulator will wait in an active
listening mode until the connection request is initiated by the host system.
For those members whose host system requires that it be the server, the
simulator may be configured as the “client.” The TCP/IP tab is available only
when the IPS or the APS Test mode is selected.
Step Action
1. Set a testing mode.
2. From the Options dialog box, select the TCP/IP tab.
Step Action
3. Click the Client radio button in the Choose connection section.
Note If the connection between the host system and the simulator is broken, the
simulator will not automatically re-connect. The member will need to select a
testing mode in the simulator to initiate the connection request.
Acquirer Table
Acquirers add their own Acquirer IDs and specific option choices in the “User”
category of the Acquirer Table. Typically this is a one time setup and once it
is completed, acquirers update the Acquirers Table only as needed.
Within the Acquirer Table dialog box, members may configure the following
options for their specific Acquirer ID(s):
• Acquirer Country Code
The value entered in this field, in conjunction with the value of the Issuer
Country Code determines the value in DE 63—Network Data, subfield 2.
• Forwarding Institution ID code DE 33 Jul
2006
When this option is set in combination with the Acquirer Receives
Settlement Amount, DE 32 (Acquirer ID) and DE 33 (Forwarding Institution
ID) will decide if the acquirer receives the settlement amounts (DE 5, DE 9,
and DE 50). If this option is not set, then the value in DE 32 determines
whether the acquirer receives DE 5, DE 9, and DE 50.
• Acquirer supports Chip Partial Grade
This option indicates if the acquirer supports Chip Partial Grade.
Similar to Full Grade authorization requests, Partial Grade acquiring
provides information to indicate to issuers that card data was read from the
smart card. However, in Partial Grade acquiring, not all the required chip
subelements are present. Refer to the M/Chip Functional Architecture for
Debit and Credit manual for additional information about Chip Partial
Grade.
• Electronic Acceptance
This option indicates the acquirer’s type of participation in MasterCard
Electronic (MCE).
Jul
• Acquirer Supports PIN Management 2006
Step Action
1. Double-click the MasterCard Simulators folder on the PC desktop.
2. Double-click the MasterCard Credit Authorization Simulator icon to launch the
application.
Step Action
3. In the Navigator pane from the Testing tab, select IPS Host Testing from the
drop-down list. The testing status indicator displays “Connecting” until the
connection to the member host completes, then the status changes to
“Connected.”
Issuers modify the “Reference” category Card Profiles with their specific card
information, and in the BIN Table, add their own account ranges in the “User”
category. Refer to Chapter 1 for details concerning “Reference” and “User”
categories. Typically this is a one time setup and once it is completed, issuers
update the Card Profiles and the BIN Table only as needed.
Step Action
1. Set the IPS Host Testing mode.
2. From the Navigator pane, click Test Preparation.
3. Click the Card Profiles tab.
4. In the CardProfiles_Reference category, expand a Group by clicking the
corresponding plus sign.
Jul
2006
Step Action
5. Right-click a Card Profile and select Edit Node to launch the Edit Card Profile
dialog box.
6. From the Typical Data tab, highlight the PAN and enter the appropriate value.
This field is required for the Card Profile.
7. Modify remaining data as needed within the Typical Data pane.
8. Click the Track Data, Additional Data, or ICC Related Data tab and modify the
data as needed.
9.
Use the arrow buttons to navigate to the other profiles in the list.
10. Repeat steps 5 through 8 for each profile.
Step Action
1. From the Navigator pane, select Set Options.
2. Within the Options dialog box, click the BIN Table tab.
Step Action
5. In the Add BIN Range dialog box, enter all appropriate data.
Jul
2006
See Chapter 3 for details concerning the options available within the Add BIN
Range dialog box.
Step Action
1. In the Options dialog box, select the BIN Table tab.
2. In the BinTable_User, right-click an account range and select Edit Node to
launch the Edit Bin Range dialog box.
3. Modify the fields as needed.
4. Click Change when finished.
Use the following procedure to delete a BIN range from the BIN Table.
Step Action
1. In the Options dialog box, select the BIN Table tab.
2. Select a row in the BIN Table.
3.
Click the Delete button. Answer appropriately to a confirmation message
validating the delete action.
Note Members may clear the default log at any time or allow the test data to append
to the log.
For example, a member saves the log with the name “AMCC Test June 2006”
and either clears the default log before continuing testing or allows the test
data to append to the default log when testing is resumed. After the next
testing session is complete, the member may save the history log as a new file
using the Save As feature. Members may repeat the process as frequently as
needed. The saved logs are separate from the default log and will not be
modified by continued testing within the simulator. These saved logs may
then be forwarded to MasterCard for error troubleshooting or testing
validation.
Note The saved logs may be viewed through the View Archived Test Log feature
Clear Log
The Clear log function allows the member to reset or clear all entries in the
history log for the selected log. This action may not be reversed.
Step Action
1. From the Test Results window, select File/Clear Log.
2. Answer appropriately to a confirmation message validating the clear action.
This action may not be reversed.
Compact Log
Members may compact a history log database through a Compact Log option
available in the Test Results module. Members may use the Compact Log
option only on closed history logs. An open log may not be compacted.
Members may compact a saved history log through the Test Results module
while in the APS Host Testing, IPS Host Testing, or View Archived Test Log
mode.
Step Action
1. Select a Host Testing mode or the View Archived Test Log mode from the
Navigator pane drop-down list.
2. Click the Test Results or the View Archived Logs button in the Navigator pane.
3. From the File menu, select Compact Log.
Step Action
4. In the Select File dialog box, select a log file name (*.mdb) and click Open.
Jul
2006
5. In the Compact Log dialog box, click OK when the compact is complete.
Note The saved log file is automatically compacted when a history log file is saved as
another file name using the File/Save As option.
When the testing mode is set, use the following procedure to begin issuer host
testing:
Step Action
1. From the Navigator pane, select Test Monitor.
2. From the File menu, select Open Transaction File if needed.
3. Select a transaction file (e.g. Transaction Files_Issuer Testing.tri]) and click
Open.
Step Action
4. Click an individual transaction or a group folder to select all transactions
within the folder for testing.
Jul
2006
5.
Click the Run Test button to start testing.
With a transaction file running in the Test Monitor window, click the Stop
Test button to stop testing the active transaction file.
Using the Test Results module, members can review the History Log which
records details of every transaction sent between the member host and the
Test Monitor module providing a data element by data element view of the
transaction.
Table View
The Table view displays all transactions in a single pane with minimal detail
indicating the message flow, information, warnings, and errors for the test
session (Figure 4.2).
After running a test session, use the following procedure to view the test in the
Test Results window:
Step Action
1. From the Navigator pane, select Test Results.
2. Select a view by clicking a corresponding toolbar button.
Jul
2006
Icon Description
Information
Error
Warning
Jul
Transaction created by Network Performs Stand-In mode
2006
Icon Description
Message sent by the acquirer APS
Step Action
1.
From the Test Results window, click the Filter button.
Step Action
2. From the Filter dialog box, select a pre-defined filter option from the drop-
down list or select/deselect the individual options by clicking the
corresponding check box.
The filter selection is effective immediately and may be altered at any time.
Note Options may be modified in the Predefined filters by clicking a check box to
toggle on/off an option. By reselecting the predefined filter, members may
reset the default options of the predefined filter.
Select Messages
Use the following procedure to use the Select Messages option:
Step Action
1.
From the Test Results window, click the Select Messages button.
2. From the Select Messages dialog box, click the Select the messages fulfilling
following condition radio button.
Jul
2006
When using the Select Messages function, the member can use the asterisk
character (*) as a “wildcard” to match any value for the specified field or the
question mark character (?) to match a single character value. With the entry
of these wildcard characters, in the Like field of the Select Messages dialog
box, the Test Results module will match any value in a message provided a
value does exist and highlight the corresponding message(s).
Within the log, only the messages containing the matching criteria are
highlighted. When used to navigate through the log, the arrow buttons
navigate to only those highlighted messages. The message selection view is
effective immediately and may be altered at any time.
Step Action
1. From the Navigator pane, select a Test Mode or the View Archived Test Logs.
2. If viewing Archived Log Files, select a file and click Open.
3.
From the Test Results module, click the Generate text file button.
4. Click OK.
Jul
2006
5. The text file opens automatically in Notepad. Click Save As and enter a
unique name for the text file and select a directory if you need to change the
file name and/or location.
6. Click Save.
Network options allow members to customize the simulator for the following:
• Perform data integrity edit and if error found, stops 0100 message
processing and sends a 0110 message with a format error
• Sign-on selects the active PIN key set as configured in the PIN Key set
option
• Ignore all errors and continues processing of 0100 message
• Ignore all errors and continues processing of 0110 message
• Always return DE 48 to the acquirer
• Log zero length messages
• Show information messages for unannounced DE 48 subelements
• Include Test Description into Test Logs
Jul
• Issuer supports DE 48/SE 58 2006
Step Action
1. From the Navigator pane, select a Testing Mode from the drop-down list.
2. Select Set Options.
3. Select the Test Mode Options tab.
Jul
2006
Option Description
Treat Data Integrity Edits as Production Performs data integrity edit and if error
Format Errors found, stops 0100 message processing and
sends a 0110 message with a format error.
0800 Group Sign-On Selects PIN Key Set Sign-on selects the active PIN key set as
configured in the PIN Key set option.
Network Always Forward Request Ignores all errors and continues processing
Messages of 0100 message.
Network Always Forward Response Ignores all errors and continues processing
Messages of 0110 message.
Option Description
Always Return DE 48 to Acquirer When selected, the simulator always
returns DE 48 to the acquirer.
Logging of Zero Length Messages When selected, this option allows the
logging of zero length messages to the
simulator’s history log, which members
may view in either the Test Monitor or Test
Results module.
Show Information Messages for When this option is selected, each
Unannounced DE 48 Subelements unannounced DE 48 subelement is
identified in the history log file with a
message “Unannounced DE 48
subelements are present and are being
passed through the network.”
Include Test description into Test Logs When this option is selected, the simulator
writes the transaction description in the
history log providing an easier means of
locating a specific transaction in either the
Test Monitor or Test Results component.
Jul
Issuer supports DE 48/SE 58 This option indicates that the issuer does
2006
or does not receive DE 48, subelement 58
in 0100 and 0400 messages.
Issuer supports Refund transaction This option indicates that the issuer can or
cannot process refund transactions where
the value in DE 3, subfield 1 is equal to
“20” in the 0100/110, 0120/0130, and
0400/0410 messages.
Issuer supports Balance Inquiry This option indicates whether the issuer
transaction can or cannot receive ATM Balance Inquiry
transactions where the value in DE 3,
subfield 1 is equal to “30” and DE 48,
position 1 (TCC) is equal to “Z” in the
0100/0400 messages.
Acquirer supports DE 123 This option indicates that the issuer can or
cannot receive DE 123.
Acquirer supports MSI (Maestro) This option indicates that the acquirer can
or cannot acquire Maestro (MSI) branded
transactions.
Acquirer supports CIR (Cirrus) This option indicates that the acquirer can
or cannot acquire Cirrus (CIR) branded
transactions.
Step Action
1. From the Navigator pane, select a Testing Mode from the drop-down list.
2. Select Set Options.
3. Click the Crypto Keys tab.
4. Click the PINKeySet_User category icon.
5.
Click the Add New Group button.
9. Click OK.
Step Action
10. In the PINKeySet_User category key set, double-click a key to modify the
value.
11. In the Key Data Wizard, select the number of Key Components.
Step Action
14. Place cursor in the “Member” key components field(s) and enter the key
components. Do not use production keys.
The MChip Key Sets are separated into a “Reference” and a “User” category.
Members may not modify the “Reference” category which contains default
values. However, members may create “User” category MChip Key Sets to
enter their own keys.
Table 4.3 indicates the Simulator M/Chip Key Field names and their ICC Master
Key equivalent. See M/Chip 4 Security & Key Management for details
concerning ICC Master Key derivation.
Issuing members provide their own test Master Key clear key components.
Use the following procedure to create “User” category MChip Key sets:
Step Action
1. From the Navigator pane, select Set Options.
2. Click the Crypto Keys tab.
3. Click on a key set in the MChipKeySet_User group.
4.
Click the Add New Group button.
Step Action
8. In the Key Data Wizard, select the number of Key Components.
Step Action
15. Click a radio button to select a crypto or application type.
16. Click Next or OK depending on the whether the Application or Crypto field
was selected.
17. Double-click the Default field to set the selected MChip Key Set as the default
as needed.
18. Double-click the MIT Crypt Logging field to select/deselect the option to create
a log file for the corresponding MChip Key set.
19. Repeat procedure as needed for each “User” MChip Key Set.
20. Close the Options dialog box when finished.
This text log is located in the main simulator directory, Credit x_x 4. When
selected, the simulator appends the data to the M/Chip Crypto log. The
default name for the log is “destrace.txt.”
When testing specific scenarios, members may need a clean M/Chip Crypto log
to record the smart card interim cryptographic calculations for that testing
session. To create a clean log, members need to rename the existing log
before testing. As soon as testing begins, a new M/Chip Crypto log captures
all the appropriate input data values and output results for the smart card
interim cryptographic calculations for that testing session.
See M/Chip4 Security & Key Management for details concerning smart card
interim cryptographic calculations.
The following example shows the log capture for a DeriveMasterKeys function.
The timestamp matches the timestamp value in the Test Results history log.
The Function field indicates the cryptographic calculation performed with the
function parameters following.
Input Left Key equals Key1 of the Application Cryptogram Keys of the M/Chip
Keys window.
Input Right Key equals Key2 of the Application Cryptogram Keys of the
M/Chip Keys window.
Output Left Master Key equals key part 1 of the card master key derived from
the above parameters and used as input to derive session master keys.
Output Right Master Key equals key part 2 of the card master key derived from
the above parameters and used as input to derive session master keys.
The M/Chip Crypto log may be viewed in any word processing application
such as Microsoft® Notepad.
Step Action
1. Set the IPS Host Testing mode.
2. From the Navigator pane, click Test Preparation.
3. Click the Card Profiles tab.
Step Action
4. Click the CardProfiles_User category icon.
Jul
2006
5.
Click the Create a new Group button. Groups are used to organize card
profiles within the tree structure of the Card Profiles pane.
6. Enter a Name and Description and click OK.
7.
Click the Adds a Profile button.
Step Action
8. Enter a Profile Name and Description in the Edit Card Profile dialog box.
9. Enter an appropriate value in the 002 – Primary Account Number (PAN) field.
This field is required in the profile.
10. Enter data for each available field as needed in the Typical Data pane.
11. Click each tab and enter the appropriate data as needed.
12. Close the Edit Card Profile dialog box when finished.
Note The All Data tab is a composite view of all the data elements contained in the
associated profile. Members may not modify data in the All Data pane as it
only provides a quick overview of the profile data.
Use the following procedure to enter Additional or ICC Related Data in a User
Card Profile:
Step Action
1. With a Card Profile open, click the Additional Data or ICC Related Data tab.
2. Click a radio button in the Visible field in the lower window pane. This affects
the display of available subelements.
Step Action
4. In the Data and Subdata Element Editing dialog box, select a value option. If
selecting “enter value,” you must enter a value in the corresponding field. See
Table 4.4 for option details.
5. Click OK.
6. In the Edit Card Profile dialog box, click Compile. All selected subelements are
parsed and added to the corresponding Additional Data or ICC Related Data
field. The data is added to the profile.
Step Action
1. Set the IPS Host Testing mode.
2. From the Navigator pane, click Test Preparation.
3. Click the Card Profiles tab.
Step Action
4. In the CardProfiles_User category, expand a Group by clicking the
corresponding plus sign.
Jul
2006
Select a profile and click the Edit button to launch the Edit Card Profile
dialog box.
6. Click a tab and modify the data as needed.
7.
Use the arrow buttons to navigate to the other profiles in the list.
8. Repeat steps 6 and 7 for each profile as needed.
Step Action
1. Set the IPS Host Testing mode.
2. From the Navigator pane, click Test Preparation.
3. Click the Card Profiles tab.
4. In the CardProfiles_User category, expand a Group by clicking the
corresponding plus sign.
5. Select a Card Profile.
6. Click the Delete key.
7. Answer appropriately to a confirmation message confirming the delete action.
Step Action
1. From the Navigator pane, set the IPS Host Testing mode.
2. Click Test Preparation.
3. Click the Merchant Profiles tab.
Step Action
4. Click the MerchantProfiles_User category icon.
Jul
2006
5.
Click the Create a new Group button. Groups are used to organize card
profiles within the tree structure of the Merchant Profiles pane.
6. Enter a Name and description and click OK.
7.
Click the Adds a Profile button.
Step Action
8. Enter a Profile Name and Description in the Edit Merchant Profile dialog box.
9. From the Card Acceptor tab, enter the appropriate data for each available field
as needed. Note that bolded fields are required in the profile.
10. Click each tab and enter the appropriate data as needed.
11. Close the Edit Merchant Profile dialog box when finished.
Note The All Data tab is a composite view of all the data elements contained in the
associated profile. Members may not modify data in the All Data pane as it
only provides a quick overview of the profile data.
Step Action
1. Set the IPS Host Testing mode.
2. From the Navigator pane, click Test Preparation.
3. Click the Merchant Profiles tab.
4. Expand a “User” category profile group by clicking the corresponding plus
sign.
5.
Click on a profile and click the Edit button.
Step Action
1. Set the IPS Host Testing mode.
2. From the Navigator pane, click Test Preparation.
3. Click the Merchant Profiles tab.
4. Expand a “User” category profile group by clicking the corresponding plus
sign.
5. Click on a profile and click the Delete key.
6. Answer appropriately to a confirmation message confirming the delete action.
Step Action
1. From the Navigator pane under the Testing tab, select IPS Host Testing from
the drop-down list.
2. Click Test Preparation to launch the Test Preparation window.
Jul
2006
Modifying a Transaction
Members may modify and customize each transaction individually. By adding
data elements manually to a transaction and then modifying the values,
members may change the values for specific data elements. The transaction
references the manual entry instead of the profile value for the data element.
Example A member may want to change the Transaction Amount or the PAN in a specific
transaction.
The changes you make to an individual transaction are not global changes, but
apply only to that transaction contained in the active test transaction file.
Step Action
1. Open a transaction file in the Test Preparation module.
2. Select a transaction by clicking anywhere in the row.
Jul
2006
3.
Click the Views composed message button to display the message in the
Transaction dialog box.
Step Action
4.
In the Transaction dialog box, click the Profiles button to display the
message organized by Transaction Source.
Jul
2006
5. Use the Arrow buttons to navigate and view the next message in the transaction
file.
For example, a transaction built with a Card Profile that defines DE 4 (Amount,
Transaction) as 10 USD, has a manually added DE 4 with the value of 100
USD. The manually added DE 4 value is used in the transaction instead of the
Card Profile defined DE 4 value of 10 USD. The manually added data element
affects only the selected transaction and does not change the Card Profile.
Step Action
1. Open a transaction file in the Test Preparation window.
2. Select a transaction by clicking any where in the row to highlight.
3. In the Profile pane, click the Data Elements tab.
4. Double-click a data element or use the standard Microsoft functionality to click
and drag a data element from the list and place it in the selected transaction.
Jul
2006
Members may modify the value in the manually added data element within a
transaction. See Changing a Data Element Value in a Transaction for details.
Step Action
1. Open a transaction file in the Test Preparation window.
2. Select a transaction by clicking any where in the row to highlight.
3. Expand the transaction by clicking the corresponding plus sign.
4. Double-click the data element to launch the Data and Subdata Element Editing
dialog box.
5. Click a Value option radio button. If enter value is selected, type in a value.
6. Click OK when finished.
Step Action
1. Open a transaction file in the Test Preparation window.
2. Select a transaction by clicking any where in the row to highlight.
3. Expand the transaction by clicking the corresponding plus sign.
Step Action
4. Select a data element identified by the DE icon.
Jul
2006
5. Click the DELETE key. The data element is deleted immediately without
notification. This action may not be reversed.
Step Action
1. Open a transaction file in the Test Preparation window.
2. Select a transaction by clicking any where in the row to highlight.
3. In the Profile pane, click the Card or Merchant tab.
4. Use standard Microsoft functionality to click and drag a profile from the list
and place it on the icon or transaction name of the selected transaction.
The change is immediate.
For example, within the Card Profiles tab are three groups; Standard Cards,
Gold Cards and Fleet Cards. Each group of card profiles contains individual
card profiles with the same names. In the transaction file is a
“GasStationPayInside” group which contains transactions using the Standard
Card profiles. By using the Search and Replace function, the member may
replace any matching card profiles in the “GasStationPayInside” transaction
group with the Gold Cards or Fleet Cards groups of the Card Profiles tab. The
search and replace allows the member to select the transaction file or
transaction group in which to search, as well as the Profile group from which
the matching profile data will be copied. Once the search criteria are selected,
a search may be performed displaying all the occurrences of matching criteria
found in the transaction file. The member may then replace the profile data,
updating the transaction file.
Step Action
1. From the Test Preparation module, open a test transaction file.
2.
Click the Search and Replace button.
Step Action
3. In the Search and Replace dialog box, click the corresponding Browse button
for the Replace in Transaction File field.
Step Action
4. Select a transaction file group and click OK.
5. In the Search and Replace dialog box, click the corresponding Browse button
for the Replace with Profile from Group field.
Step Action
6. In the Select Card or Merchant Profiles dialog box, select a Card or Merchant
Profile group and click OK.
Step Action
7. Click Search to display the matching profile criteria in the selected transaction
file.
8. Click Replace to replace the matching profile criteria within the transaction file.
Step Action
1. Select a transaction in the test file.
2. From the Edit menu, select Copy.
3. Move your insertion point to the new location by selecting a transaction.
4. From the Edit menu, select Paste. The system inserts the pasted transaction
above the selected transaction insertion point.
Deleting Transactions
To delete a transaction from a transaction file, select the transaction and press
the DELETE key. The system immediately deletes the transaction without a
confirmation warning and may not be undone.
Step Action
1. Open the desired transaction file.
2. Click on the base “TransactionFile_IssuerTest” or a group name.
3.
Click the Add Instruction button.
4. Click a radio button and add data to the corresponding field as needed.
5. Click OK.
Table 4.5—Instructions
Instruction Description
Pause Pause automatic transaction processing for a given number of
seconds
Prompt Creates a message box requiring operator intervention. Members
enter the text to be included in the prompt
Log Allows members to enter a note to the transaction log at the
place of insertion
Send Allows the member to enter data in HEX format to be sent
directly to the direction specified, bypassing all outgoing
message formats and validations. This allows members minute
control of the data being sent
HoldFor Waits to receive a specified message type
SetDateTime Allows members to set the date and time for simulator
processing
ResetDateTime Resets the date and time to the system’s default
SetMChipKeySet Allows members to set the MChip Key Set
Remove instruction Removes the instruction from an associated profile or removes
from profile the instruction from a transaction
Jul
2006
Adding an Instruction to Set a Future Settlement Date in the
Simulator
At times, members may need to perform a simulator test with a future
settlement date. Within the Test Preparation module, members may add an
instruction that specifies a date and time to be used in DE 15 (Date,
Settlement) and DE 16 (Date, Conversion).
Warning Members should not change the simulator’s PC date to a future date as this will
cause the simulator’s security hardware token license to update the token
access date. As a result, when the PC date is reset to the current date the
license date becomes expired. An expired license date in the license file causes
the security token to deny member access to the simulator.
In some instances, if the PC date is manually changed to a distant future date, a
new hardware token may be required to operate the simulator. A hardware
token replacement fee will apply.
Use the following procedure to add an instruction in a transaction file to set a Jul
future settlement date for simulator processing: 2006
Step Action
1. Open the Test Preparation module.
2. Click on the base “TransactionFile_IssuerTest” or a group name to determine
the placement of the instruction.. The instruction will be inserted after the
highlighted group.
3.
Click the Add Instruction button.
4. Click the SetDateTime radio button and enter the new date and time in the
corresponding fields.
Note: Members may use the above procedure to add an instruction to reset the
date and time by simply clicking the ResetDateTime radio button.
5. Click OK.
However, members may create and modify “User” Network Response Profiles
to support testing outside of the MasterCard required testing.
Step Action
1. From the Navigator pane, set the IPS Host Testing mode.
2. Click Test Preparation.
3. Click the Network Response Profiles tab.
4. Click the NetworkResponseProfiles_User category icon.
5.
Click the Create a new Group button. Groups are used to organize card
profiles within the tree structure of the Network Response Profile pane.
6. Enter a Name and Description and click OK.
7.
Click the Adds a Profile button.
Step Action
8. In the Edit Response Profile dialog box, enter a profile name and description.
Step Action
1. Expand a Response Profile Key in the “User” category.
Jul
2006
2. Right-click the Network Response Profile Data group for the corresponding
Profile Key.
3. Click Edit Node.
Step Action
4. Click the DE 48 or DE 55 tab as needed.
5. Click a radio button in the Visible field in the lower window pane. This
affects the display of available subelements.
6. Double-click a subelement to launch the Data and Subdata Element Editing
dialog box.
7. Click a Value option radio button. If enter value is selected, type in a value.
8. Click OK when finished.
9. In the Response Profile dialog box, click Compile. All selected subelements
are parsed and added to the corresponding Additional Data or ICC Related
Data field. The data is added to the profile.
10. From the Other Response Data tab, click a radio button in the Visible field in
the lower window pane. This affects the display of available subelements.
11. Double-click a subelement to launch the Data and Subdata Element Editing
dialog box.
12. Click a Value option radio button. If enter value is selected, type in a value.
Step Action
13. Click OK when finished. The data element is added to the profile.
14.
To add an instruction to the profile, click the Add Instruction button.
15. Select a corresponding instruction radio button, adding the appropriate data as
needed.
Note The All Data tab is a composite view of all the data elements contained in the
associated profile. Members may not modify data in the All Data pane as it
only provides a quick overview of the profile data.
Step Action
1. Double-click the MasterCard Credit Authorization Simulator icon on the PC
desktop to launch the simulator application.
2. In the Navigator window, from the Testing tab, select APS Host Testing from
the drop-down list. The testing status indicator displays “Connecting” until the
connection to the member host completes then the status changes to
“Connected.”
Warning Members should not change the simulator’s PC date to a future date as this will
cause the simulator’s security hardware token license to update the token
access date. As a result, when the PC date is reset to the current date the
license date becomes expired. An expired license date in the license file causes
the security token to deny member access to the simulator.
In some instances, if the PC date is changed to a distant future date, a new
hardware token may be required to operate the simulator. A hardware token
replacement fee will apply.
Step Action
1. Open the Test Preparation module.
2.
Click the Add Instruction button.
3. Click the SetDateTime radio button and enter the new date and time in the
corresponding fields.
Note: Members may use the above procedure to add an instruction to reset the
date and time by simply clicking the ResetDateTime radio button.
4. Click OK.
Use the following procedure to add acquirer IDs to the Acquirer Table:
Step Action
1. From the Navigator, select Set Options.
2. Within the Options dialog box, click the Acquirer Table tab.
Step Action
Jul
5. In the Acquirer ID dialog box, enter all appropriate data. See Chapter 3 for 2006
details concerning the available options in the Acquirer ID dialog box.
6. Click Add.
Acquirers will also need to test transactions to which the desired response is
not an approval for Authorization Request/0100 messages. To force the
simulator to generate negative or non-default responses to correctly formatted
messages, members will need to ensure an Issuer Response Profile is
configured and enabled. Issuer Response Profiles allow particular response
codes to be linked to specified matching criteria (e.g. PAN [DE 2], Processing
Code [DE 3], Transaction Amount [DE 4], Merchant Type [DE 18], and POS
Entry Mode [DE 22]) of the Authorization Request/0100 message received from
the member host.
Step Action
1. From the Navigator window, select Test Monitor.
2. Click the Issuer Response Profile tab.
3. Select an individual profile or a folder.
Jul
2006
4.
Click the Enable Response Profile button to enable the selected response
profile or all the profiles within a folder.
Step Action
1. From the Navigator window, select Test Monitor.
2. Click the Issuer Response Profile tab.
3. Select an individual profile or a folder.
Jul
2006
4.
Click the Disable Response Profile button to disable the selected response
profile or all the profiles within a folder.
If the incoming message contains errors, the Test Monitor identifies the errors
with an error icon and automatically generates and returns an appropriate
reject message to the member host.
Using the Test Results module, members can review the History Log which
records details of every transaction sent between the member host and the
Test Monitor module and provides a data element by data element view of the
transaction.
Table View
The Table view displays all transactions in a single pane with minimal detail
indicating the message flow, information, warnings, and errors for the test
session (Figure 5.2).
Jul
2006
Jul
2006
Jul
2006
After running a test session, use the following procedure to view the test in the
Test Results window:
Step Action
1. From the Navigator window, select Test Results.
2. Select a view by clicking a corresponding toolbar button.
Jul
2006
Icon Description
Information
Error
Warning
Jul
Transaction created by Network Performs Stand-In mode
2006
Icon Description
Message sent by the acquirer APS
Step Action
1.
From the Test Results window, click the Filter button.
Step Action
2. From the Filter dialog box, select a pre-defined filter option from the drop-
down list.
The filter selection is effective immediately and may be altered at any time.
Select Messages
Use the following procedure to use the Select Messages option:
Step Action
1.
From the Test Results window, click the Select Messages button.
Step Action
2. From the Select Messages dialog box, click the Select the messages fulfilling
following condition radio button.
The message selection is effective immediately and may be altered at any time.
Step Action
1. From the Navigator, select a Test Mode or View Archived Log Files.
2. If viewing Archived Log Files, select a file and click Open.
3.
From the Test Results module, click the Generate text file button.
Step Action
4. Click OK.
Jul
2006
5. The text file opens automatically in Notepad. Select File/Save As and enter a
unique name for the text file and select a directory if you need to change the
file name and/or location.
6. Click Save.
Using a simple Save As function members may create multiple saved log files
for each testing scenario as needed with little interruption to a testing session.
Note Members may clear the default log at any time or allow the test data to append
to the log.
For example, a member saves a log with the name “AMCC Test June 2006” and
either clears the default log before continuing testing or allows the test data to
append to the default log once testing is resumed. Once the next testing
session is complete, the member may save the history log as a new file using
the Save As feature. Members may repeat the process as frequently as needed.
The saved logs are independent of the default log and will not be modified by
continued testing within the simulator. These saved logs may then be
forwarded to MasterCard for error troubleshooting or testing validation.
Step Action
1. In the Test Results module, select File/Save Log As.
2. In the Save As dialog box, enter a file name and click Save.
3. Click OK. The log is saved and compacted.
Note The saved logs may be viewed through the View Archived Test Log feature.
Clear Log
During testing, the simulator appends all testing data to the History Log.
When testing specific test scenarios, members may want to create a clean log
in which to capture only the test data for that individual test. Once the testing
is complete, members may then save the history log to an individual file for
test analysis and validation. The Clear log function allows the member to reset
or clear all entries in the history log for the selected log. This action may not be
reversed.
Step Action
1. From the Test Results window, select File/Clear Log.
2. Answer appropriately to a confirmation message validating the clear action.
This action may not be reversed.
Compact Log
Members may compact a history log database through a Compact Log option
available in the Test Results module. Members may use the Compact Log
option only on closed history logs. An open log may not be compacted.
Members may compact a saved history log through the Test Results module
while in the APS Host Testing, IPS Host Testing, or View Archived Test Log
mode.
Step Action
1. Select a Host Testing mode or the View Archived Test Log mode from the
Navigator drop-down list.
2. Click the Test Results or the View Archived Logs button in the Navigator
window.
3. From the File menu, select Compact Log.
Step Action
4. In the Select File dialog box, select a log file name (*.mdb) and click Open.
Jul
2006
5. In the Compact Log dialog box, click OK when the compact is complete.
Note When a history log file is saved as another file name using the File/Save As
option, the saved log file is automatically compacted.
Step Action
1. From the Navigator window, select a Testing Mode from the drop-down list.
2. Select Set Options.
Step Action
3. Select the Test Mode Options tab.
Jul
2006
Option Description
Treat Data Integrity Edits as Production Performs data integrity edit and if error
Format Errors found, stops 0100 message processing and
sends a 0110 message with a format error.
0800 Group Sign-On Selects PIN Key Set Sign-on selects the active PIN key set as
configured in the PIN Key set option.
Network Always Forward Request Ignores all errors and continues processing
Messages of 0100 message.
Network Always Forward Response Ignores all errors and continues processing
Messages of 0110 message.
Always Return DE 48 to Acquirer When selected, the simulator always
returns DE 48 to the acquirer.
Option Description
Logging of Zero Length Messages When selected, this option allows the
logging of zero length messages to the
simulator’s history log, which members
may view in either the Test Monitor or Test
Results module.
Show Information Messages for When this option is selected, each
Unannounced DE 48 Subelements unannounced DE 48 subelement is
identified in the history log file with a
message “Unannounced DE 48
subelements are present and are being
passed through the network.”
Include Test description into Test Logs When this option is selected, the simulator
writes the transaction description in the
history log providing an easier means of
locating a specific transaction in either the
Test Monitor or Test Results component.
Jul
Issuer supports DE 48/SE 58 This option indicates that the issuer does 2006
or does not receive DE 48, subelement 58
in 0100 and 0400 messages.
Issuer supports Refund transaction This option indicates that the issuer can or
cannot process refund transactions where
the value in DE 3, subfield 1 is equal to
“20” in the 0100/110, 0120/0130, and
0400/0410 messages.
Issuer supports Balance Inquiry This option indicates whether the issuer
transaction can or cannot receive ATM Balance Inquiry
transactions where the value in DE 3,
subfield 1 is equal to “30” and DE 48,
position 1 (TCC) is equal to “Z” in the
0100/0400 messages.
Acquirer supports DE 123 This option indicates that the issuer can or
cannot receive DE 123.
Acquirer supports MSI (Maestro) This option indicates that the acquirer can
or cannot acquire Maestro (MSI) branded
transactions.
Acquirer supports CIR (Cirrus) This option indicates that the acquirer can
or cannot acquire Cirrus (CIR) branded
transactions.
Use the following procedure to create a “User” category PIN Key Set:
Step Action
1. From the Navigator window, select a Testing Mode from the drop-down list.
2. Select Set Options.
3. Click the Crypto Keys tab.
4. Click the PINKeySet_User category icon.
5.
Click the Add New Group button.
9. Click OK.
Step Action
10. In the PINKeySet_User category key set, double-click a key to modify the
value.
11. In the Key Data Wizard, select the number of Key Components.
Step Action
14. Place cursor in the “Member” key components field(s) and enter the key
components. Do not use production keys.
However, members may create and modify “User” Network Response Profiles
to support testing outside of the MasterCard required testing.
Step Action
1. From the Navigator, set the APS Host Testing mode.
2. Click Test Preparation.
3. Click the Network Response Profiles tab.
4. Click the NetworkResponseProfiles_User category icon.
5.
Click the Create a new Group button. Groups are used to organize card
profiles within the tree structure of the Network Response Profile pane.
6. Enter a Name and Description and click OK.
7.
Click the Adds a Profile button.
Step Action
8. In the Edit Response Profile dialog box, enter a profile name and description.
Step Action
1. Expand an Issuer Response Profile Key in the “User” category.
Jul
2006
2. Right-click the Issuer Response Profile Data group for the corresponding
Profile Key.
3. Click Edit Node.
Step Action
4. Click the DE 48 or DE 55 tab as needed.
5. Click a radio button in the Visible field in the lower window pane. This
affects the display of available subelements.
6. Double-click a subelement to launch the Data and Subdata Element Editing
dialog box.
7. Click a Value option radio button. If enter value is selected, type in a value.
8. Click OK when finished.
9. In the Edit Response Profile dialog box, click Compile. All selected
subelements are parsed and added to the corresponding Additional Data or
ICC Related Data field. The data is added to the profile.
10. From the Other Response Data tab, click a radio button in the Visible field in
the lower window pane. This affects the display of available subelements.
11. Double-click a subelement to launch the Data and Subdata Element Editing
dialog box.
Step Action
12. Click a Value option radio button. If enter value is selected, type in a value.
13. Click OK when finished. The data element is added to the profile.
14.
To add an instruction to the profile, click the Add Instruction button.
15. Select a corresponding instruction radio button, adding the appropriate data as
needed.
Note The All Data tab is a composite view of all the data elements contained in the
associated profile. Members may not modify data in the All Data pane as it
only provides a quick overview of the profile data.
The Professional version of the MasterINQ Simulators is the platform for all
MasterINQ Add-In tools.
Navigator Options
Within the Navigator, members may access the following enhanced options
that are available only in the Professional version of the MasterINQ simulators.
User Management
There may be times when multiple users need to test on the same simulator or
even a single user who may need to test different scenarios. Since not all
users or test scenarios need the same test data, the Professional version of the
simulator provides a way of managing and separating the user-defined data for
each user or testing scenario.
Through the User Management feature members may create and manage
multiple user profile sets that reference different user-defined data entered in
the following simulator categories:
• Profiles
− TrxProfiles_User (Transaction profiles)
− CardProfiles_User (Card Profiles)
− MerchantProfiles_User (Merchant Profiles)
− NetworkResponseProfiles_User (Network Response Profiles)
− IssuerResponseprofiles_User (Issuer Response Profiles)
• Options
− AcquirerID_User
− BinTable_User
− CVC3KeySet_User
− CVCKeySet_User
− HMACKeySet_User
− MChipKeySet_User
− PINKeySet_User
The “active” Profile Set is indicated in the upper pane of the User Management
dialog box (Figure A.1). Any changes or additions to the indicated user
categories will be associated to the active profile set at the time of the
modifications.
Step Action
1. From the User Management dialog box, click on a profile set folder in the
Users tree directory.
2. Click Select.
3. Click OK. The selected Profile Set then becomes the active Profile Set.
Changing the User Profile Set Without Starting a New Simulator Session
At times, members may want to change the User Profile Set without starting a
new simulator session. The User Management dialog box may be accessed
within the Navigator under the System Admin tab.
Use the following procedure to change the User Profile Set without starting a
new simulator session:
Step Action
1. From the Navigator window, select Disconnect in the Testing pane.
2. Click the System Admin tab.
Step Action
3. Click the User Management icon.
Step Action
1. From the User Management dialog box, click New.
2. Enter a folder name and click OK.
3. Click Save.
4. Click OK.
Members may copy an existing profile set and then enter a name for the new
profile set.
Step Action
1. From the User Management dialog box, click on a profile set in the Users tree
directory.
2. Click Copy.
3. Enter a folder name in the Rename dialog box and click OK.
4. Click Save.
5. Click OK.
Step Action
1. From the User Management dialog box, click on a profile set in the Users tree
directory.
2. Click Delete.
3. Click OK in a message confirming the delete action.
Members may access the Self Testing mode from the Navigator pane Testing
tab in the Professional version.
Step Action
1.
From the Test Preparation module, click the Populate button.
2. In the Folder Name field, type the name of the folder to contain the populated
transactions.
Step Action
4. Select a Transaction Profile(s) in the Transaction Profile pane.
Step Action
5. Click the Card Profile tab and select a Card Profile category (folder) or an
individual profile(s).
6. Click the Merchant Profiles tab and select a Merchant Profile category (folder)
or an individual profile(s)..
7. Change the Number of resulting requests field if needed. This field
determines the number of transactions created.
8. Click OK when finished.
Members may use a comma separated (.csv) file from a spreadsheet utility
(such as Microsoft® Excel) or a text (.txt) file from a word processor (such as
Microsoft® Word or Notepad) to import data for a transaction file. This allows
greater ease and flexibility for mass entries of information to the simulator.
The Test Preparation module preprocesses the imported file data validating the
specified profile names for each record. The import process takes the data
from the .txt or .csv file and converts it into the appropriate format and layout
for the simulator.
Use the following procedure to import a transaction file from a text file:
Step Action
1.
Within the Test Preparation module, click the Import Transaction File
button.
2. Select a transaction .txt or .csv file in the Select File dialog box and click Open.
The Test Preparation module requires that certain conditions exist in the
import file for a successful import.
The first line of the text file is called the Header Line and contains the names
of the fields that are present in each line of the input file. The Header Line
contains the following information:
• (Group) This field is mandatory.
This field contains the path, group names and sub-group names where the
data will be created. If the path is not valid then a critical error occurs and
the import fails.
• (Name)
This field contains the name of the transaction. If this field is not specified,
the name of the Transaction Profile will be used as the name for the
transaction.
• (Description)
This field contains the description for the transaction file.
• (Transaction Profile) This field is mandatory.
This field contains the name of the Transaction Profile. If the Transaction
Profile is specified, a search is performed in the User and Reference
Transaction Profiles for the first occurring match. If the full Transaction
Profile path is entered, this will be used to determine the transaction
profile.
If the Transaction Profile is not specified, then DE 003.01 needs to be
specified. The first occurrence of this value will be used to select the
transaction profile.
If both the Transaction Profile and DE 003.01 are not specified in the
Header Line then a critical error occurs and the import fails.
The import function will fail if the table header row is not in the first row
position of the importing file. The lines following the Header Lines contain
the values (comma separated).
The number of transactions per input file is limited to 2500. If there are more
than 2500 records, the import will fail. If a critical error occurs on the Header
Line, the import will fail. When the Header Line is correct and a critical error
occurs on a record, the pre-process continues with the next record but the
import fails.
If a field does not contain data, the field still needs commas to separate it from
the fields before and after it. In Figure A.4 the (Name) field placeholder in
both lines of data is indicated with a comma after the field place. All fields are
comma separated.
Step Action
1. Set a testing mode.
2. From the Navigator pane, click Test Preparation.
3. In the Profile pane, right-click the TrxProfiles_User icon.
4. Select Add a Folder if needed..
5. Enter a group name and description.
6. Click OK
7. Expand a group(s) in the TrxProfiles_Reference category.
Step Action
8. Right-click a transaction profile and click Copy.
9. Right-click a folder in the Trx_Profiels_User category and click Paste.
Step Action
1. Set a testing mode.
2. From the Navigator pane, click Test Preparation.
3. In the Profile pane, expand a folder in the TrxProfiles_User category.
Step Action
5. Select the Class DEs tab.
Step Action
7. Select a value from the drop-down list and click OK.
Step Action
8. Select the Get from Card Profile or Get from Merchant Profile tab as needed.
11.
Click the Save button to save the profile changes or click the Cancel
button to cancel the changes.
Use the following procedure to remove the retrieval of data from the Card or
Merchant Profile:
Step Action
1. In the Profile pane, expand a folder in the TrxProfiles_User category.
Step Action
4. Double-click a data element to launch the Edit Field dialog box.
Step Action
1. Set a testing mode.
2. From the Navigator pane, click Test Preparation.
Step Action
3. From the Profile pane, click a profile in the TrxProfiles_User category.
The Response Profile display tree structure separates the profile key as the
primary group and the profile data as a sub-group of the profile key
(Figure A.5).
With the Professional version, each Response Profile may have multiple
response data entries. This allows the members to create a single profile key
with multiple responses.
Step Action
1. From the Navigator pane, set a testing mode and click Test Preparation.
Step Action
2. In the Test Preparation module, click a Response Profile tab.
3. Select a profile.
4.
Click the Adds new profile data button. The new profile data is
appended to the selected Response Profile.
Step Action
5. Right-click the new profile data and then click Edit node.
6. Modify the data as appropriate. See Entering Network Response Profile Data
in Chapter 4 for details.
Members may manage the log through the Log Parameters dialog box. From
here, the history log may be organized through the use of uniquely named log
databases.
Step Action
1. From the Test Results window, select File/Manage Log to display the Log
Parameters dialog box.
4. Click Open.
5. Click Close.
Once created, the new database name becomes the default until another
database name is selected. The default or selected database name will contain
all testing records in the history log from the moment testing begins until
another name is selected.
Step Action
1. From the Test Results window, select File/Manage Log to display the Log
Parameters dialog box.
2. Click Select.
3. Select a database name and click Open.
4. Click Close.
Once selected, the database name becomes the default until another database
name is selected. The default or selected database name will contain all
testing records in the history log from the moment testing begins until another
name is selected.
After running a transaction file through the Test Monitor module, members
may find a specific transaction quickly and easily in the Test Results history log
by using the Select Transaction feature. The Select a Transaction feature uses
the active Transaction File as the basis for the filtering selection. Members
would select a specific transaction(s) from the corresponding tree structure in
the Select a Transaction dialog box.
Use the following procedure to filter the history log using the Select a
Transaction feature:
Step Action
1. Select either the Self Testing or IPS Host Testing mode in the Navigator pane.
2. Start a testing session in the Test Monitor module.
3. Open the Test Results module.
4.
Click the Select a Transaction button.
5. Select either the Do not select or Select a Response Transaction option in the
Select a Transaction dialog box.
Step Action
6. Expand a group and click on a transaction.
7. Click OK.
Step Action
8. The filtered view is immediate. Only the specified selection displays while the
rest is grayed out.
Note
The button acts an on/off toggle for the Select Transaction feature. Within
the Select a Transaction dialog box, click Cancel to deselect or turn off the filter.
When set, the Compare mode grays out all transactions in the Test Results
transaction pane. The member selects the transactions for comparison via a
right-click menu option. Distinction between the selected transactions is
indicated by either blue (compare right) or green (compare left) text in the
Test Results transaction pane. The member determines the right or left display
by selecting either Compare Left or Compare Right from the right-click menu
(Figure A.6).
The green text indicates the transaction displays in the left-hand pane of the
Compare dialog box and blue text indicates the transaction displays in the
right-hand pane (Figure A.7).
Figure A.7—Compare
Step Action
1. Open a log or logs. These may be the active log or archived log(s).
2.
From the Test Results window, click the Compare button to set the
Compare mode.
3. Click OK.
Step Action
7. The Compare dialog box displays the two transactions for comparison.
Use the following procedure to open an additional window in the Test Results
module:
Step Action
1. Open the Test Results module.
2. From the File menu, select Open New Window.
Step Action
3. Select a log in the Select File dialog box and click Open.
4. Resize the new window to view both Test Results windows simultaneously.