VA-HOMELESSNESS FREQUENCY 2Y (67)    REMINDER DEFINITION (811.9)

Name Value
NAME VA-HOMELESSNESS FREQUENCY 2Y
PRINT NAME Homelessness Frequency 2y
CLASS NATIONAL
SPONSOR HOMELESSNESS OFFICE
USAGE R
EDIT HISTORY
  1. EDIT DATE:   2012-10-18 15:54:47
    EDIT BY:   USER,SEVENTEEN
    EDIT COMMENTS:   
    Exchange Install
    
DESCRIPTION
This Reminder Definition was created for the sole purpose of setting a 
new Frequency of every 2 years for Homelessness Screening, IF the Veteran 
has had 3 consecutive NEGATIVE SCREENS. It required 6 Function Findings 
to do so, (comparing dates of three negative, versus any positive 
screens). The MUMPS string would have been in excess of 255 characters in 
the Customized Patient Resolution Logic - not allowed in MUMPS fields.
So, this alternative was developed. All the Function Findings are found in
this Reminder Definition, which is then entered as a Computed Finding in 
the main Reminder Definition (VA-HOMELESSNESS SCREENING).
FINDINGS
  1. FINDING ITEM:   NEGATIVE - HAS STABLE HOUSING
    WITHIN CATEGORY RANK:   0
    OCCURRENCE COUNT:   3
    NO. OF FOUND TEXT LINES:   1
    NO. NOT FOUND TEXT LINES:   0
    FOUND TEXT:   
    Veteran has current stable housing.
    
  2. FINDING ITEM:   POSITIVE - HAS WORRIES ABOUT HOUSING
    WITHIN CATEGORY RANK:   0
    NO. OF FOUND TEXT LINES:   2
    NO. NOT FOUND TEXT LINES:   0
    FOUND TEXT:   
    The last homelessness screen was POSITIVE - Veteran has worries about 
    next 60 days.
    
  3. FINDING ITEM:   NEGATIVE - HAS NO HOUSING CONCERNS
    WITHIN CATEGORY RANK:   0
    OCCURRENCE COUNT:   3
    NO. OF FOUND TEXT LINES:   1
    NO. NOT FOUND TEXT LINES:   0
    FOUND TEXT:   
    Veteran has no immediate housing concerns.
    
  4. FINDING ITEM:   POSITIVE - HAS NO STABLE HOUSING
    WITHIN CATEGORY RANK:   0
    NO. OF FOUND TEXT LINES:   1
    NO. NOT FOUND TEXT LINES:   0
    FOUND TEXT:   
    The last homelessness screen was POSITIVE - Veteran has no stable housing.
    
