Sunteți pe pagina 1din 48

File Express Client User

Guide
v.7.1
26 September 2017

BHUGV
Summary of Changes, 26 September 2017

Summary of Changes, 26 September 2017


This lists the changes made in the guide since the last publication on 26 September 2017.

Description of Change Where to look

All MasterCard instances changed to: Throughout


• Mastercard

Updated www.Mastercardconnect.com to: Throughout


• www.mastercardconnect.com

Changed 7.0 to: File Express Software Package


• 7.0 and above

Java®Runtime Environment (JRE) value replaced File Express Software Package


with:
• jre-8u102-window-i586

Updated the following section: Registering for File Express


• Registering for File Express

Updated the following section: Installing File Express


• Installing File Express

Updated the following section: Uninstalling File Express


• Uninstalling File Express

Updated the table under: Internet Connectivity


• Internet Connectivity

Added the following section as: About Environment


• About Environment

Updated the user interface image for: About the File Express Client Main Window
• About the File Express Client Main Window

Updated the table under: Window Elements


• Window Elements

Updated the table under: Information Fields


• Information Fields

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 2
Summary of Changes, 26 September 2017

Description of Change Where to look

Removed section titled:


• Environment

Updated the following section: Starting File Express Client


• Starting File Express Client

Updated the following section: Configuring Proxy Server Settings


• Configuring Proxy Server Settings

Updated the following section: Downloading a File from Mastercard


• Downloading a File from Mastercard

Updated the following section: Uploading a File to Mastercard


• Uploading a File to Mastercard

Updated the following section: Adding Files


• Adding Files

Updated the following section: Refreshing Files


• Refreshing Files

Updated the following section: Retrieving an Archived File


• Retrieving an Archived File

Updated the following section: Performing Multiple File Exchanges


• Performing Multiple File Exchanges

Updated the following section: Viewing File Profiles


• Viewing File Profiles

Updated the image in section: Using View Criteria


• Using View Criteria

Updated the following section: Changing a Staging Directory


• Changing a Staging Directory

Updated the following section: Selecting the Initial Endpoint at Startup


• Selecting the Initial Endpoint at Startup

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 3
Mastercard File Express Client

Chapter 1 Mastercard File Express Client


This section provides a brief explanation of File Express Client, its features and requirements, and
explains how to install the application. Information about Internet connectivity and troubleshooting
common network connectivity issues is also included.

File Express Software Package......................................................................................................... 5


File Express Client Features..............................................................................................................6
System Requirements......................................................................................................................6
New Mastercard Connect Users...................................................................................................... 6
Registering for File Express.............................................................................................................. 7
Installing File Express.......................................................................................................................7
Starting and Stopping File Express Transfer Engine Service...............................................................9
Uninstalling File Express.................................................................................................................. 9
Internet Connectivity.......................................................................................................................9
Troubleshooting Network Connectivity..........................................................................................10
Testing the Domain Name Service.............................................................................................10
Testing the SFTP Connection.....................................................................................................11
Testing the Proxy Server............................................................................................................ 11

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 4
Mastercard File Express Client
File Express Software Package

File Express Software Package


The following components are included in the Mastercard File Express software package.
• File Express Transfer Engine Windows Service
With File Express 7.0 and above, the underlying file transfer protocol has been converted
from HTTPS to Secure Shell FTP (SFTP). See the section Internet Connectivity for URLs,
port numbers and IP addresses.
The File Express Transfer Engine runs as a Windows service and conducts all file exchange
and configuration management requested by either the File Express Client or File Express
Scheduler user interfaces. When you enable the file exchange schedule defined using the
File Express Scheduler user interface, you can close the File Express Scheduler user interface
and the Transfer Engine Windows service will manage your file exchange schedule.
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 a service 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.
• File Express Client
With File Express 7.0 and above, File Express Client is strictly a user interface for initiating
file transfers and specifying custom configuration. The File Express Transfer Engine
Windows service manages the specified configuration and all file exchange initiated using
the File Express Client user interface.
• File Express Scheduler
With File Express 7.0 and above, File Express Scheduler is strictly a user interface for
specifying a file exchange schedule, initiating ad-hoc file transfers and specifying custom
configuration. The File Express Transfer Engine Windows service manages the specified
configuration and scheduled file exchanges.
• Java® Runtime Environment (JRE)
The File Express software package includes the JRE (jre-8u102-window-i586). The JRE is
installed in a custom location ( C:\MFEJRE8 ). File Express Transfer Engine, Client and
Scheduler are coded to always use this specific JRE version from the custom location.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 5
Mastercard File Express Client
File Express Client Features

