description
Adds a new medication to the patient’s medication list.
Note. Do not use this function outside of a chart update; otherwise, the note will not be signed.
type
Data symbol function
syntax
MEL_ADD_MEDICATION(description[,instruction, onset date, ID, end date, quantity, refills, BMN indicator, medication comment])
arguments
description |
Description of the medication product formulation, typically product name + strength + dose form.
Medications are added to the medication list and coded based on the ID number, not this text description.
|
instruction |
Instructions for taking the medication, including amount, frequency, duration, timing, etc.
|
onset_date |
Start date for the medication. Must be in MM/DD/YYYY date format. If ._TODAYSDATE is used, it must be used with the str function.
|
ID |
ID number of the medication
If ID is less than a 9-digit string, then ID is treated as a DDID (First Databank code). Medication is added only if the DDID number is valid and found in the medication tables. The description that is added to the patient’s medication list is based on a lookup of this ID.
RECOMMENDED
If ID is an 11-digit string, then ID is treated as a National Drug Council product ID code (NDCNUM). The DDID is then determined by lookup. Medication is added only if the ID number is valid. This is an acceptable alternative to the DDID.
Coding of the medication is handled in the following way:
ID = DDID. Medication is coded if the ID is valid
ID = NDCNUM. Medication is coded if the ID is valid
The aplication includes only a single NDC representative for each DDID. Because most valid NDC codes will not be found, the DDID is more reliable.
ID = Invalid DDID or NDCNUM. Medication is not added
ID = Empty string. Medication is not added
ID = Free text. Medication is not added
|
end_date |
The date the medication was terminated. Must be in MM/DD/YYYY date format.
|
quantity |
The number or amount of the medication to dispense
|
refills |
The number of refills to dispense
|
BMN |
Y - This prescription requires a brand medically necessary medication.
Any other value or a null value indicates that the prescription is not designated as BMN.
|
medication comment |
General comment (up to 2000 characters) about the medication, not the prescription
|
when to evaluate
This function does not support the ability to evaluate continuously.
returns
Error if unable to acquire the medication lock
Error if unsuccessful in inserting the new medication
Empty string if medication is successfully added to the clinical list comments The DDID for a medication can be found by using the Medication DDID report available on the KnowledgeBank®.
Use the MEL_PRINT_RX function if a prescription is to be printed as well as added to the patient’s medication list. Prescriptions are not printed automatically with the MEL_ADD_MEDICATION function, even if prescription information is specified.
example
MEL_ADD_MEDICATION("Aspirin 500mg Tab", "1 po tid","3/1/04",1926,"6/30/06",250,3,"Y","Must use specific brand as indicated")
returns
Adds a medication of 500mg tabs of Aspirin Tabs with a start data of 3/1/04, and end date of 6/30/06, instructions of 1 po tid, a quantity of 250 with 3 refills, a BMN indication and a medication comment of Must use specific brand as indicated.
where used
Encounter Form Editor, quick text
|