Files > REMINDER DEFINITION

name
REMINDER DEFINITION
number
811.9
location
^PXD(811.9,
description
This file contains Clinical Reminder definitions. For a detailed description of the contents of this file, see the Clinical Reminders Manager Manual. Additional information may be found at the Clinical Reminders web site: http//vista.domain.ext/reminders This file contains a combination of nationally distributed and local entries. Any local entries are assigned an internal entry number prefixed with your site number. Nationally distributed entries have their name prefixed with VA-. Local entry names cannot start with VA-.
applicationGroups
GMTS
Fields
#NameLocationTypeDetailsIndexDescription
.01name(+)0;1FREE TEXTThis field is the name of a clinical reminder definition. Nationally distributed reminder definition names are prefixed with "VA-". The VA- prefixed reminder definitions cannot be altered by a site, but may be inactivated so they will not be selectable or evaluated in the CPRS GUI. Local modifications can be made to any "VA-" reminder definition by copying the definition to a new one with a unique name and then making modifications to the new definition which meet local criteria.
1.2print name0;3FREE TEXTThis is the name that is used when the results of a reminder evaluation are displayed.
1.3do in advance time frame0;4FREE TEXTThis field is used to let a reminder become due earlier than the date determined by adding the frequency to the date when the reminder was last resolved. For example, if the frequency is 1Y (one year) and the DO IN ADVANCE TIME FRAME is 1M (one month), the reminder would have a status of "DUE SOON" 11 months after it was last resolved. After one year has passed, the STATUS would be "DUE". Frequencies have the form IU where I is an integer and U is one of the following units: H (hours), D (days), W (weeks), M (months), and Y (years).
1.4related reminder guideline0;5POINTER811.9If a local reminder replaces a national reminder, this field can be used to identify the related national reminder.
1.6inactive flag0;6SET OF CODES1:INACTIVE
Reminders that are inactive will not be evaluated. The Clinical Maintenance component will return a message stating the reminder is inactive and the date when it was made inactive. Other applications that use reminders may use this flag to determine if a reminder can be selected for inclusion.
1.7inactive change date0;7DATE-TIMEThis is the date and time when the INACTIVE FLAG was last changed. It is set automatically. Users should never edit this field.
1.8ignore on n/a0;8FREE TEXTThis field allows the user to stop reminders from being printed in the Clinical Maintenance component if the reminder is N/A. This is a free text field that can contain any combination of the following codes: Code Description A N/A due to not meeting age criteria. I N/A due to inactive reminder. R N/A due to the wrong race. S N/A due to the wrong sex. * N/A for any reason.
1.9sex specific0;9SET OF CODESF:FEMALE
M:MALE
This field is used to make a reminder sex specific. If an "F" is entered, the reminder applies only to females. If an "M" is entered, the reminder applies only to males. If it is left blank, then the reminder is applicable to either sex. If CUSTOM COHORT LOGIC is defined and it does not contain SEX, then this field will be ignored.
1.91priority0;10SET OF CODES1:HIGH
2:MEDIUM
3:LOW
REMINDER PRIORITY is used by the CPRS GUI for sorting purposes.
2description1;0WORD-PROCESSINGThis field contains a description of the clinical reminder. It is used to document its purpose and intended usage.
3technical description2;0WORD-PROCESSINGThe TECHNICAL DESCRIPTION is for documenting how a reminder is supposed to function and why the definition is set up the way it is.
7baseline age findings7;0MULTIPLE811.97This multiple is for defining reminder frequency age ranges sets. It can be used to specify different frequencies for different ages. For example, you could define a frequency of every 3 years for ages 40 to 49 as the first age range set, a frequency of every 2 years for ages 50 to 59 as the second, and a frequency of once a year for ages 60 to 75. With this set the reminder would be due every 3 years for ages 40 to 49, every 2 years for ages 50 to 59, and once a year for ages 60 to 75.
20findings20;0MULTIPLE811.902This multiple identifies which finding items to use when evaluating the reminder. Finding items may be categorized into 4 types of findings: age, patient cohort, resolution, and informational. How patient findings are used depends on the values given to the various fields associated with findings. See the description of those fields to learn what they do.
25function findings25;0MULTIPLE811.925This multiple is used to define function findings; each function finding is labeled by an integer: the FUNCTION FINDING NUMBER. The user defines a function finding by inputting a FUNCTION FINDING NUMBER and associated FUNCTION STRING. Function Findings are then used in the reminder definition logic by reference to FF(FUNCTION FINDING NUMBER). For example, if function findings 1 and 2 were defined, then they could be used in the cohort or resolution logic as FF(1) and FF(2). Function findings can be used in the resolution logic with one caveat. They do not have a date associated with them; therefore, the resolution logic must be written so that it cannot be made true solely by a function finding.
30customized cohort logic30;1FREE TEXTThis field may be used to define a customized Patient Cohort Logic string. Typically this is done when the USE IN PATIENT COHORT LOGIC fields associated with each finding do not provide the ability to create the required logic string. The requirement for custom logic arises when the required logic is more complex than can be represented by simple concatenation of Boolean logical operators and findings. Detailed information on how to create the custom logic string can be found in the Clinical Reminders Manager Manual.
31internal patient cohort logic31;1FREE TEXTThis field is computed by the Clinical Reminders software and should never be edited by hand.
32patient cohort findings count32;1NUMERICThis field is computed by the Clinical Reminders software and should never be edited by hand.
33patient cohort findings list32;2FREE TEXTThis field is computed by the Clinical Reminders software and should never be edited by hand.
34customized resolution logic34;1FREE TEXTThis field may be used to define a customized Resolution Logic string. Typically this is done when the USE IN RESOLUTION LOGIC fields associated with each finding do not provide the ability to create the required logic string. The requirement for custom logic arises when the required logic is more complex than can be represented by simple concatenation of Boolean logical operators and findings. Detailed information on how to create the custom logic string can be found in the Clinical Reminders Manager Manual.
35internal resolution logic35;1FREE TEXTThis field is computed by the Clinical Reminders software and should never be edited by hand.
36resolution findings count36;1NUMERICThis field is computed by the Clinical Reminders software and should never be edited by hand.
37resolution findings list36;2FREE TEXTThis field is computed by the Clinical Reminders software and should never be edited by hand.
40age findings count40;1NUMERICThis field is computed by the Clinical Reminders software and should never be edited by hand.
41age findings list40;2FREE TEXTThis field is computed by the Clinical Reminders software and should never be edited by hand.
42information findings count42;1NUMERICThis field is computed by the Clinical Reminders software and should never be edited by hand.
43information findings list42;2FREE TEXTThis field is computed by the Clinical Reminders software and should never be edited by hand.
45custom date due45;1FREE TEXTWhen a CUSTOM DATE DUE is defined, it takes precedence over the standard date due calculation. This means the normal date due calculation that is based on the dates of the resolution findings and the final frequency is not done. Only the dates of the findings and the frequencies specified in the Custom Date Due string are used. Any finding that is in the reminder definition can be used in the Custom Date Due string; it is not limited to those defined as resolution findings. The final age range will still be used to determine if the patient is in the cohort; however, the frequency associated with this age range is not used. Only the frequencies specified in the Custom Date Due String are used. They are added to the date of the associated finding to determine the dates used by either the MIN_DATE or MAX_DATE functions.
46custom date due function46;1FREE TEXTThis field contains the function used in the CUSTOM DATE DUE. It is created automatically and should not be set by hand.
47number of arguments46;2NUMERICThis is the number of arguments (findings) used in the CUSTOM DATE DUE. It is created automatically and should not be set by hand.
48custom date due arg list47;0MULTIPLE811.948This is the list of arguments (findings) used in the CUSTOM DATE DUE. It is used to efficiently calculate the resolution date from the custom date due string. It is created automatically and should not be set by hand.
50web sites50;0MULTIPLE811.9002This multiple contains Web sites that have information related to this reminder. The list of web sites will be displayed in the CPRS GUI if the user right-clicks on a reminder and then selects reference information. If a particular web site is clicked on, the GUI will open a browser at that web site.
51linked reminder dialog51;1POINTER801.41AGThis is the Reminder Dialog that will be used when the reminder is processed in the CPRS GUI.
60general cohort found text60;0WORD-PROCESSINGThis optional field defines the detailed text to display when the Patient Cohort Logic is true. Detailed text is used for components such as Clinical Maintenance and MyHealtheVet Detailed.
61general cohort not found text61;0WORD-PROCESSINGThis optional field defines the detailed text to display when the Patient Cohort Logic is false. Detailed text is used for components such as Clinical Maintenance and MyHealtheVet Detailed.
62# of gen. cohort found lines62;1FREE TEXTThis is the number of lines in the GENERAL COHORT FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
63# gen. cohort not found lines62;2FREE TEXTThis is the number of lines in the GENERAL COHORT NOT FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
65general res. found text65;0WORD-PROCESSINGThis optional field defines the detailed text to display when the Resolution Logic is true. Detailed text is used for components such as Clinical Maintenance and MyHealtheVet Detailed.
66general res. not found text66;0WORD-PROCESSINGThis optional field defines the detailed text to display when the Resolution Logic is false. Detailed text is used for components such as Clinical Maintenance and MyHealtheVet Detailed.
67# gen. res. found lines67;1FREE TEXTThis is the number of lines in the GENERAL RESOLUTION FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
68# gen. res. not found lines67;2FREE TEXTThis is the number of lines in the GENERAL RESOLUTION NOT FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
69rescission date0;11DATE-TIMEThis is the rescission date for this reminder definition.
70summary cohort found text70;0WORD-PROCESSINGThis optional field defines the summary text to display when the Patient Cohort Logic is true. Summary text is used for components such as MyHealtheVet Summary.
71summary cohort not found text71;0WORD-PROCESSINGThis optional field defines the summary text to display when the Patient Cohort Logic is false. Summary text is used for components such MyHealtheVet Summary.
72# sum. cohort found lines72;1FREE TEXTThis is the number of lines in the SUMMARY COHORT FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
73# sum. cohort not found lines72;2FREE TEXTThis is the number of lines in the SUMMARY COHORT NOT FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
75summary res. found text75;0WORD-PROCESSINGThis optional field defines the summary text to display when the Resolution Logic is true. Summary text is used for components such as MyHealtheVet Summary.
76summary res. not found text76;0WORD-PROCESSINGThis optional field defines the summary text to display when the Resolution Logic is false. Summary text is used for components such as MyHealtheVet Summary.
77# sum. res. found lines77;1FREE TEXTThis is the number of lines in the SUMMARY RESOLUTION FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
78# sum. res. not found lines77;2FREE TEXTThis is the number of lines in the SUMMARY RESOLUTION NOT FOUND TEXT. If the number ends with "T" then the text contains TIU objects. This field is set automatically during reminder edit and should never be edited by hand.
100class(+)100;1SET OF CODESN:NATIONAL
V:VISN
L:LOCAL
This is the CLASS of the definition. Possible classes are "N" for national, "V" for VISN, and "L" for local. National definitions cannot be edited by sites.
101sponsor100;2POINTER811.6This is the organization or group that sponsors this definition.
102review date100;3DATE-TIMEThe REVIEW DATE is used to determine when the definition should be reviewed to verify that it is current with the latest standards and guidelines. You can find all reminder definitions whose review date has passed using the Clinical Reminders Review Date Report.
103usage(+)100;4FREE TEXTThe Usage field describes how the reminder definition can be used. This field must contain C or * if the reminder is to be selected in CPRS. The L or the O values will override all other values. For example, if L and C are defined in the Usage field, the Reminder will not show on the cover sheet in CPRS, because L is in the Usage field. This is free text field and can contain any combination of the following codes: Code Usage C CPRS L Reminder Patient List O Reminder Order Checks P Patient R Reminder Reports X Reminder Extracts * All of the above, except L, O, and P.
110edit history110;0MULTIPLE811.9001This multiple is used to record a history of changes made to the definition.

Referenced by 4 types

  1. REMINDER ORDER CHECK RULES (801.1) -- reminder definition, order check text
  2. REMINDER DIALOG (801.41) -- source reminder
  3. REMINDER LIST RULE (810.4) -- reminder definition
  4. REMINDER DEFINITION (811.9) -- related reminder guideline