File Express Client Features


File Express Client provides a reliable, secure way for customers to exchange files with
Mastercard in an attended (user initiated) mode.
In attended mode, users initiate each file exchange. For unattended (scheduled/automated)
file transfers, File Express Scheduler may be used. For unattended file transfers, users can set
up a schedule to exchange files with Mastercard automatically, with no user intervention
required to initiate each exchange. For more information about unattended file transfers, see
the Mastercard File Express Scheduler User Guide.
File Express Client is a Java-based application that allows you to:
• Exchange (download and upload) production and test files between Mastercard and your
host.
• Retrieve archived files. Archived files are those files that have been previously downloaded
from Mastercard successfully.
• Display and print a file transmission session report for information regarding successful or
unsuccessful file transfers that occurred during the current transfer session.
• Display and print an audit report for a selected file transfer session. The audit report
contains specific file names exchanged, file creation time-stamp, file size, and overall
transfer session status.
• Display and print a transfer log containing a report for every file transfer attempted with
the Mastercard File Express server on a specific day. The transfer log report includes the
transfer date and time, if the transfer was successful or unsuccessful, the endpoint of the
file transferred, bulk type, source file, target file, file size, and if necessary, reason for
failure.

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

New Mastercard Connect Users


If you are a new user, you must register with Mastercard Connect™ to access Mastercard File
Express software. New users can sign up for Mastercard Connect through the Online
Registration System. Registration is free to Mastercard customers.

Mastercard Connect Registration


To register for Mastercard Connect, follow these steps:

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 6
Mastercard File Express Client
Registering for File Express

1. Log on to Mastercard Connect at www.mastercardconnect.com.


2. On the Mastercard Connect landing page, click the Sign Up button in the left panel.
3. Follow the instructions that appear on your screen.
Subsequent access to Mastercard Connect requires only your user ID and password, which are
specified during the enrollment process. A SecurID token (to be used as your password) is
assigned, if required for a Mastercard Connect product that requires higher security level
access like Mastercard File Express.
After you have successfully registered for Mastercard Connect or if you are an existing
Mastercard Connect user, go to the next section, Registering for File Express.

Registering for File Express


After you have successfully registered for Mastercard Connect or if you are an existing
Mastercard Connect user, follow these steps to order the Mastercard File Express software.

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 Order.
6. Follow the instructions on the screen to fill in the required information, 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.

Installing File Express


To download and install the Mastercard File Express Software package, follow these steps.

Before you begin


To access Mastercard Connect™ and to download Mastercard File Express Software, you must
use your Mastercard Connect user ID and SecurID®.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 7
Mastercard File Express Client
Installing File Express

About this task


The File Express Transfer Engine Windows service, Client and Scheduler applications are
conveniently bundled in the Mastercard File Express software package.

NOTE: It is recommended to uninstall the earlier File Express version after you install File
Express version 7.0 and above. That will ensure any configuration customizations made to
earlier versions of File Express are retained. It will also enable you continue to use version 6.0
while you transition to version 7.0 and above. Once you fully transition to File Express, you
may then uninstall the earlier version of File Express at your convenience.
If you already have File Express installed, follow the steps as described in Uninstalling File
Express to uninstall it first before installing the new version.

Procedure
1. Go to Mastercard Connect at www.mastercardconnect.com.
2. On the My Apps window, 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

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 8
Mastercard File Express Client
Starting and Stopping File Express Transfer Engine Service