FUNCTION FINDINGS
  1. FOUND TEXT:   
    The last three (3) screens were negative - homelessness screening now set 
    to every 2 years.
    
    LOGIC:   (FN(1)>2)&(FN(2)>2)
    FUNCTION STRING:   (COUNT(2)>2)&(COUNT(4)>2)
    NO. FOUND TEXT LINES:   2
    NO. NOT FOUND TEXT LINES:   0
    FUNCTION LIST:
    1. FUNCTION NUMBER:   1
      FUNCTION:   COUNT
      FUNCTION PARAMETER LIST:
    2. FUNCTION NUMBER:   2
      FUNCTION:   COUNT
      FUNCTION PARAMETER LIST:
  2. LOGIC:   FN(1)>0
    FUNCTION STRING:   DTIME_DIFF(2,3,"DATE",3,1,"DATE","D")>0
    NO. FOUND TEXT LINES:   0
    NO. NOT FOUND TEXT LINES:   0
    FUNCTION LIST:
    1. FUNCTION NUMBER:   1
      FUNCTION:   DTIME_DIFF
      FUNCTION PARAMETER LIST:
      1. FUNCTION PARAMETER:   DATE
      2. FUNCTION PARAMETER:   DATE
      3. FUNCTION PARAMETER:   D
  3. LOGIC:   FN(1)>0
    FUNCTION STRING:   DTIME_DIFF(4,3,"DATE",3,1,"DATE","D")>0
    NO. FOUND TEXT LINES:   0
    NO. NOT FOUND TEXT LINES:   0
    FUNCTION LIST:
    1. FUNCTION NUMBER:   1
      FUNCTION:   DTIME_DIFF
      FUNCTION PARAMETER LIST:
      1. FUNCTION PARAMETER:   DATE
      2. FUNCTION PARAMETER:   DATE
      3. FUNCTION PARAMETER:   D
  4. LOGIC:   FN(1)>0
    FUNCTION STRING:   DTIME_DIFF(4,3,"DATE",5,1,"DATE","D")>0
    NO. FOUND TEXT LINES:   0
    NO. NOT FOUND TEXT LINES:   0
    FUNCTION LIST:
    1. FUNCTION NUMBER:   1
      FUNCTION:   DTIME_DIFF
      FUNCTION PARAMETER LIST:
      1. FUNCTION PARAMETER:   DATE
      2. FUNCTION PARAMETER:   DATE
      3. FUNCTION PARAMETER:   D
  5. LOGIC:   FN(1)>0
    FUNCTION STRING:   DTIME_DIFF(2,3,"DATE",5,1,"DATE","D")>0
    NO. FOUND TEXT LINES:   0
    NO. NOT FOUND TEXT LINES:   0
    FUNCTION LIST:
    1. FUNCTION NUMBER:   1
      FUNCTION:   DTIME_DIFF
      FUNCTION PARAMETER LIST:
      1. FUNCTION PARAMETER:   DATE
      2. FUNCTION PARAMETER:   DATE
      3. FUNCTION PARAMETER:   D
  6. LOGIC:   (FN(1)=0)&(FN(2)=0)
    FUNCTION STRING:   (COUNT(3)=0)&(COUNT(5)=0)
    NO. FOUND TEXT LINES:   0
    NO. NOT FOUND TEXT LINES:   0
    FUNCTION LIST:
    1. FUNCTION NUMBER:   1
      FUNCTION:   COUNT
      FUNCTION PARAMETER LIST:
    2. FUNCTION NUMBER:   2
      FUNCTION:   COUNT
      FUNCTION PARAMETER LIST:
TECHNICAL DESCRIPTION
The frequency of the main reminder (VA-HOMELESSNESS SCREENING) is set to 1
and more recent than any positive Health Factor finding. 
 
Finding #2 (Current Stable Housing) and Finding #4 (No concerns about
housing in the near future) are required for a NEGATIVE Screen, which 
resolves for 1 year. If three consecutive screens are negative, the 
reminder will be resolved for 2 years - using the complex number of 
Function Findings - the sole reason for this Reminder Definition.
 
Function Finding 1 looks for 3 negative screens.
 
year, but somewhat complex resolution logic was necessary, so that various
Function Findings #2 - #6 ensure that the NEGATIVE Screens are both 
consecutive and more recent than any negative screen.
 
  ---- Begin:
FF(1)--------------------------------------------------------- 
               Function String: (COUNT(2)>2)&(COUNT(4)>2) 
      Expanded Function String: 
       (COUNT(NEGATIVE - HAS STABLE HOUSING)>2)&(COUNT( 
       NEGATIVE - HAS NO HOUSING CONCERNS)>2) 
           Match Frequency/Age: 2 years for all ages 
findings and conditions resolve the reminder for different time frames.
       Use in Resolution Logic: OR 
                    Found Text: The last three (3) screens were negative -
                                homelessness screening now set to every 2
                                years. 
---- End: FF(1)
----------------------------------------------------------
 
  ---- Begin: 
