Skip to main content

Using the PDS MESH service with the MESH user interface

Search the Personal Demographic Service for patient details with the MESH UI using the PDS MESH service.

Overview

PDS MESH, formerly known as the Master Patient Trace (MPT) service, allows you submit partial details of a patient's demographic information and receive the full set of information held for that patient.

PDS MESH searches the Personal Demographic Service (PDS) for these patient details using the MESH user interface (MESH UI). The MESH UI is a browser-based interface that requires no software installation, designed for non-technical users.

This page describes PDS MESH that replaces the existing MPT product, which is no longer available for new users.

This page explains how to:

  • request PDS access

  • access the MESH UI and your MESH mailbox

  • create a file containing the trace request

  • send the trace request to PDS

  • download the trace request response

  • troubleshoot any problems

Request PDS access

Before you can access PDS, you must complete a PDS access request form describing your purpose and use case, and get it approved.

Access the MESH UI

Once you have approved PDS access, you need a MESH mailbox. To get a mailbox, use the MESH mailbox request form and specify under 'Your data usage' that the mailbox needs to be an 'Initiator of the workflow group "Master Patient Tracing System"'.

Once you have a MESH mailbox, you can access the MESH UI, with either a Health and Social Care Network (HSCN) connection or via the internet:

  • HSCN connection - use a smartcard connected to HSCN.

  • internet - use your PIN number and a one-time passcode - you must have an email address that ends with @nhs.net, @nhs.uk or @gov.uk.

Access the Master Patient Tracing service as follows:

Your MESH UI mailbox appears which looks something like this:

MESH UI mailbox

Create a file containing the trace request

Your trace request must be in the form of a comma separated value (CSV) file prepared with Microsoft Excel or similar.

You must name the CSV file with the following naming convention:

MPTREQ_CCYYMMDDHHMISS.csv

where

  • MPTREQ_ means it’s a PDS MESH request

  • CCYYMMDDHHMISS is the timestamp of the request - CCYY is the year, MM the month, DD the day, HH the hour, MI the minute and SS the second

  • .csv is the file extension

For the full structure of the request file and the response file, see PDS MESH.


Sending the trace request to PDS

Creating a new message

Create a new message and fill in the fields as follows:

  • for ‘Select Message Type’, choose ‘Master Patient Tracing Service (SPINE_PDS_MESH_V1)

  • for ‘To’, choose ‘INTERNAL SPINE - INTERNAL SPINE’

  • for ‘Attach a document’, select the CSV file for your trace request 

  • click the Submit button to send your trace request


Checking for replies to the trace request

Check your MESH inbox for replies. Press F5 to refresh your inbox display.


Download the trace request response

Once you receive a reply in your MESH inbox, click on the download button next to the message to save the file to your local machine. 

The response file is named RESP_ followed by the name of your original CSV trace request file.

To interpret all the values in a trace request response, see the data dictionary.

For example, a single patient CSV response file looks like this:

MPTREQ_20210802171059,SPINE_MPT_RESPONSE,1,00

	02403456-031f-11e7-a926-080027a2de00,9990554412,XXTESTPATIENT-THHX,DONOTUSE,,1,19380803,,C/O NHS DIGITAL TEST DATA MANAGER,SOLUTION ASSURANCE 1 TREVELYAN SQ.,BOAR LANE,LEEDS,WEST YORKSHIRE,LS1 6AE,Y90001,,,,,,0723444447,[email protected],N,,00,9990554412,1,100,0,0,0,0,0

Troubleshooting problems

Problem Solution
Sent message data says 'Acknowledged' but no reply Spine has processed your request and replied.
If you can't see a reply, use F5 to refresh your MESH inbox display.
Sent message data says 'Accepted' but no reply You sent your message successfully. Check again later.
No reply in the first 2 hours     Response time varies depending on the time of day you submit the file, and the number of patients you request a trace for in a single CSV file.
No reply after 2 hours Raise an incident with Spine including your Message Id as shown in your MESH mailbox Sent folder, with our National service desk by emailing [email protected].

 

Last edited: 16 February 2023 3:33 pm