Scheduler applications. See Starting and Stopping File Express Transfer Engine Service
for details about manually starting and stopping the Transfer Engine.

Starting and Stopping File Express Transfer Engine Service


The following steps outline the procedures for starting or stopping the File Express 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.

Uninstalling File Express


To uninstall File Express, follow these steps. Depending on which version of Windows you are
using, these steps may vary slightly. Do not delete the existing mfeprofile.xml file under c:
\MFE70 folder if you have made custom configurations. The configurations will be migrated to
the new version.

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.

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 9
Mastercard File Express Client
Troubleshooting Network Connectivity

The following table provides the public Uniform Resource Locators (URLs).

Application Name (URL) Port IP Address

File Express Client • Production: 15022 • Production:


prod.mfe.mastercard.com 12.22.155.207
• Test: mtf.mfe.mastercard.com • Test: 216.119.219.6

File Express Scheduler • Production: 16022 • Production:


uprod.mfe.mastercard.com 12.22.155.208
• Test: umtf.mfe.mastercard.com • Test: 216.119.219.7

Troubleshooting Network Connectivity


There are several tests, including testing the domain name service (DNS), SFTP connection, and
proxy server that users can use to resolve Mastercard File Express connectivity issues.

Testing the Domain Name Service


Perform the domain name service (DNS) test if you are using the File Express Client to
authenticate to the Mastercard File Express server and you suspect the DNS is not resolving the
host name for prod.mfe.mastercard.com to the IP address.

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.

4. If can’t find prod.mfe.mastercard.com: Non-existent domain? displays, work with


your network administration team to diagnose why your network’s DNS is not able to
resolve the Mastercard File Express URL to its IP address.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 10
Mastercard File Express Client
Troubleshooting Network Connectivity

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.

Testing the SFTP Connection


Perform the following test to verify whether a SFTP connection can be made to the
Mastercard File Express server using the host name ‘prod.mfe.mastercard.com’ and port
15022.

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.

Testing the Proxy Server


If the earlier tests were successful, but you are still unable to connect to the Mastercard File
Express server and you are connecting to a proxy server, your network administration team
may need to define an access control rule to allow traffic to flow to Mastercard. To resolve this
issue, follow these steps.

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 11
Getting Started

Chapter 2 Getting Started


This section provides a description of file profiles and staging directories, and explains how to
navigate the File Express Client user interface.

About File Profiles, Staging Directories, and Bulk File Naming Conventions....................................13
About Environment.......................................................................................................................15
About File Express Directories........................................................................................................15
About the File Express Client Main Window.................................................................................. 18
Window Elements.................................................................................................................... 19
Menu Bar................................................................................................................................. 19
Toolbar.....................................................................................................................................20
File List..................................................................................................................................... 21
Working with the File List.................................................................................................... 22
Moving Columns................................................................................................................. 22
Changing Column Widths................................................................................................... 22
Sorting the File List.............................................................................................................. 22
Information Fields.....................................................................................................................23
Status Bar.................................................................................................................................23
About Uploading Files to Mastercard.............................................................................................23
Getting Help................................................................................................................................. 24
Links and Browse Buttons.........................................................................................................24

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 12
Getting Started
About File Profiles, Staging Directories, and Bulk File Naming Conventions

About File Profiles, Staging Directories, and Bulk File Naming


Conventions
General descriptions are provided for file profiles, staging directories, and bulk file naming
conventions used in File Express.

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.

Bulk File Naming Conventions


The Mastercard Global File Transfer Management System has an established bulk file naming
convention. When retrieving files from Mastercard, you will see this naming convention in the
File Express Transfer Logs. Here is an example:
MCI.AR.T112.M.E0090000.D040928.T095115.A001

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 13
Getting Started
About File Profiles, Staging Directories, and Bulk File Naming Conventions

The date and time is when the data file was created in the Mastercard Global File Transfer
Management System.

Part Description

MCI High-level qualifier.


• MCI—Designation for the Mastercard production environment, which some test
files may use.
• YTF—Designation for the Mastercard test facility environment.

AR A two-character constant that identifies the Mastercard Global File Transfer


