Home   Package List   Routine Alphabetical List   Global Alphabetical List   FileMan Files List   FileMan Sub-Files List   Package Component Lists   Package-Namespace Mapping  
Routine: BIREPE

BIREPE.m

Go to the documentation of this file.
BIREPE ;IHS/CMI/MWR - REPORT, VAC ELIGIBILITY; MAY 10, 2010
 ;;8.5;IMMUNIZATION;**2**;MAY 15,2012
 ;;* MICHAEL REMILLARD, DDS * CIMARRON MEDICAL INFORMATICS, FOR IHS *
 ;;  VIEW VACCINE ELIGIBILITY REPORT.
 ;
 ;
 ;----------
START ;EP
 ;---> Listman Screen for viewing Vaccine Accountability Report.
 D SETVARS^BIUTL5 N BIRTN
 ;
 ;---> If Vaccine Table is not standard, display Error Text and quit.
 I $D(^BISITE(-1)) D ERRCD^BIUTL2(503,,1) Q
 ;
 D EN
 D EXIT
 Q
 ;
 ;
 ;----------
EN ;EP
 ;---> Main entry point for BI REPORT VAC ELIGIBILITY.
 D EN^VALM("BI REPORT ELIGIBILITY")
 Q
 ;
 ;
 ;----------
INIT ;EP
 ;---> Initialize variables and list array.
 K ^TMP("BIREPE",$J)
 S VALM("TITLE")=$$LMVER^BILOGO
 S VALMSG="Select a left column number to change an item."
 N BILINE,X S BILINE=0
 D WRITE(.BILINE)
 S X=IOUON_"VACCINE ELIGIBILITY REPORT"
 D CENTERT^BIUTL5(.X,42)
 D WRITE(.BILINE,X_IOINORM)
 K X
 ;
 ;---> Date Range.
 S:'$G(BIBEGDT) BIBEGDT=(DT-10000)
 S:'$G(BIENDDT) BIENDDT=DT
 ;D DATERNG^BIREP(.BILINE,"BIREPE",1,BIBEGDT,BIENDDT)
 D DATERNG^BIREP(.BILINE,"BIREPE",1,BIBEGDT,BIENDDT,1,1,1)
 ;
 ;---> Current Community.
 D DISP^BIREP(.BILINE,"BIREPE",.BICC,"Community",2,1,0)
 ;
 ;---> Health Care Facility.
 N A,B S A="Health Care Facility",B="Facilities"
 D DISP^BIREP(.BILINE,"BIREPE",.BIHCF,A,3,2,0,,,B)
 ;
 ;---> Case Manager.
 D DISP^BIREP(.BILINE,"BIREPE",.BICM,"Case Manager",4,3)
 ;
 ;---> Beneficiary Type.
 D DISP^BIREP(.BILINE,"BIREPE",.BIBEN,"Beneficiary Type",5,4,0)
 ;
 ;---> Visit Type.
 D VTYPE^BIREP(.BILINE,"BIREPE",.BIVT,6)
 ;
 ;---> Include Historical.
 N BIHIST1 S BIHIST1=""
 S:'$D(BIHIST) BIHIST=1
 S BIHIST1=$S(BIHIST:"YES",1:"NO")
 S X="     7 - Include Historical.........: "_BIHIST1
 D WRITE(.BILINE,X)
 K X
 ;
 ;---> Include Adults.
 N BIU191 S BIU191=""
 S:'$D(BIU19) BIU19=0
 S BIU191=$S(BIU19:"YES",1:"NO")
 S X="     8 - Include Adults (>19 yrs)...: "_BIU191
 D WRITE(.BILINE,X,1)
 K X
 ;
 ;---> Delimiter.
 N BIDELIM1 S BIDELIM1=""
 S:'$D(BIDELIM) BIDELIM=2
 S BIDELIM1=$S(BIDELIM=2:"2 spaces",1:"caret ^")
 S X="     9 - Delimiter..................: "_BIDELIM1
 W ! D WRITE(.BILINE,X)
 K X
 ;
 ;---> Display by Lot Number.
 ;N BIDLOT1 S BIDLOT1=""
 ;S:'$D(BIDLOT) BIDLOT=0
 ;S BIDLOT1=$S(BIDLOT:"YES",1:"NO")
 ;S X="     8 - Display by Lot Number......: "_BIDLOT1
 ;D WRITE(.BILINE,X)
 ;K X
 ;
 ;
 ;---> Finish up Listmanager List Count.
 S VALMCNT=BILINE
 S BIRTN="BIREPE"
 Q
 ;
 ;
 ;----------
WRITE(BILINE,BIVAL,BIBLNK) ;EP
 ;---> Write lines to ^TMP (see documentation in ^BIW).
 ;---> Parameters:
 ;     1 - BILINE (ret) Last line# written.
 ;     2 - BIVAL  (opt) Value/text of line (Null=blank line).
 ;     3 - BIBLNK (opt) Number of blank lines to add after line sent.
 ;
 Q:'$D(BILINE)
 D WL^BIW(.BILINE,"BIREPE",$G(BIVAL),$G(BIBLNK))
 Q
 ;
 ;
 ;----------
