Mfe PDF
Mfe PDF
Mfe PDF
Guide
v.7.0
18 August 2016
BHa
Notices
Notices
Proprietary Rights
The information contained in this document is proprietary and confidential to MasterCard International
Incorporated, one or more of its affiliated entities (collectively “MasterCard”), or both.
This material may not be duplicated, published, or disclosed, in whole or in part, without the prior written
permission of MasterCard.
Trademarks
Trademark notices and symbols used in this document reflect the registration status of MasterCard
trademarks in the United States. Please consult with the Global Customer Service team or the MasterCard
Law Department for the registration status of particular product, program, or service names outside the
United States.
All third-party product and service names are trademarks or registered trademarks of their respective
owners.
Disclaimer
MasterCard makes no representations or warranties of any kind, express or implied, with respect to the
contents of this document. Without limitation, MasterCard specifically disclaims all representations and
warranties with respect to this document and any intellectual property rights subsisting therein or any part
thereof, including but not limited to any and all implied warranties of title, non-infringement, or suitability
for any purpose (whether or not MasterCard has been advised, has reason to know, or is otherwise in fact
aware of any information) or achievement of any particular result. Without limitation, MasterCard
specifically disclaims all representations and warranties that any practice or implementation of this
document will not infringe any third party patents, copyrights, trade secrets or other rights.
Translation
A translation of any MasterCard manual, bulletin, release, or other MasterCard document into a language
other than English is intended solely as a convenience to MasterCard customers. MasterCard provides any
translated document to its customers “AS IS” and makes no representations or warranties of any kind with
respect to the translated document, including, but not limited to, its accuracy or reliability. In no event shall
MasterCard be liable for any damages resulting from reliance on any translated document. The English
version of any MasterCard document will take precedence over any translated version in any legal
proceeding.
MasterCard provides details about the standards used for this document—including times expressed,
language use, and contact information—on the Publications Support page available on MasterCard
Connect™. Go to Publications Support for centralized information.
Contents
Notices...............................................................................................................................2
Refreshing Files................................................................................................................ 34
Retrieving an Archived File............................................................................................... 34
Performing Multiple File Exchanges.................................................................................. 35
Viewing File Profiles......................................................................................................... 36
Using View Criteria.......................................................................................................... 36
Changing a Staging Directory...........................................................................................37
Using Multiple Endpoints................................................................................................. 37
Selecting the Initial Endpoint at Startup....................................................................... 38
Selecting an Endpoint During the Current Session........................................................38
Chapter 4: Reporting................................................................................................39
About File Express Reports............................................................................................... 40
Session Report.............................................................................................................40
Audit Report................................................................................................................42
Transfer Log Report..................................................................................................... 44
Printing a Session Report..................................................................................................45
Printing an Audit Report...................................................................................................46
Printing a Transfer Log Report.......................................................................................... 46
Changing Retention Configuration...................................................................................47
System Requirements
File Express users must, at a minimum, have the following system requirements.
• Windows® 7, Windows® 8, Windows® 10, Windows® Server 2008, Windows® Server 2008
R2, Windows® Server 2012, Windows® Server 2012 R2
• Registered with MasterCard Connect™ and have a SecurID® token
Procedure
1. Log on to MasterCard Connect™ at www.mastercardconnect.com.
2. Enter your User ID and Password.
3. Click Store on the main menu (located in the upper-right corner) on the MasterCard
Connect home page.
4. Scroll to or search for MasterCard File Express Software.
5. Click Add to Cart.
A confirmation message appears.
6. Click Cart to display the cart, and then click Checkout to display the Order Details
window.
7. Under Order Details, click Review Order, and then click Place Order.
After the appropriate Security Administrator approves the order, it is routed to MasterCard
for processing. The user will have access to File Express Software after MasterCard
approves the order. Once the order is approved, MasterCard File Express Software will
appear as an entry in the Applications menu on the MasterCard Connect home page.
Users must have a SecurID® to use File Express Client. If you do not have a SecurID prior to
ordering MasterCard File Express Software, one will be issued as part of the access
approval and product fulfillment process.
NOTE: It is not necessary to uninstall the File Express version 6.0 before you install File
Express version 7.0. This will enable you continue to use version 6.0 while you transition to
version 7.0. Once you fully transition to File Express version 7.0, you may then uninstall File
Express version 6.0 at your convenience.
Procedure
1. Log on to MasterCard Connect at www.mastercardconnect.com.
2. On the Applications menu, click MasterCard File Express Software. The download
page appears. Note that you may also access and download the MasterCard File Express
User Guides from the download page.
3. Click the MasterCard File Express Software Package link, and then follow the
instructions on your screen to download the software package.
4. Once the download is complete, click Open or Run this program from its current
location to launch the InstallShield® Wizard.
5. When the InstallShield® Wizard starts, click Next.
The License Agreement dialog box appears.
6. Click I accept the terms of the license agreement option, and then click Next.
The Ready to Install the Program dialog box appears.
7. Click Install to begin the installation.
The Java Setup Welcome dialog box appears.
8. To install the Java components, click Install.
9. After the Java components are installed, click Close to close the Java Setup Complete
dialog box and continue with the install.
10. After the installation is complete, you will be prompted as to whether or not to start the
File Express Transfer Engine Windows service.
– Click Yes to start the service using the Windows Local System account.
– Click No if you wish to configure the service to run using a different Windows account.
The InstallShield® Wizard Complete dialog box appears.
11. Click Finish to exit the wizard.
Results
The File Express Transfer Engine Windows service is a required part of the installation of
MasterCard File Express and must be running in order to use the Files Express Client and
Scheduler applications. See Starting and Stopping File Express Transfer Engine Service
for details about manually starting and stopping the Transfer Engine.
Procedure
1. Navigate to the system Control Panel.
2. Click the Administrative Tools icon, and then double-click the Services icon.
3. In the Services list, navigate to the service name MFETransferEngine.
4. Right-click MFETransferEngine and select one of the following:
– Start—starts the MFETransferEngine
– Stop—stops the MFETransferEngine
5. Close the Services window when finished.
Procedure
1. Stop the File Express Transfer Engine before you uninstall File Express. See Starting and
Stopping File Express Transfer Engine Service.
2. Click Start, Control Panel, then select Programs and Features.
The Programs and Features window appears.
3. In the list of currently installed programs, select the version of MasterCard File Express
you want to uninstall, and then click Uninstall.
4. Follow the instructions on your screen to remove File Express from your computer.
The system will confirm that File Express has been successfully uninstalled from your
computer.
5. Using Windows Explorer, verify that the C:\MFE70 folder was deleted during the uninstall
process. If the MFE70 folder still exists, you may delete the folder and its entire contents at
your convenience.
Internet Connectivity
The File Express Transfer Engine Windows Service exchanges files with MasterCard using the
SFTP protocol. Your firewalls, proxy servers, or both must allow outbound Transmission
Control Protocol (TCP) traffic on ports 15022 and 16022.
The following table provides the public Uniform Resource Locators (URLs).
Procedure
1. Click Start, and then click Run. to open the Run dialog box.
2. In the Open box, type cmd, and then click OK.
The Command Prompt window appears.
3. Run the command nslookup prod.mfe.mastercard.com.
If this command is successful, the output will include the following text. If you do not see
this output, go to step 4.
What to do next
If you could resolve the DNS host name for “prod.mfe.mastercard.com” to IP Address
12.22.155.207 and still cannot authenticate, proceed to the next section Testing the SFTP
Connection.
Procedure
1. Click Start, and then click Run.
2. Type cmd in the Open dialog box and then click OK.
3. Run the command telnet prod.mfe.mastercard.com 15022. If this command is
successful, then it will display the output SSH-2.0-SSHD.
4. If File Express Client is still unable to connect, work with your network administration
team to diagnose why your system is being denied access. It may be that network firewalls
or routers are in place preventing you from connecting to prod.mfe.mastercard.com on
port 15022.
What to do next
If you performed this test successfully and File Express Client is still unable to connect to the
MasterCard File Express server, try Testing the Proxy Server.
Procedure
1. Create an access control rule on the firewall to bypass the proxy server.
2. MasterCard File Express supports anonymous, basic authentication, and NTLM
authentication proxy servers.
Results
Your network administration team can check their proxy server logs for dropped or terminated
connections that would verify the proxy is blocking the File Express connection.
About File Profiles, Staging Directories, and Bulk File Naming Conventions....................................14
About File Express Directories........................................................................................................15
About the File Express Client Main Window.................................................................................. 18
Window Elements.................................................................................................................... 19
Menu Bar................................................................................................................................. 20
Toolbar.....................................................................................................................................20
File List..................................................................................................................................... 22
Working with the File List.................................................................................................... 22
Moving Columns................................................................................................................. 22
Changing Column Widths................................................................................................... 23
Sorting the File List.............................................................................................................. 23
Information Fields.....................................................................................................................23
Environment.............................................................................................................................23
Status Bar.................................................................................................................................24
About Uploading Files to MasterCard............................................................................................24
Getting Help................................................................................................................................. 25
Links and Browse Buttons.........................................................................................................25
File Profiles
A file profile is established at MasterCard for each File Express licensed user. The file profile
consists of data stored on the File Express server in the MasterCard data center, and includes
the list of endpoints that the user is authorized to access and the list of bulk types that the
user is authorized to exchange through those endpoints.
Staging Directories
For each endpoint/bulk type defined in a user’s file profile, File Express maintains a user-
configurable staging directory. The staging directory specifies the source directory for files sent
to MasterCard and the destination directory for files retrieved from MasterCard. File Express
creates a default staging directory during its startup process each time it encounters a new
endpoint/bulk type in a user’s file profile.
Staging directory customizations are maintained for each user. When a single workstation is
used by multiple File Express users, each user can maintain his or her own custom staging
directory for each bulk type they are profiled to exchange.
By default, the File Express Transfer Engine Windows service runs as the Windows Local
System account. This account normally only has permissions to access local system drives. To
access shared network folders, you will need to work with your Windows system
administrator to establish an account with appropriate permissions to run the File Express
Transfer Engine Windows service and access the desired shared network folders. Otherwise,
your Staging Directories will be limited to local drives.
Since the File Express Transfer Engine runs as a Windows Service, if you select a File Staging
Directory associated with a shared network folder, you must use the universal naming
convention (UNC) notation. Otherwise, the File Express Transfer Engine Windows service will
not be able to access the shared network folder. You must also ensure the user or service
account running the File Express Transfer Engine Windows service has permissions to access
the shared network folder.
The following table identifies the parts of the file name and provides a description of each
part. Bulk type, endpoint, and date and time are relevant file name elements for the end user.
The date and time is when the data file was created in the MasterCard Global File Transfer
Management System.
Part Description
T112 Bulk file type. Bulk types allow MasterCard to process files appropriately.
The first position indicates the direction that the file is moving (from a MasterCard
perspective).
• R indicates that the file is being Received from the customer into MasterCard.
• T indicates that the file is being Transmitted to the customer from MasterCard.
The remaining three positions identify the type of file (for example, 112 indicates a
Global Clearing Management System (GCMS) data file).
D040928 Date the file was created. A D (constant), followed by the year, month, and day the file
was created—DYYMMDD.
T095115 Time the file was created. A T (constant), followed by the time of day in 24-hour
format. Time—HHMMSS.
A001 Sequence number. The sequence number is used to ensure unique file names.
Over time, as File Express uses these directories, users will need to maintain and manage their
content to ensure there is enough remaining disk space for File Express to conduct file
exchange. When there is insufficient disk space to complete a file transfer, File Express will
display a warning message and the associated file transfer will fail.
The following information describes how each File Express directory is used.
Download Directory
The Download directory stores files successfully downloaded (retrieved from MasterCard) by
File Express. There are two different download directories: one for production files and the
other for test files. The two default locations are:
• Production—C:\MCONLINE\MFE\DOWNLOAD
• Test—C:\MFE_TEST\BP_TEST\DOWNLOAD
Both directories can be customized on a file type basis.
The files downloaded to these directories have a specific naming convention. The file name
includes the file type and a date and time stamp. The date and time stamp indicates the date
and time that the file was created on your workstation. For multiple files of the same type,
created with the same date and time stamp, a three-digit sequence number is used to
differentiate each of the files and to ensure that File Express does not try to overwrite an
existing file in the Download directory. An example of a downloaded file name is:
TT206T0.2016-05-14-10-57-03.001
Where:
• TT206T0 is the file name (Bulk ID T206)
• 2016–05–14 is the date (year, month, and day)
• 10–57–03 is the time stamp (hour, minute, and second in 24-hour time) that the file
download occurred.
• 001 is the sequence number
Upload Directory
The Upload directory stores files that are ready to be uploaded (sent inbound) to MasterCard.
Similar to the Download directory, there are two default root locations for Upload directories
as follows:
• Production—C:\MCONLINE\MFE\UPLOAD
• Test—C:\MFE_TEST\BP_TEST\UPLOAD
In addition, for each unique file type uploaded to MasterCard, there is a unique subdirectory
under the root Upload directories. The subdirectories have the format <endpoint ID>
\<bulk ID>. For example, if you were set up for production file type R205 on endpoint
0076543, the following default directory would be created:
C:\MCONLINE\MFE\UPLOAD\0076543\R205
The files you stage in the upload directories are not required to have a specific naming
convention. For example, if you want to upload an R205, you could name the file
R205-50kb.TXT.
Similar to the Download directories, you also can customize the location of the Upload
directories on a file type basis; however, it is a requirement that every uploaded file type have
its own unique staging directory. For example, you could not use the same upload directory to
stage both R205 and R111.
Sent Directory
In each staging directory for file types you upload to MasterCard, File Express creates a
directory called sent (for example: C:\MCONLINE\MFE\UPLOAD\0076543\R205\sent).
Once a file from the staging directory is successfully uploaded to MasterCard, File Express will
move the file to the sent directory and append a date and time stamp to its name. Here is an
example of a file name in the sent directory:
R205-10kb.TXT-2016-05-14-09-58-38
Where:
• R205–10kb.TXT is the original file name
• 2016–05–14 is date (year, month, and day)
• 09–58–38 is the time stamp (hour, minute, and second in 24-hour time) that the file was
uploaded to MasterCard successfully
If File Express cannot create the sent directory when needed or cannot move a file to the sent
directory, a file transfer failure message will display. Generally, the reason that the sent
directory cannot be created is because of a permissions problem, which can be resolved by
your system administrator.
The files in the sent directory are for your convenience. You must move, copy, or delete them
to manage your disk space.
WARNING:
If File Express fails to move a file after it is successfully sent (that is, the file is left in the
Upload staging directory), File Express may try to send the file again in a later session,
resulting in duplicate file uploads.
Archive Directory
The Archive directory stores files that you download from the MasterCard archive. After File
Express downloads a file the first time, the MasterCard Global File Transfer Management
System moves that file to an archive where you can re-download it as necessary. The default
location for the Archive directory is C:\MFE70\download\archive.
Similar to Download and Upload directories, you also can customize the location of the
Archive directory on a file type basis. The files downloaded to the Archive directory have a
specific naming convention. The file name includes the file type and a date and time stamp.
The date and time stamp are provided by your workstation at the time the file is downloaded.
Here is an example of a file name in the Archive directory:
TT206T0.2016-05-15-12-43-37.001
Reports Directory
The Reports directory (C:\MFE70\reports) contains copies of audit reports (.html). By
default, these files are retained for 10 days. Here is an example of an audit report file name in
the Reports directory:
audit-2016-03-16-09-30-03.html
Where:
• audit is the report type
• 2016–03–16 is the date (year, month, and day)
• 09–30-03 is the time stamp (hour, minutes and seconds in 24-hour time)
Each file contains the results of an individual file transfer session conducted on a given day;
the file name indicates the date and time of the session.
Logs Directory
The Logs directory (C:\MFE70\logs) contains copies of the Transfer Logs (.htm). Transfer
Logs contain information about run time activity, number of files transferred, and status
information for all files exchanged on a given day. The transfer logs can be very useful when
troubleshooting issues that may occur during file exchange. By default, transfer logs are
retained for 10 days. Here is an example of a Transfer Log file name:
xfer-2016-05-24.htm
Where:
• xfer is the report type
• 2016–05–24 is the date (year, month, and day)
Window Elements
File Express Client provides common window elements that you can use to access the
application commands.
Menu Bar Provides commands that you can use to perform tasks in the File
Express Client application
Toolbar Provides toolbar buttons that you can use to perform common
tasks in the application quickly
File List Lists the files available for transfer or lists the user’s file profiles for
a specific endpoint
Information Fields Provides information about the content displayed in the file list,
server URL, and IP address
Status Bar Indicates the current transfer mode and user ID, provides the date
and time, and a connection indicator
Menu Bar
The File Express Client menu bar provides commands that you can use to perform tasks in the
application. Depending on the task you are performing, some commands may be unavailable.
The following table describes the commands available in the File Express Client menu bar.
Menu Bar
Commands Description
File Includes commands to access the Transfer Log and Audit reports, enable or
disable Verbose Logging, and exit the application
View Includes a command to change the View Criteria, which selects what content
displays in the file list, and a command to Refresh the file list
Transfer Includes commands to Select All files in the file list, Clear All file selections in the
file list, and Transfer Selected Files in the file list
Help Includes commands to access Online Help and About to display the application
version and software build date
Toolbar
You can use the File Express Client toolbar buttons to perform common tasks in the
application. Depending on the tasks you are performing, some toolbar buttons may be
unavailable.
The following table describes the File Express Client toolbar buttons.
Toolbar
Button Label Description
Transferable Files View Displays the file list that contains files available for
exchange (upload or download) for the selected
endpoint
File Profiles View Displays the file types configured in the user’s file
profile for the selected endpoint
Toolbar
Button Label Description
Download View Displays the file list that contains either the files
available for download for the selected endpoint or
downloadable file types configured in the user’s file
profile for the selected endpoint
Upload View Displays the file list that shows either files available
for upload for the selected endpoint or uploadable
file types configured in the user’s file profile for the
selected endpoint
Archive View Displays the file list that shows either archived files
available for download for the selected endpoint or
downloadable file types configured in the user’s file
profile for the selected endpoint
File List
The file list displays the files available for transfer or displays the user’s file profile for a specific
endpoint. Depending on the view criteria you select, the file list will change.
The following table describes the file list columns on the main window.
Column Description
Status Displays the Fail status when a file does not transfer successfully. Fail is the
only status that displays in this column
DateTime For files available for download, specifies the date and time the file
became available for download. For files available for upload, the date
and time specifies when the file was last modified on your workstation.
FilePath Displays the source directory for files available for upload and the
destination directory for files available for download
You can change the appearance of the file list by resizing and moving columns, and by
changing the sort order of the file list.
Moving Columns
To change the order of the columns in the file list, position the pointer on the column heading
that you want to move, and then drag the column to the new location.
Procedure
1. Select any column heading to specify sorting.
2. Click the column heading for the first sort criteria—ascending—to sort all items in the
selected column in ascending order (for example, A to Z; 1 to 10).
3. Click the column heading again for the second sort criteria—descending—to sort all items
in the selected column in descending order (for example, Z to A; 10 to 1).
Results
Depending on your selected sort criteria, a sort icon (triangle) changes direction—up or down.
Information Fields
The File Express Client main window displays several information fields.
Field Description
Number of Transferable Files Number of files that the system can transfer based on the current
view criteria
Current Sort Field Primary sort criteria for the file list displayed
Accessible File Profiles Number of file profiles configured for the current endpoint
Environment
You can select the production or test environment from the File Express Client main window.
The environment you select determines whether you are exchanging files with the MasterCard
production environment (MCI) or the MasterCard test facility environment (YTF).
Production Environment
When you select the production environment, you can exchange production files or retrieve
archived files from MasterCard. The file profiles established for your user ID determine which
production files are available to you. Your file profiles are set up to include the endpoints and
bulk types you need to access. After your file profiles have been established by MasterCard,
you can exchange files with MasterCard production applications.
Test Environment
The test environment allows you to exchange test files or retrieve archived test files from the
MasterCard test facility. The file profiles established for your user ID determine which test files
are available to you. The test environment allows you to test new application software releases
in coordination with a MasterCard Customer Implementation group.
Status Bar
The status bar, located at the bottom of the File Express Client main window, indicates the
current transfer mode and user ID, provides the date and time, and a connection indicator.
Upload Directory
One way to add files to File Express Client for upload is to move or copy them to the
appropriate file type Upload directory. Each file type that can be sent to MasterCard has a
unique subdirectory, called the Upload directory, where source files can be staged in
preparation for uploading them to MasterCard. When File Express Client starts, the upload file
list will include all files you have moved or copied to the file type Upload directory.
For steps to upload files, go to Uploading a File to MasterCard. For information about
changing staging directories, go to Changing a Staging Directory.
Getting Help
Online Help provides a quick way to find useful information while working in File Express
Client. To access Help, follow these steps.
Procedure
1. On the main menu, choose from one of these options:
– On the Help menu, click Help, and then click Online Help.
–
Click the Help button.
2. When you are finished using Help, click the Close button.
Results
Because Help opens in a separate window, when you click Help, File Express Client remains
open.
Procedure
1. Use one of the following actions to start File Express Client. Depending on which version
of Windows you’re using, this method may vary slightly.
– Double-click the File Express 7.0 Client icon on your desktop.
– On the taskbar, click Start > All Programs > MasterCard Worldwide > MasterCard
File Express > File Express 7.0 Client.
File Express Client starts and displays the Client User Login dialog box.
2. In the User ID box, type your MasterCard Connect System User ID.
3. In the Secure ID box, type your PIN and SecurID code, and then click Accept or press
ENTER.
The MasterCard File Express Activity Status window appears and displays a blue progress
indicator to indicate that authentication is in progress.
4. If you are configured for more than one endpoint, the Select Endpoint dialog box appears
after user authentication is successful. Select the desired endpoint, and then click OK.
The File Express Client main window opens with the View Criteria set to the endpoint you
selected.
Procedure
1. Start File Express Client.
File Express Client starts and displays the Client User Login dialog box.
2. Click Configure Proxy.
The Proxy Server Settings dialog box appears.
3. Enter the proxy server parameters you obtained from the network administration team,
and then click OK to save your changes.
4. In the User Authentication dialog box, enter your MasterCard Connect System User ID
and PIN/SecurID, and then click Accept.
The MasterCard File Express Activity Status window appears and displays a blue progress
indicator to indicate that authentication is in progress.
5. If you did not provide valid proxy server settings in step 2, the following message appears.
Click Yes to close the message and display the Client User Login dialog box.
6. If your log in was successful and if you are configured for more than one endpoint, the
Select Endpoint dialog box appears after user authentication is established.
7. Select the appropriate endpoint, and then click OK.
Results
The File Express Client main window opens with View Criteria set to the endpoint you
selected.
NOTE: If a user previously authenticated to the File Express Transfer Engine using File Express
Scheduler credentials and only exited the Scheduler window, then when you start File
Express Client, you will be given the opportunity to pause any scheduled activity the File
Express Transfer Engine may be managing. You will see the following Pause Scheduler dialog
box.
To pause scheduled activity, you must provide the correct SSH Key Passphrase for the SSH Key
that the File Express Transfer Engine is currently using and click Pause Scheduler. Click Cancel
if you do not want to pause scheduled file transfers. When you click Pause Scheduler, you will
see the following dialog:
Clicking Yes will cause any active file transfer to fail, delay files queued with the File Express
Transfer Engine and pause processing of scheduled transfers while you use File Express
Client! Do you want to continue?
Click No to abort the File Express Client login. Click Yes to pause scheduled transfers and use
File Express Client. When you exit from File Express Client, the File Express Transfer Engine
will resume processing scheduled file transfers.
Procedure
1. Select the appropriate environment (Production or Test).
2.
Click the Transferable Files View button.
3. Click the Download View button.
The file list displays the files that can be downloaded from MasterCard.
4. Select the check box next to each file you want to download.
5. Click the Transfer Selected Files button to download the file.
The MasterCard File Express Activity Status window displays the progress of the file
transfer. While downloading the file, the Activity Status window changes as it displays the
name and size of each file being transferred, and displays the progress of the transfer.
6. After all selected files have been transferred, the File Transfer Status message appears. The
message details the number of successfully transferred files and the number of failed
transferred files. Click OK to close the message.
Results
File Express Client places each file in the Download directory for the selected bulk type. Each
downloaded file is archived in the MasterCard Global File Transfer Management System. To
see a list of available files, click the Archive View button.
The files downloaded to the Download directories have a specific naming convention. For
more information about file naming conventions, go to About File Profiles, Staging
Directories, and Bulk File Naming Conventions.
Procedure
1. Copy or move the files you want to upload to the Upload directory for the specified file
type (for example, C:\MCONLINE\MFE\UPLOAD\R205).
2. Start the File Express Client application.
3. Select the appropriate environment (Production or Test).
4.
Click the Transferable Files View button.
5. Click the Upload View button.
Any file you placed in the corresponding Upload directory displays in the file list.
6. Select the check box next to each file you want to upload, and then click the Transfer
Selected Files button to upload the files.
The MasterCard File Express Activity Status window displays the progress of the file
transfer. While uploading the file, the Activity Status window changes as it displays the
name and size of each file being transferred, and displays the progress of the transfer.
7. After all selected files have been transferred, the File Transfer Status message appears. The
message details the number of successfully transferred files and the number of failed
transferred files. Click OK to close the message.
Results
Each file that was uploaded successfully is moved to a sent directory under the file type
Upload directory and renamed with the date and time stamp of the transfer appended to the
file name.
Adding Files
You can add files to your upload list from any directory on a network drive that File Express
Transfer Engine Windows service has permission to access. To upload a file to MasterCard
using the Add File feature, follow these steps.
Procedure
1. Select the appropriate environment (Production or Test).
2.
Click the Transferable Files View button.
3. Click the Upload View button.
4.
Click the Add button on the right side of the upload file list.
The Add File to Upload dialog box appears.
5. Under Profile Selection, select the bulk file type for the file you want to upload, and
then click OK.
The standard Windows Open dialog box appears.
6. Locate the file that you want to add to the upload list, and then click Open.
The file is added to the list of available files to upload.
7. Repeat steps 5–6 for each file type you want to upload.
8. To delete a file from the file list, select the check box next to the file you want to delete,
and then click the Delete button on the right side of the upload file list. This delete
capability only applies to files that were added using the Add button as described above.
Refreshing Files
If you move or copy files to any Upload directory while File Express Client is running, you must
refresh the upload file list to view those files. To refresh the file list at any time during a
session, follow these steps.
Procedure
1. Select the appropriate environment (Production or Test).
2.
Click the Transferable Files View button.
3. Click the Upload View button .
4. Copy or move the files you want to upload to the Upload directory for the specified file
type (for example, C:\MCONLINE\MFE\UPLOAD\R205).
5. Click the Refresh Files button.
Results
Any new files placed in a file type Upload directory will display in the upload file list.
Procedure
1. Select the appropriate environment (Production or Test).
2.
Click the Transferable Files View button.
3. Click the Archive View button to display a list of files that have been previously
downloaded.
4. Select the check box next to each archived file you want to download.
5. To download the file, click the Transfer Selected Files button.
The Activity Status window displays the progress of the file transfer. While retrieving an
archived file, the Activity Status window changes as it displays the name and size of each
file being transferred, and displays the progress of the transfer.
6. After all selected files have been transferred, the File Transfer Status message appears.
Click OK to close the message.
Results
File Express Client places the downloaded files in the file type Archive directory.
Procedure
1. Select the appropriate environment (Production or Test).
2. Click the Download View button.
3. Select the check box next to each file you want to download.
4. Click the Upload View button.
5. Select the check box next to each file you want to upload.
6. Click the Transfer Selected Files button to initiate multiple downloads and uploads for
sequential transfer with MasterCard.
While transferring files, the Activity Status window changes as it displays the name and
size of each file being transferred. The Activity Status window also displays the progress of
the transfer. After downloads are complete, uploads will begin.
7. After the files have been transferred, the File Transfer Status message appears. Click OK to
close the message.
Results
File Express Client sequentially exchanges each selected file and places downloaded files in
their file type staging directory and moves sent files to their specific Upload sent directory.
Procedure
1. Select the appropriate environment (Production or Test).
2. Select the appropriate view criteria button:
– Download
– Upload
– Archive
3. Click the File Profiles View button.
File Express Client displays the file profiles for which you are authorized to exchange based
on the selected view criteria.
Procedure
1. On the View menu, click View Criteria.
The View Criteria dialog box appears.
2. Select the options you want to use, and then click OK.
Procedure
1. Click the File Profiles View button.
The system displays the file profiles for which you are authorized to access based on the
environment and view criteria you selected (Upload, Download, or Archive).
2. In the FilePath column of the file list, double-click the file path of the profile you want to
change.
The Directory Selector dialog box displays the default folder path for the File Express Client
computer.
3. Use the Directory Selector dialog box to select a different drive directory, and then click
Select.
IMPORTANT: When using the Directory Selector dialog, if you select a shared network
folder, you must use the universal naming convention (UNC) notation. Otherwise, the File
Express Transfer Engine Windows service will not be able to access the shared network
folder. The UNC format is:
\\servername\sharename\path
By default, the File Express Transfer Engine service runs as the Windows Local System
account and may have limited or no access at all to shared network folders. To access
shared network folders, you will need to work with your Windows system administrator
to establish an account with appropriate permissions to run the File Express Transfer
Engine Windows service and with appropriate access to the desired shared network
folders.
Results
In the FilePath column, notice that the file path changed for the selected profile.
Procedure
1. Start File Express Client and connect to the MasterCard File Express server.
The Select Endpoint dialog box displays with the multiple endpoints configured in your
user profile.
2. Select the endpoint you want to use, and then click OK.
Results
The File Express Client main window appears. In the Information Fields area, the current
endpoint you selected displays in the Current Endpoint field.
Procedure
1. Once transfers are completed for the current endpoint, click View Criteria on the View
menu.
2. In the Endpoint list, select the endpoint you want to use, and then click OK.
If you are not configured for multiple endpoints, this field is not available.
Results
The File Express Client main window appears. In the Information Fields area, the current
endpoint you selected displays in the Current Endpoint field.
Chapter 4 Reporting
This section provides information about the session report (File Express Client only), audit reports,
transfer log reports, and report retention configuration.
Session Report
The session report provides information about successful and unsuccessful file exchanges that
occurred during the current transfer session.
The session report may look similar to the following illustration.
Report Description
The following table provides a brief description of the session report.
Frequency The user may view or print this report at any time during a file transfer
session.
Field Definitions
The following table describes the fields on this report.
Field Description
Field Description
File Name Actual file name and path of the transferred file
• For downloaded files, the file location to which the file was
downloaded from MasterCard
• For uploaded files, the file location from which the file was uploaded
to MasterCard
Date/Time For files sent to MasterCard, indicates the file creation time-stamp from
your file system. For files retrieved from MasterCard, indicates date and
time the file was originally submitted to the MasterCard Global File
Transfer Management System
Total Files Number of files that were downloaded and uploaded, both successfully
and unsuccessfully
Audit Report
The audit report is stored in a file after each completed file transfer session. You can select,
preview, and print a specific audit report. You can also change the number of days the audit
report is retained (up to 100 days).
The audit report may look similar to the following illustration.
Report Description
The following information provides a brief description of the audit report.
Frequency This report is produced at the end of each file transfer session when you exit
File Express. By default, the audit report is retained for 10 days (maximum
retention time is 100 days) after a file transfer session has completed.
Field Definitions
The following table describes the fields on this report.
Field Description
Field Description
File Name Actual file name and path of the transferred file
• For downloaded files, the file location to which the file was
downloaded from MasterCard
• For uploaded files, the file location from which the file was uploaded
to MasterCard
Date/Time For files sent to MasterCard, indicates the file creation time-stamp from
your file system. For files retrieved from MasterCard, indicates date and
time that the file was originally submitted to the MasterCard Global File
Transfer Management System
Total Files Number of files that were downloaded and uploaded, both successfully
and unsuccessfully
Procedure
1. Click the Reports button .
The Session Report window displays the current transfer session.
2. To print the report, click the Print button to display the Page Setup dialog box.
3. In the Page Setup dialog box, make any needed changes, and then click OK.
The standard Windows Print dialog box appears.
4. In the Print dialog box, click OK to print.
Procedure
1. On the File menu, click Audit.
The Audit Report window appears.
2. In the Report list, select the audit report you want to preview or print.
3. To print the report, click the Print button to display the Page Setup dialog box.
4. In the Page Setup dialog box, make any needed changes, and then click OK.
The standard Windows Print dialog box appears.
5. In the Print dialog box, click OK to print.
Procedure
1. On the File menu, click Transfer Log.
The Transfer Log report window appears.
2. In the Report list, select the transfer log report you want to preview or print.
3. To print the report, click the Print button to display the Page Setup dialog box.
4. In the Page Setup dialog box, make any needed changes, and then click OK. The
standard Windows Print dialog box appears.
5. In the Print dialog box, click OK to print.
Procedure
1. On the File menu, click Audit or click Transfer Log.
The Reports window appears.
2. On the Reports window, click the Retention Configuration button.
The Retention Configuration dialog box appears.
3. In the Audit Report Retention Days box, enter the number of days (maximum limit
allowed is 100) you want to retain each audit report. The audit report is available for each
completed file transfer session.
4. In the Transfer Log Retention Days box, enter the number of days (maximum limit
allowed is 100) you want to retain each daily transfer log. The transfer log report displays
the results of all file transfers sessions for a single day.
5. Click Save to save your changes.