Management System.

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).

M Type of file transfer. In this example, M indicates Mastercard File Express.

E0090000 Endpoint number. An E (constant), followed by seven-digit endpoint number.


Within the Mastercard Global File Transfer Management System, the endpoint
represents a destination (address) in routing bulk files. When using File Express,
consider your file profile endpoints as individual mailboxes through which you can
exchange files with Mastercard.

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 14
Getting Started
About Environment

About Environment
Select the production or test environment when you log in. The environment selected
determines whether the files are going to be exchanged with the Mastercard production
environment or the Mastercard Test Facility environment.

Production Environment
After selecting the production environment, you can exchange production files or retrieve
archived production files from Mastercard. The file profiles established as per the user ID
determines which production files are available to you. The file profiles for the user are set up
to include the endpoints and bulk types as per access requirements. After the file profiles are
established by Mastercard, you can exchange files with Mastercard production applications.

Member Test Facility Environment


The Mastercard Test Facility 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 the Customer Implementation Services
team.

About File Express Directories


The File Express directory structure is created during its startup process and includes staging
directories to manage file exchange, a report directory, and a log directory.
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,

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 15
Getting Started
About File Express Directories

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

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 16
Getting Started
About File Express Directories

• 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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 17
Getting Started
About the File Express Client Main Window

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)

About the File Express Client Main Window


File Express Client provides a user-friendly interface to help you exchange files.
The main window contains standard window elements such as a title bar, menu bar, toolbar,
and the Minimize, Maximize, and Close control buttons. The File Express Client main window
may look similar to the following illustration.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 18
Getting Started
About the File Express Client Main Window

Window Elements
File Express Client provides common window elements that you can use to access the
application commands.

Window Element Description

Menu Bar Provides commands that you can use to perform tasks in the File
Express Client application

Title Bar Displays the name of the 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

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 19
Getting Started
About the File Express Client Main Window

Menu Bar
Commands Description

Proxy Includes a command to configure Proxy Settings

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

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

Select All Selects all check boxes in the file list

Clear Selections Clears all check boxes in the file list

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 20
Getting Started
About the File Express Client Main Window

Toolbar
Button Label Description

Refresh Files Establishes a connection to the Mastercard File


Express server and refreshes the file list

Transfer Selected Files Transfers selected files

Reports Allows you to preview and print the file session


report

Help Accesses online Help

When using the toolbar, keep in mind:


• The Transferable Files View and File Profiles View buttons work as a “view criteria” group.
When you click one of these buttons to perform a task, the button you selected appears
disabled.
• The Download View, Upload View, and Archive View buttons are “view criteria” buttons
and also work as a group. When you click one of these buttons to perform a task, the
button you selected appears disabled.
These two groups establish the view criteria for the file list. By default, File Express Client
opens in the Transferable Files and Download view criteria.

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

Select Allows you to select the files you want to exchange

Status Displays the Fail status when a file does not transfer successfully. Fail is the
only status that displays in this column

Index Displays the numeric index for each file list

Title Displays the file’s bulk type and a brief description

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

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 21
Getting Started
About the File Express Client Main Window

Column Description

FileName Name of the file

FileSize Indicates the size, in bytes, of the file

FileType Indicates the bulk file type

You can change the appearance of the file list by resizing and moving columns, and by
changing the sort order of the file list.

Working with the File List


When working with files that display in the File Express Client file list, keep these tips in mind.
• Click the Select All button to select all of the files in the file list.
• Click the Clear Selections button to clear all the check boxes in the file list.
• Files that have been transferred successfully cannot be transferred again during the current
session.
• You can verify that the download was successful by viewing or printing the file session
report. To view or print the file session report, click the Reports button.
• You should remove files from the downloaded subdirectories as soon as you process the
files to ensure there is always sufficient disk space available for File Express Client.

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.

Changing Column Widths


To adjust the width of the columns in the file list, position the pointer on the right border of
the column you want to resize. The pointer becomes a double-headed arrow when you move
it over the column border. Drag the border with your mouse to the size you want.