RESET ;EP
 ;---> Update partition for return to Listmanager.
 I $D(VALMQUIT) S VALMBCK="Q" Q
 D TERM^VALM0 S VALMBCK="R"
 ;
 ;---> NOT USED.  Could be used to correct margins.
 ;K VALMHDR S VALM("BM")=15,VALM("LINES")=14,VALM("TM")=2
 D INIT
 Q
 ;
 ;
 ;----------
HELP ;EP
 ;---> Help code.
 N BIX S BIX=X
 D FULL^VALM1
 W !!?5,"Enter ""V"" to view this report on screen, ""P"" to print it,"
 W !?5,"or ""H"" to view the Help Text for this report and its parameters."
 D DIRZ^BIUTL3("","     Press ENTER/RETURN to continue")
 D:BIX'="??" RE^VALM4
 Q
 ;
 ;
 ;----------
HELP1 ;EP
 ;----> Explanation of this report.
 N BITEXT D TEXT1(.BITEXT)
 D START^BIHELP("VACCINE ELIGIBILITY REPORT - HELP",.BITEXT)
 Q
 ;
 ;
 ;----------
TEXT1(BITEXT) ;EP
 ;;The Vaccine Eligibility Report provides a listing of doses
 ;;administered by date and patient information, along with the
 ;;patient eligibility recorded for that visit.  Lot Number is also
 ;;displayed.  This report can be printed for any time period, for
 ;;a given facility, visit type, or community(s).
 ;;
 ;;There are 9 items or "parameters" on the screen that you may
 ;;change in order to select for a specific group of patients.
 ;;To change an item, enter its left column number (1-8) at the
 ;;prompt on the bottom of the screen.  Use "?" at any prompt where
 ;;you would like help or more information on the parameter you are
 ;;changing.
 ;;
 ;;Once you have the parameters set to retrieve the group of patients
 ;;you want, select V to View the Vaccine Elig Report or P to print it.
 ;;
 ;;If it customarily takes a long time for your computer to prepare
 ;;this report, it may be preferable to Print and Queue the report
 ;;to a printer, rather than Viewing it on screen.  (This would avoid
 ;;tying up your screen while the report is being prepared.)
 ;;
 ;;DATE RANGE: Only immunizations given within the Date Range you
 ;;select will be included in the report.
 ;;
 ;;COMMUNITIES: If you select for specific Communities, only patients
 ;;whose Current Community matches one of the Communities selected will
 ;;be included in the report.  "Current Community" refers to Item 6
 ;;on Page 1 of the RPMS Patient Registration.
 ;;
 ;;HEALTH CARE FACILITIES: If you select for specific Health Care
 ;;Facilities, only immunizations given at the selected Health Care
 ;;Facilities will be included in the report.
 ;;
 ;;CASE MANAGERS: If you select for specific Case Managers, only
 ;;patients who have the selected Case Managers will be included
 ;;in the report.
 ;;
 ;;BENEFICIARY TYPES: If you select for specific Beneficiary Types,
 ;;only patients whose Beneficiary Type is one of those you select
 ;;will be included in the report.  "Beneficiary Type" refers to
 ;;Item 3 on Page 2 of the RPMS Patient Registration.
 ;;
 ;;VISIT TYPES: If you select for specific Visit Types, only visits
 ;;that are classifed with one of the Visit Types you select will
 ;;included in the report.
 ;;
 ;;INCLUDE HISTORICAL: If this parameter is set to "YES", then Visits
 ;;with a Category of "Historical" will be counted in the Vaccine
 ;;Eligibility Report.  (Category is displayed and edited on the
 ;;ADD/EDIT IMMUNIZATION VISIT Screen.)  If set to "NO", they will
 ;;not be counted in the report.
 ;;
 ;;INCLUDE ADULTS: If this parameter is set to "YES", then immunizations
 ;;given when the patietn was age 19 years or older will be included.
 ;;Otherwise, only immunizations given when the patient was younger
 ;;than 19 years of age will be included.
 ;;
 ;;DELIMITER: This parameter allows you to select the character that
 ;;will separate the 6 fields in each record displayed by the report.
 ;;The default delimiter is "2 spaces".  However, when the intention is
 ;;to print or copy the report to a text file for the purpose of importing
 ;;it into Excel or some other spreadsheet, use of the caret "^" is
 ;;preferable and recommended. (Spaces in the data itself might sometimes
 ;;be confused with spaces in the delimiter and/or spaces used to make the
 ;;columns line up.)
 ;;
 D LOADTX("TEXT1",,.BITEXT)
 Q
 ;
 ;;DISPLAY BY LOT NUMBERS: The report lists the statistics by age for
 ;;each vaccine.  However, you may elect to display the statistics for
 ;;each separate lot number under each vaccine.  The totals for all
 ;;lot numbers of each vaccine will also be displayed.
 ;;
 ;
 ;
 ;----------
LOADTX(BILINL,BITAB,BITEXT) ;EP
 Q:$G(BILINL)=""
 N I,T,X S T="" S:'$D(BITAB) BITAB=5 F I=1:1:BITAB S T=T_" "
 F I=1:1 S X=$T(@BILINL+I) Q:X'[";;"  S BITEXT(I)=T_$P(X,";;",2)
 Q
 ;
 ;
 ;----------
EXIT ;EP
 ;---> End of job cleanup.
 D KILLALL^BIUTL8(1)
 K ^TMP("BIREPE",$J)
 D CLEAR^VALM1
 Q