FF(2)--------------------------------------------------------- 
               Function String: DTIME_DIFF(2,3,"DATE",3,1,"DATE","D")>0 
 
      Expanded Function String: 
       DTIME_DIFF(NEGATIVE - HAS STABLE HOUSING,3,"DATE", 
       POSITIVE - HAS WORRIES ABOUT HOUSING,1,"DATE","D")>0 
  ---- End: FF(2) 
---------------------------------------------------------- 
  
  
  ---- Begin: 
FF(3)--------------------------------------------------------- 
               Function String: DTIME_DIFF(4,3,"DATE",3,1,"DATE","D")>0 
Function Finding #1 was used to ensure that if the Veteran screened 
      Expanded Function String: 
       DTIME_DIFF(NEGATIVE - HAS NO HOUSING CONCERNS,3,"DATE", 
       POSITIVE - HAS WORRIES ABOUT HOUSING,1,"DATE","D")>0 
  ---- End: FF(3) 
---------------------------------------------------------- 
  
  
  ---- Begin: 
FF(4)--------------------------------------------------------- 
               Function String: DTIME_DIFF(4,3,"DATE",5,1,"DATE","D")>0 
negative 3 times, the reminder frequency is changed to 2 years instead of
      Expanded Function String: 
       DTIME_DIFF(NEGATIVE - HAS NO HOUSING CONCERNS,3,"DATE", 
       POSITIVE - HAS NO STABLE HOUSING,1,"DATE","D")>0 
  ---- End: FF(4) 
---------------------------------------------------------- 
  
  
  ---- Begin: 
FF(5)--------------------------------------------------------- 
               Function String: DTIME_DIFF(2,3,"DATE",5,1,"DATE","D")>0 
annually. But several more Function Findings (comparing the dates of the
      Expanded Function String: 
       DTIME_DIFF(NEGATIVE - HAS STABLE HOUSING,3,"DATE", 
       POSITIVE - HAS NO STABLE HOUSING,1,"DATE","D")>0 
  ---- End: FF(5) 
---------------------------------------------------------- 
  
  
  ---- Begin: 
FF(6)--------------------------------------------------------- 
               Function String: (COUNT(3)=0)&(COUNT(5)=0) 
various occurrences of negative and positive screening Health Factors) was
      Expanded Function String: 
       (COUNT(POSITIVE - HAS WORRIES ABOUT HOUSING)=0)&(COUNT( 
       POSITIVE - HAS NO STABLE HOUSING)=0) 
  ---- End: FF(6) 
---------------------------------------------------------- 
 
With no resolution logic set on this Reminder Definition, it serves as a
means for resolving the main reminder (VA-HOMELESSNESS SCREENING) for 2
years . If this reminder evaluates as TRUE, then the main reminder is
resolved for 2 years, because the CF has a Match Frequency/Age of 2 years.
necessary to ensure that the three negative screens were both consecutive,
CUSTOMIZED COHORT LOGIC (FF(1)&FF(2)&FF(3)&FF(4)&FF(5))!(FF(1)&FF(6))
INTERNAL PATIENT COHORT LOGIC (FF(1)&FF(2)&FF(3)&FF(4)&FF(5))!(FF(1)&FF(6))
PATIENT COHORT FINDINGS COUNT 7
PATIENT COHORT FINDINGS LIST FF1;FF2;FF3;FF4;FF5;FF1;FF6
INFORMATION FINDINGS COUNT 4
INFORMATION FINDINGS LIST 2;3;4;5
# OF GEN. COHORT FOUND LINES 0
# GEN. COHORT NOT FOUND LINES 0
# GEN. RES. FOUND LINES 0
# GEN. RES. NOT FOUND LINES 0
BASELINE AGE FINDINGS
  1. REMINDER FREQUENCY:   99Y
    NO. OF AGE MATCH LINES:   0
    NO. OF AGE NO MATCH LINES:   0
# SUM. COHORT FOUND LINES 0
# SUM. COHORT NOT FOUND LINES 0
# SUM. RES. FOUND LINES 0
# SUM. RES. NOT FOUND LINES 0