Sorting the File List


You can sort the file list in ascending or descending order. To change the sort order of the file
list, follow these steps:

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 22
Getting Started
About Uploading Files to Mastercard

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

Current Endpoint Current endpoint the user is using

Selected Environment Mastercard server’s URL for the selected environment when login
(Production/Test) and Server URL

IP Address Mastercard server’s IP address

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.

About Uploading Files to Mastercard


There are several ways to add files to the upload file list view.

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.

Add File Feature


You can add files from any directory residing on a drive accessible by the File Express Transfer
Engine Windows service using the Add button on the right side of the upload file list. Files
added using this method are available only for the current session.
With this method, the source file remains in its original directory (that is, the source file is not
moved to your Upload directory). It is important to note that when File Express Client uploads
files using this method, as with files in the Upload directories, it will create a sent directory in

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 23
Getting Started
Getting Help

the original directory and move the file to the sent directory. Therefore, File Express Transfer
Engine Windows service will need to run under a Windows user ID with appropriate
permissions to create the sent directory and move the uploaded file.
For steps to use the Add File feature, go to Adding Files.

Refresh Files Feature


While File Express Client is running, you can add files to the file type Upload directories. When
you refresh the file list, these files will be added to the file list.
For steps to use the Refresh Files feature, go to Refreshing Files.

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.

Links and Browse Buttons


Links and browse buttons make navigating in online Help easy.
• Links allow you to go to another topic or location quickly.
• Use the browse buttons in Help to view topics in the sequence in which you opened them
for the current session.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 24
Exchanging Files with File Express Client

Chapter 3 Exchanging Files with File Express Client


This section provides information about starting the File Express Client user interface, configuring a
proxy server, exchanging files using File Express Client and customizing your staging directories

Starting File Express Client............................................................................................................ 26


Configuring Proxy Server Settings................................................................................................. 26
Downloading a File from Mastercard.............................................................................................30
Uploading a File to Mastercard......................................................................................................31
Adding Files.................................................................................................................................. 32
Refreshing Files............................................................................................................................. 33
Retrieving an Archived File............................................................................................................ 34
Performing Multiple File Exchanges............................................................................................... 34
Viewing File Profiles...................................................................................................................... 35
Using View Criteria....................................................................................................................... 35
Changing a Staging Directory....................................................................................................... 36
Using Multiple Endpoints.............................................................................................................. 37
Selecting the Initial Endpoint at Startup.................................................................................... 37
Selecting an Endpoint During the Current Session.................................................................... 38

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 25
Exchanging Files with File Express Client
Starting File Express Client

Starting File Express Client


If you are a new or an existing File Express Client user and are not connecting to a proxy
server, follow these steps to start File Express Client.

Before you begin


To transfer files with File Express Client, you must use your Mastercard Connect™ System User
ID and SecurID® token. If you do not know your Mastercard Connect System User ID, log into
Mastercard Connect™ and in the Welcome drop-down list, click Profile. At the top of the
Profile window, you will see your System User ID.

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 Client icon on your desktop.
– On the taskbar, click Start > All Programs > Mastercard Worldwide > Mastercard
File Express > File Express 7 Client.
File Express Client starts and displays the Client User Login dialog box.
2. In the Environment drop down box, select the required environment (Production or Test).
Only endpoints and file profiles provisioned to your user ID for the selected environment
will be available after login. You need to exit out of File Express Client to switch to another
environment.
3. In the User ID box, type your Mastercard Connect System User ID.
4. 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.
5. 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.

Configuring Proxy Server Settings


If you are a new File Express user and you are connecting to a proxy server, you will need to
work with your network administration team to determine the proxy server name, port
number, login name, and password required to establish a connection to the public Internet.
After you obtain the proxy server parameters from your network administrator, follow these
steps to configure the proxy server. The same setting applies to both Production and Test
environments.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 26
Exchanging Files with File Express Client
Configuring Proxy Server Settings

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 27
Exchanging Files with File Express Client
Configuring Proxy Server Settings

