Using abbreviations

Choosing from the menu Special > Abbreviations allows you to enter directions quickly and accurately when dispensing medicines.

It is worth mentioning that abbreviations may also be used in other situations - e.g. if a significant number of customers live in the same locality, an abbreviated form of their address could be employed. Such abbreviations are created in the same way as described below.

As usual, you can sort the list by clicking on the column headers

Double-click an abbreviation to edit it.

Click the New button to add a new abbreviation.

Type an abbreviation and the text that it will expand to.

Click the Report button to construct a simple report listing all abbreviations. This report can be previewed or printed.

When you are issuing an item you can mix abbreviations and your own text to add common directions quickly.

Do not use actual words as your abbreviation, or else attempting to type the word will result in the expanded text appearing on your label!

If you change an abbreviation or add a new one, you will see the change immediately (v317 or later), but in a multi-user environment other users will have to log out and log in (use Switch user to do this quickly) to see the edited or added abbreviations.

Importing abbreviations...

The procedure for importing a file containing your abbreviations will be found here.

Printing a list

From the abbreviations window, click the Report button.

  1. Double-click on Abbreviation
  2. Double-click on Expansion
  3. Right-click on Detail and set font size to 8 or 9
  4. You can use the lines on the column headers to adjust column width
  5. Choose File > Generate to print the list

Item Default Directions

Once you have entered abbreviations, don't forget to enter the default directions for all common items. Instructions are here

Previous: Prescribers Next: Printing Preferences

2011/04/19 07:23 · craig

Dispensary mode

Dispensary mode allows you to use mSupply to issue medicines to patients. It is ideally suited for pharmacies, clinics, hospital dispensaries, and facilities where medicines are supplied to individual patients.

The particular benefits of using Dispensary mode include:

    • Item description and quantity issued
    • Patient name
    • Prescriber name
    • Directions
    • Institution name
    • More…
  • Use of Dispensary mode depends on your mSupply registration type. Contact Sustainable Solutions if you wish to upgrade your registration.
  • Regardless of mode, each user can only use those functions for which they have permission, according to the permissions set for that user. See Managing Users
  • In client-server versions of mSupply, different users can be logged in in different modes at the same time, allowing you to dispense to patients and supply wards, stores, clients or cost centres simultaneously.
  • Users whose permissions allow them to operate in either Store mode or Dispensary mode may change from one to the other by pressing Ctrl+2 on the keyboard. Re-entry of the user's password is not necessary.

Prior to version 3.5 you controlled dispensary mode for each user, and had to choose File > Edit users…
Now it's a setting for a store.

  1. Choose Special > Show stores…
  2. Double-click on the store you want to set to dispensary mode.
  3. Select Dispensary in the drop down list next to the store's code field. When you log out of the store and back in, you'll be in the new mode.
  • Choose File > Preferences > Invoices 2 then check the Show direction entry in dispensary mode box.

What is a "name"?

In mSupply a “name” can be a customer, a supplier, both or neither. A “customer” can be anyone you supply goods to - e.g. another organisation, or a ward in your hospital, or a patient.

What changes in Dispensary mode?

Different menus

Some of the menus in dispensary mode have different names. For example, the Customer menu becomes the Patient menu.

But most of the things you can do in store mode are also available in dispensary mode. In fact, the navigator looks much the same. The only difference is the Customers tab, which is renamed to the Patients tab and has a slightly different selection of icons:

The functionality of the common icons is the same as in store mode and applies mostly to customers not patients (a dispensary mode store can still distribute stock to customers (not patients) and handle customers' requisitions). For details of those functions, see the other sections of this guide.

Different windows

The windows displayed are appropriate for dispensing medicines to individual patients; in addition to the ability to record individual patient's notes (e.g. allergies), prescribers details are maintained. A patient history is maintained and other features specifically related to dispensing activities are maintained.

Prescription entry

In dispensary mode, supply of items is made against a patient's prescription rather than an invoice as in store mode. Click on New prescription from the menu bar to display the prescription entry window:

How to look up a patient on file

When you are entering a patient name, mSupply will treat anything entered before a comma as a last name, and anything entered after a comma as a first name.

  • For example, to find John Smith, enter “Smi,J” or “smith,joh”
  • If the patient's name code is known, enter a “*” (no quotes) and then the name code or part of it. eg “*58298”

In the Name field (screenshot above) enter your patient's name, or even just part of their name, for example, 'Sn, R' for 'Rick Snail' - so just part of the patient's last name, comma, and then their first initial, and then press the tab key.

If your patient is already loaded in the system, then this entry should bring up the patient in question, or a list of patients for you to choose from.

  • Always search for your patient in this way first, before entering a new patient, to avoid entering the same patient multiple times.
  • If there is more than one matching name, you are shown the name choices window

  • Once you have found the correct patient, double-click the appropriate line, and then click Use.
  • If the patient is not already stored in mSupply you'll need to add a new patient. How to do that is described here

Editing patient details

Once you have chosen a patient, you can click the small down-arrow to the right of the patient name to display a window where the patient details can be edited (see below):

Clicking the Print icon at this point will give you access to reports showing all prescription history.

Entering the prescriber

Once you've chosen a patient, the cursor will automatically advance to the prescriber entry field.

To enter a prescriber, you can type either their code, their last or first name in full or abbreviated, or “last comma first”. For example for the prescriber Dr Felix Brown (whose code is 123) any of the following are acceptable:

  • 123
  • bro
  • fel
  • bro,fe

Press the tab (not 'return') key after making the entry to show a list of matching prescribers. If only one presciber matches, the name will be entered directly without the list being shown.

Note that there is a setting on the Dispensing page of the mSupply Preferences that affects whether or not you can accept and print a prescription without entering a prescriber.

Entering prescribed items

On the Prescription entry window click on New line , and Add item window appears.

Once the item name and quantity have been entered, provided that the Show direction entry in dispensary mode option has been selected in Preferences, directions on how to take the medicine should be entered.

Patient Events

This is the term mSupply uses to denote any item of information relating to a particular patient; for example, you may want to record the patient's weight, the patient's blood pressure, any allergies from which the patient suffers, vaccination records, etc. - a wide range of information relating to a particular patient may be recorded here.

First, some definitions of patient events need to be made;choose Patient > Show Patient events , then click the New button.

One patient event is already defined, the code is `NT', the description is `Note', and the type is Text ; you can also have events of type Numeric or Boolean . For example, to create a patient event recording a patient's weight, the completed Add patient event window would look like this:

A further example, this time using the Boolean type - i.e. where the options are limited to two, `Yes' or `No' - could be to identify patients who have insurance cover to meet the cost of their prescriptions; for this event, the Add patient event window, once completed, would appear like this:

Once a number of patient events have been defined, choosing Patient > Show Patient events, will produce a window like this:

Now it is possible , using the Notes tab of the patient details window, to add individual items of information to the profile of any patient.

View the record of the patient in the normal way (from Patient > Show Patients, enter the patient's name & double click the appropriate patient from the 'names output' ) , and select the Notes tab. Click on the Add event button to bring up the window shown above.

In the Event field, Search event type appears by default. To display all the events you have defined so that you may choose the one you require, enter the character “@” (without the quote marks), press the TAB key, and make your required selection from the list.

Alternatively, you may enter a word from the description of the event - e.g. if you have defined Patient's body weight as an event, you may enter the start of the event name or code (e.g. pat ), and that event will appear in the Event field. If more than one event matches what you have entered, a list will displayed for your to choose the event you want to enter.

Should you wish to add any note or comment, you may do so by moving the cursor into the Note area, clicking, then typing your entry. You can customise the note in terms of when it will be displayed on screen etc. as described in the Items chapter of this guide. Here's the link - The Notes tab.

After a period of time, a patient's notes may look like this:

The default view shows all patient events, but you have the ability to vew single events by selecting the event code from the drop down menu Patient events under Show

A new event may be added by clicking on the Add event button, and an event which is no longer of any relevance may be deleted by clicking on the Delete event button.

Events may be edited by selecting the specific event, double clicking on it, when the Edit patient event window appears.

Entering directions

For many commonly prescribed items, default direction abbreviations can be defined - refer to the section on Item Default Directions. In the example below, the item being dispensed is FRUSEMIDE 40mg tablets, and the default directions are “Take ONE tablet in the morning”. Alternative directions present may be displayed by clicking on the down arrow to the right of the abbreviated direction field; directions not already present may be typed in using either the Abbrev entry area, or the Expanded entry area.

Note that you can mix abbreviations and text like this.

The drop-down list shows any default abbreviations you have entered for the chosen item. If one or more default abbreviations exists, the highest priority default abbreviation will be 'suggested' when you choose the item. If there is more than one standard abbreviation available, you can choose another one by choosing it from the drop-down list.

mSupply stores the expanded text for each line, not the abbreviation. This means that there is a full audit trail of what was printed on the label (unless you edit the directions after printing!).

Default directions

The set up of default directions is done on the dispensing tab when editing an item. You will find it described here.

Patient labels are printed when the Print labels option is checked in the Prescription Entry window. Sample labels, produced by the Zebra TLP2844 printer are reproduced below:

mSupply currently is designed to work with the Zebra TLP 2844 label printer. The Zebra is a very nice printer. It can use either thermal labels or a thermal ribbon which gives non-fading results.

We currently support plain 90 x 40mm label stock as this is cheap and readily available. The Zebra printer is auto-sensing of the ending of a label, so you can most likely used labels longer than 40mm with no problems.

  • Label specifications:
  • 90mm x 40mm high
  • White Matt Thermal Transfer Paper
  • Wide Edge Leading
  • 1 Across on a roll
  • Perforation between each label
  • Produced on 1“ core to suit TLP2844

We are happy to support other printers if you use a different brand.

Reprinting labels

If you need to print the labels for an item again, choose Patient > Show Prescriptions to locate the prescription entry.

In the list of items dispensed, click on the line you wish to reprint, and then click OK (with the printing checkbox checked)

If you wish to reprint labels for all the items on the prescription, first click in the list of items below the last item so that now one item is highlighted. Then all labels will be preinted when you click OK

Entering a new patient

To enter a new patient:

  • In the Prescription Entry window, click the New Patient icon to the left of the name entry area. This window will be shown (Shortcut: Ctl-Shift-P). All entry fields are blank, except for the Code field where the entry shown is the next number in the table of unique numbers applied to each individual patient.

  • Code and Last are required fields but all applicable fields should be completed.
  • Please note - the patient code will only appear if this setting has been selected in Preferences.

If the new patient's date of birth is known, it should be entered, otherwise an entry should be made in the Age field; for a patient aged 18 months, valid entries in the Age field may be in one of 3 formats, namely 18m, 1.5, or 18/12.

  • When a patient's code is known, that patient's record may be rapidly displayed. Note also that the Male radio button is checked; if you are entering details of a female patient, remember to check the Female radio button!.
  • Custom fields are available for storing information such as insurance details etc.

Printing multiple labels

If you want to print more that one label for an item, hold down the Alt key ( Option on Mac) as you click the OK button. You will be asked for the number of labels required as the label is about to print.

What if there is not sufficient stock of one batch?

As the quantity of a particular batch of an item gets used up, you will need to issue stock from more than one batch to a patient. mSupply handles this when printing labels, and combines the totals for any item on a prescription so that only one label is printed for the total quantity.

The directions for the item with the first line number will be used, so enter directions for the first batch you dispense, and leave the directions empty for subsequent batches.

Note: if you have the rare situation where you need to issue the same item to one patient with different directions you should either combine the directions onto the one label, or enter two prescriptions with the directions entered differently on each prescription (That is enter the line, then print the label(s), then choose Patient > New prescription and issue the item again with the second set of directions).

In the new prescription entry window, once you have entered a patient name you can click the “history” button to view a patient's history of what you have dispensed.

Duplicating a prescription

Once you have a history window open you can click to select a single entry or control-click to select multiple entries, then click the “duplicate” button to create new prescription line(s) with exactly the same details. Stock will be issued for these lines automatically.


mSupply allows for the recording of repeat prescription. This is achieved when the prescription is first dispensed; in the Add item window, click on Total field in Repeats box in the top right corner of the window, and enter the number of repeats that the prescriber has authorised. The Repeat Dispensing procedure is described here.

While dispensing, you may observe that a patient has been inadvertently entered twice.

When the Choose patient window appears, you need to highlight the two patients to be merged, then clicking on the Merge button displays this window:

Here you need to decide which record should be kept, and which one should be merged, and check the appropriate radio buttons. This combines the information in the record to be merged with the information in the record to be kept.

You can view a patient's details on-the-fly as you enter a prescription as described above. You can also view patients by choosing Patients > Show patients.

Enter the details you want to search for and click Find

You will be shown a list of matching entries, or taken directly to the detail view if only one patient matches the values you entered.

Patient history tab

The details displayed are similar to displaying a customer in store mode. However there is also a history tab that shows each item dispensed. Double-clicking an item in the list will display the transaction in a new window.

The Repeats panel (upper right of the window shown below) allows details of repeat prescriptions to be recorded. Take the example of a patient presenting a precription for Frusemide 40mg tabs x 30 on 1st January 2007, with the prescriber requesting “Repeat monthly x5”; in the Total field you should enter “5”, and in the Expiry Date field you have the option of entering (a) the actual date on which the final repeat may be issued - in this example, “1 July 2007” (allowing the patient one month's grace) - or (b) “6m” for 6 months. Note that the characters “D”,”W“ & “M” in upper or lower case are interpreted in this particular field as the specified number of days, weeks or months before the repeat instruction expires. mSupply defaults to an expiry date two months later than the current date, but this may be edited as appropriate. The system automatically updates the number of repeats remaining as the patient makes further visits to have the repeats dispensed. The window below is displayed when you click on the New line in ” Prescription window

The number of repeats is assigned in Total field in Repeats box, and as the repeats are dispensed, the number remaining is displayed in the Left field.

When you click on the blue arrows on the upper right side ,the total repeat number and total quantity for each repeat is shown. Clicking on the small arrow displays the window below.

This window allows the user to alter the quantity of a particular repeat - e.g. if there is insufficient stock on a particular visit of the patient; the quantity can be edited by clicking on the quantity line, and again clicking on the quantity, which may now be edited. The arrow on the left bottom corner enables you to restore the default quantity setting.

Once you have filled repeat and other details on the Add item window properly, click on OK button to save details .

The Repeats icon is contained in Prescription entry.

When the Repeat function is used, and there are future repeats to be issued, the icon appears on a red background:

The red background disappears when either:

  • expiry date is reached
  • all repeats have been dispensed

You can issue the repeat to a particular patient. Clicking on the Repeats icon displays this window:

The repeat window shows items to be dispensed, quantity, total repeats, repeats remaining and expiry date for a particular repeat. Process repeats and OK button are described below.


Click OK button to exit from the Repeats window

Process repeats

This button is used to issue the repeat for a particular patient and for a particular item line. For issuing the repeat, first select a desired item line and then click on the Process repeats button. Now the system automatically manages the repeats internally.

When the Print Receipt option is checked in the Prescription Entry window, the printer will, after printing the medicine labels, produce a patient receipt as shown below.

Should you wish to use a different printer for receipts, this option can easily be incorporated in mSupply if you advise us of your requirements.

Notes display

Any notes/events you enter in the notes tab will display each time you enter the patient name in the Prescription entry window. These notes can be used to remind you of patient Preferences for certain dosage forms, or drug sensitivities.

Before you add an event for a patient, you need to make sure that patient events have been set up.

Previous: Exporting records Next: Prescribers

2011/04/19 07:20 · craig

Patient medication records

Added: Version 3.11

A Patient Medication Record (PMR) is a way of recording all the medications a person is using, whether or not they were dispensed by you. The record contains useful information for the patient such as

  • The dosage in a clear easy-to-understand format.
  • An (optional) picture of the dose form (tablet, capsule, etc)
  • The medication's purpose.
  • Common instructions for taking/using the medicine, which may be customised for each patient

Before adding items it is good to set up the standard purpose, instructions and item photo for common items at least. Once set up, you can add these to a particular patient's PMR with just the click of a button.

  1. Find the item you are interested in and go to the dispensing tab
  2. Enter purpose and instructions. Both these fields can take as much text as you wish to enter.
  3. Add a photo by either dragging a photo from another application or pasting a photo from the clipboard.

mSupply will automatically resize large photos when you add them- there is no need to resize photos yourself first.

There are 2 ways of adding items to a PMR

  1. From the patient history tab:
    • Highlight the items from the patient's history you wish to add, then click the Add to PMR button.
    • The record will be shown on the “PMR” tab if you switch to it.
    • Note that on the PMR tab you still have to double-click on the added record and fill in the dose, instructions etc.
  2. From the Patient details PMR tab
    • Here you can add any item that is in the mSupply catalogue.
    • For example, a patient might be regularly taking paracetamol or aspirin that they buy themselves. You can add such items here.
    1. To add an item, click the Add item button. You will be shown a new window:
    2. Item name: type the start of the item name and press <tab>, then select from the list
    3. Dosage: Enter the number of tablets/drops/whatever to be taken/administered morning, noon, evening and bedtime.
    4. Purpose: If the item has a purpose entered, click the copy button to copy it to the right-hand box. Here you can edit the details if you want to.
    5. Instructions: If the item has instructions entered, click the copy button to copy them to the right-hand box. Again, you can edit the details if you want to.
    6. Click OK when you're done, or cancel if you decide not to add a record.

Editing a PMR record: Double-click the entry you wish to edit, change details, and click OK to save the changes and close the window. Deleting a PMR: Highlight the record(s) you wish to delete, then click the delete button. (Do be careful- it's not reversible!)

Setting up printing preferences

When a PMR is printed, it has a header and footer. These are set up by choosing File > Preferences and then clicking the Patient Medication tab.

Note that you can style the text in these boxes by selecting text and right-clicking on your highlighted text to get a contextual menu to apply font styles, colour and size.

Printing a PMR

Simply click the Print button. Note that you do not have to highlight records- all records will be printed.

Currently we have included a single PMR printing form in mSupply. We are happy to include others- send us your designs.

Previous: Warnings Next: Why an HIS module for mSupply?

2012/08/23 10:17 · craig


From the Special menu choose Prescribers

We were going to title this section “Managing Prescibers” but we all know that's not possible ;-)

When you are in dispensary mode, issuing items to a patient allows you to add a prescriber. This menu item allows you to set up your list of prescribers.

To add a new prescriber, click the “New” button.

Add a code for the presciber. You can use the code quickly to look upthe prescriber when dispensing.

Other fields are fairly self-explanatory. Note that the code, first name and last name can all be used for looking up prescribers when dispensing.


The text you put in the “Initials” field will print on dispensary labels.

Active status

If you have a prescriber that is no longer used, you can change their status to “inactive” and the prescriber will not show in the choice list when dispensing. Inactive prescribers will still show when you choose Special > Show Prescibers…

We suggest you might want to add a “Miscellanous Prescribers” item to the list, and use this if you have a lot of prescribers whose prescriptions you only dispense infrequently.


This field can be used to group prescribers together, and can then be used to filter prescribers when producing a transaction report.

Merge prescribers

This item from the Special menu is used to merge two prescribers, where the same prescriber has inadvertently been entered twice. You are shown a window like this:

Enter the two prescriber names by entering the start of their surname or their code, and then pressing Tab . The top prescriber is the one who will be kept. The lower prescriber will be deleted.

Once you have entered the two names, check the details are correct, and then click OK. You will be warned one last time, and then the operation will be completed.

All transactions that recorded the deleted prescriber will now show the name of the prescriber that was kept.

Import prescribers

For information on the procedure for importing a file containing your prescribers see Importing prescribers

Previous: Dispensary Mode Next: Abbreviations

2011/04/19 07:24 · craig

Label printing preferences

For setting up a label printer for the first time, see Label Printer Installation

Choosing this item from the Special menu shows the printing Preferences window.

The default printer is stored for each client computer - so each computer can be set to print to a different default printer. When you alter this setting, you are only altering it for the computer you are working at

To change the default printer, simply click the checkbox in the right-hand Default Printer column on the row of the printer you wish to use.

  • click the New Printer button
  • Double-click the printer in the list.

  • Description Here you give the printer a name
  • Connection type
    • If you are connection with a network cable (recommended) choose network
    • If you are connecting with a serial cable choose serial
    • If you are connecting with USB choose USB
  • Port number For network connections this will usually be 9100
  • IP Address- the address of the printer e.g.
  • Label dimensions Enter width, height and margins in m.m.
  • Make this printer default - Checking this box means that the computer you are using will always print to this printer.
    • Important: this setting is “per computer” - you need to set each computer to have a default printer.
  • Reset printer You can use this button to send a command to the printer to reset it. Occasionally a printer may misbehave if it's memory is corrupted by an electricity spike or the like, and this button may help. If your printer is not behaving we recommend you contact Sustainable Solutions rather than charging ahead on your own.

 Printer USB Setup

Once your chosen computer is set up and installed, go to Special > Printing Preferences > Add new to add a new printer.
Set up the window as follows:
Description: name of the printer, used by users to identify it
Connection Type: USB
Address: the Windows name of the printer. This can be found in Control Panel > Printers and Scanners. This must be accurate as it is used to identify your printer. The name is written in the Printer properties inside the general tab.

Printer Properties

Label Bottom Margin: margin between top label and lower labels
Bottom Left Label Width: width of bottom left label

Previous: Abbreviations Next: Warnings

2011/05/20 06:16 · craig

Printer Setup for Remote Desktop Client

In low bandwidth situations the mSupply client can become laggy and unstable, in these cases it may be recommended to use RDP through the Windows Server Remote Desktop Client application. If the site is dispensing and using a printer, this introduces some complicated steps.

At dispensary: - A computer with serial/com port and with RDP access to server - A Zebra printer with serial/com port

Server/machine that is remoted to: - mSupply Client installed and can connect to mSupply server - Windows server installed that has Remote Desktop Client

Setup the Remote Windows Server Machine

Use Windows Run to run tsconfig.msc and gpedit.msc.

- In the tsconfig window, right click on “RDP-Tcp” and click “properties”. Go to client settings and make sure that the COM port is unchecked in “Redirection - disable the following” list. - In the gpedit window, follow the hierarchy shown below and make sure “Do not allow COM port redirection” is disabled (not configured probably fine).

Setup the Local Machine

- The machine that you will be dispensing from needs to have the appropriate Zebra printer. - Check that your printer has a 9 pin serial/com port on the rear - Check your Computer also has a 9 pin serial/com port (right most port below).

- You can verify that the computer has detected its external ports via device manager

- Using a RS232 serial cable, plug the printer into the computer.

Caution: If you have a cable that has the female plug at both ends, it is likely a Null Modem cable. This cable will not work (even with adapter).

- If you have mSupply available locally on the machine, you can try testing printing a label to confirm your local setup is correct using misc. labels in the special menu.

You must enable port sharing on the remote machine (at dispensary) in Remote Desktop Client for the machine you are going to remote into.

  1. Enter the connection details for the machine you are going to RDC into
  2. Show connection options
  3. Select “Local Resources” tab
  4. In the section “Local devices and resources” click the “More…” button
  5. Ensure that the “Ports” checkbox is ticked
  6. OK!

Open mSupply Client in the rdc window and test printing, hopefully it works!

2018/02/24 01:16 · chris


From the Special menu this command allows you to view and edit the standard list of warnings.

Once this list is created, you can apply one or more warnings to each item, and choose which warning will be automatically printed on labels.

To apply a warning to an item, see Adding a New item

Double-click a warning in the list to edit its details.

Click the “New” button to add a new warning.

We suggest you use the standard set of warnings as specified by the pharmaceutical authorities in your country.

Previous: Printing Preferences Next: Patient Medication Records

2011/05/20 06:36 · craig
  • dispensing.txt
  • Last modified: 2016/03/22 01:13
  • by fergus