Results
The File Express Client main window opens with View Criteria set to the endpoint you
selected.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 28
Exchanging Files with File Express Client
Configuring Proxy Server Settings

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 29
Exchanging Files with File Express Client
Downloading a File from Mastercard

Downloading a File from Mastercard


To download a file from Mastercard, follow these steps.

Procedure
1.
Click the Transferable Files View button.
2. Click the Download View button.
The file list displays the files that can be downloaded from Mastercard.

3. Select the check box next to each file you want to download.
4. 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.
5. 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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 30
Exchanging Files with File Express Client
Uploading a File to Mastercard

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.

Uploading a File to Mastercard


To upload a file to Mastercard using the user-defined staging directory, follow these steps.

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.
Click the Transferable Files View button.
4. Click the Upload View button.
Any file you placed in the corresponding Upload directory displays in the file list.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 31
Exchanging Files with File Express Client
Adding Files

5. 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.
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
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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 32
Exchanging Files with File Express Client
Refreshing Files

Procedure
1.
Click the Transferable Files View button.
2. Click the Upload View button.
3.
Click the Add button on the right side of the upload file list.
The Add File to Upload dialog box appears.

4. 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.
5. 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.
6. Repeat steps 5–6 for each file type you want to upload.
7. 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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 33
Exchanging Files with File Express Client
Retrieving an Archived File

Procedure
1.
Click the Transferable Files View button.
2. Click the Upload View button .
3. 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).
4. Click the Refresh Files button.

Results
Any new files placed in a file type Upload directory will display in the upload file list.

Retrieving an Archived File


To retrieve a file you previously downloaded from Mastercard, you can use the Archive View
button to view a list of files that have been downloaded previously, and then download the
file again. To retrieve an archived file, follow these steps.

Procedure
1.
Click the Transferable Files View button.
2. Click the Archive View button to display a list of files that have been previously
downloaded.
3. Select the check box next to each archived file you want to download.
4. 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.
5. 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.

Performing Multiple File Exchanges


Using File Express Client, you can select files for multiple downloads and multiple uploads for
sequential transfer with Mastercard. This allows you to start all of the requested transfers at
one time. To initiate multiple downloads and uploads for sequential transfer with Mastercard,
follow these steps.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 34
Exchanging Files with File Express Client
Viewing File Profiles

Procedure
1. Click the Download View button.
2. Select the check box next to each file you want to download.
3. Click the Upload View button.
4. Select the check box next to each file you want to upload.
5. 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.
6. 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.

Viewing File Profiles


Your file profile is specific to your Mastercard Connect System User ID. File profiles that display
in the file list depend on the environment selected during login and the view criteria you
select. To view a file profile for your current view criteria setting, follow these steps.

Procedure
1. Select the appropriate view criteria button:
– Download
– Upload
– Archive
2. 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.

Using View Criteria


You can use the View Criteria dialog box to quickly select the content that displays in the file
list. To display the View Criteria dialog box, follow these steps.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 35
Exchanging Files with File Express Client
Changing a Staging Directory

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.

Changing a Staging Directory


Staging directories are maintained on an individual user basis. When a single workstation is
used by multiple File Express users, each user can maintain their own custom staging directory
for each bulk type they are profiled to exchange. To change a file profile’s staging directory,
follow these steps.

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 you select when logging in and view criteria you select (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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 36
Exchanging Files with File Express Client
Using Multiple Endpoints

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.

Using Multiple Endpoints


With File Express Client, you can perform file transfers for one or more endpoints; however,
you are limited to working with one endpoint at a time.

Selecting the Initial Endpoint at Startup


When you start the File Express Client application and connect to the Mastercard File Express
server, the Select Endpoint dialog box displays with the multiple endpoints configured in your
user profile. If you are not configured for multiple endpoints, this dialog box will not appear.

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 for the environment you selected when login.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 37
Exchanging Files with File Express Client
Using Multiple Endpoints

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.

Selecting an Endpoint During the Current Session


After completing file transfers for the current endpoint, you may want to transfer files for
another endpoint. To select another endpoint for file transfer, follow these steps.

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 38
Reporting

Chapter 4 Reporting
This section provides information about the session report (File Express Client only), audit reports,
transfer log reports, and report retention configuration.

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

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 39
Reporting
About File Express Reports

About File Express Reports


File Express provides three reports containing information about file transmissions.
• Session Report—The session report is available for the current file transfer session. This
report provides information about successful and unsuccessful file exchanges that occurred
during the current transfer session. (This report is not saved in a file and is only available
using File Express Client.)
• Audit Report—The audit report is saved in a file after each completed file transfer session.
By default, audit report files are retained for 10 days (maximum retention time is 100 days).
• Transfer Log—The transfer log displays the results of all file transfer sessions for a single
day. The transfer log is stored in a file and contains information about the run time activity,
number of files transferred, and status information. By default, transfer log report files are
retained for 10 days (maximum retention time is 100 days).
A file transfer session consists of File Express Client’s attempt to connect to the Mastercard File
Express server and exchange files.
The session and audit reports are divided into two sections: one for downloaded files and one
for uploaded files. Within each section, file transfers are then grouped by successful transfers
and unsuccessful transfers. The fields on the report are duplicated for each section.

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 40
Reporting
About File Express Reports

Report Description
The following table provides a brief description of the session report.

Purpose The session report is used to verify file transfers.

Frequency The user may view or print this report at any time during a file transfer
session.

Responsibility The user is responsible for accessing this report.

Distribution This report is distributed at the user’s discretion.

Field Definitions
The following table describes the fields on this report.

Field Description

Title Title of the transferred file

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 41
Reporting
About File Express Reports

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

File Size Size, in bytes, of the transferred file

End Point File Express endpoint for the file transferred

App Bulk type

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 42
Reporting
About File Express Reports

Report Description
The following information provides a brief description of the audit report.

Purpose The audit report is used to verify file transfers.

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.

Responsibility The user is responsible for accessing this report.

Distribution This report is distributed at the user’s discretion.

Field Definitions
The following table describes the fields on this report.

Field Description

Title Title of the transferred file

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 43
Reporting
About File Express Reports

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

File Size Size, in bytes, of the transferred file

End Point File Express endpoint for the file transferred

App Bulk type

Total Files Number of files that were downloaded and uploaded, both successfully
and unsuccessfully

Transfer Log Report


The transfer log report displays the results of all transfer sessions for a single day. Each transfer
log represents the chronological order of your transfer sessions. You can select, preview, and
print a specific transfer log report. You also can change the number of days that transfer logs
are retained (maximum retention is up to 100 days).
A transfer log looks similar to the following illustration.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 44
Reporting
Printing a Session Report

Log entries include:


• Transfer date and time
• If the transfer was successful or unsuccessful
• Endpoint of the file transfer
• Bulk type
• Source file
• Target file (for downloaded files)
• File size
For information about retention configuration, go to Changing Retention Configuration.

Printing a Session Report


A session report is created when at least one file exchange has been attempted during the
current session. To print a session report, follow these steps.

Procedure
1. Click the Reports button .
The Session Report window displays the current transfer session.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 45
Reporting
Printing an Audit Report

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.

Printing an Audit Report


If there were one or more file exchanges attempted during your current session, an audit
report will be created at the end of the session. To preview or print an audit report from a
previous session, follow these steps.

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.

Printing a Transfer Log Report


A transfer log report displays the results of all transfer sessions for a single day. To preview or
print a transfer log report, follow these steps.

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 46
Reporting
Changing Retention Configuration

Changing Retention Configuration


By default, File Express retains audit reports and transfer logs for 10 days. You can change this
default so that these reports are retained for up to 100 days. To change default retention
configuration settings, follow these steps.

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 47
Notices

Notices
Following are policies pertaining to proprietary rights, trademarks, translations, and details
about the availability of additional information online.

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.

Information Available Online

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.

©2005–2017 Mastercard. Proprietary. All rights reserved.


File Express Client User Guide—v.7.1 • 26 September 2017 48

S-ar putea să vă placă și