STANDARD DATA DICTIONARY #9000010.707 -- V IMM CONTRA/REFUSAL EVENTS FILE 3/24/25 PAGE 1
STORED IN ^AUPNVICR( *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 1.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file is used to document immunization non-administration events, capturing the reasons for not administering immunizations,
either that administration was contraindicated or that it was refused by the patient.
DD ACCESS: @
RD ACCESS: @
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
IDENTIFIED BY: PATIENT NAME (#.02)[R], VISIT (#.03)[R], IMMUNIZATION (#.04)[R]
CROSS
REFERENCED BY: VISIT(AD), VISIT(AV10), CONTRAINDICATION/REFUSAL(B), PATIENT NAME(C)
INDEXED BY: PATIENT NAME & CONTRAINDICATION/REFUSAL & VISIT (AA), PATIENT NAME & IMMUNIZATION & VISIT (AB), VISIT & IMMUNIZATION
& CONTRAINDICATION/REFUSAL (AC), CONTRAINDICATION/REFUSAL & PATIENT NAME & VISIT & IMMUNIZATION & EVENT DATE AND
TIME & WARN UNTIL DATE (ACR), PATIENT NAME & IMMUNIZATION & CONTRAINDICATION/REFUSAL (AE)
LAST MODIFIED: OCT 5,2022@14:55:07
9000010.707,.01CONTRAINDICATION/REFUSAL 0;1 VARIABLE POINTER (Required) (audited)
Contraindication/Refusal
FILE ORDER PREFIX LAYGO MESSAGE
920.4 1 C n Select the Contraindication
920.5 2 R n Select the Refusal Reason
SCREEN ON FILE 920.4: S DIC("S")="I '$$SCREEN^XTID(920.4,,Y_"","")"
SCREEN EXPLANATION: Only active contraindication reasons may be selected.
SCREEN ON FILE 920.5: S DIC("S")="I '$$SCREEN^XTID(920.5,,Y_"","")"
SCREEN EXPLANATION: Only active refusal reasons may be selected.
LAST EDITED: MAR 25, 2016
HELP-PROMPT: Enter the Contraindication or Refusal Reason for this event.
DESCRIPTION:
This is the contraindication or refusal reason for this non-administration event.
AUDIT: YES, ALWAYS
CROSS-REFERENCE: 9000010.707^B
1)= S ^AUPNVICR("B",$E(X,1,30),DA)=""
2)= K ^AUPNVICR("B",$E(X,1,30),DA)
CROSS-REFERENCE: ^^TRIGGER^9000010.707^.06
1)= K DIV S DIV=X,D0=DA,DIV(0)=D0 S Y(1)=$S($D(^AUPNVICR(D0,0)):^(0),1:"") S X=$P(Y(1),U,6),X=X S D
IU=X K Y X ^DD(9000010.707,.01,1,2,1.1) S DIH=$G(^AUPNVICR(DIV(0),0)),DIV=X S $P(^(0),U,6)=DIV,DIH=
9000010.707,DIG=.06 D ^DICR
1.1)= S X=DIV N %I,%H,% D NOW^%DTC S X=% S X=X,Y(1)=$G(X) S X=1,Y(2)=$G(X) S X=12,X=$E(Y(1),Y(2),X)
2)= Q
CREATE VALUE)= $E(NOW,1,12)
DELETE VALUE)= NO EFFECT
FIELD)= DATE/TIME RECORDED
The DATE/TIME RECORDED field (#.06) will be triggered whenever the CONTRAINDICATION/REFUSAL field
(#.01) is entered or updated. The triggered value will be NOW.
RECORD INDEXES: AA (#1396), AC (#1397), ACR (#1398), AE (#1399)
9000010.707,.02PATIENT NAME 0;2 POINTER TO PATIENT/IHS FILE (#9000001) (Required) (audited)
Patient Name
LAST EDITED: MAR 25, 2016
HELP-PROMPT: Enter the patient for whom the immunization was contraindicated or refused.
DESCRIPTION:
This is the patient for whom the immunization was contraindicated or refused.
TECHNICAL DESCR: This is a pointer to the Patient/IHS file (#9000001) which is dinumed to the Patient File (#2).
This field is always stuffed by the application. No editing is allowed.
AUDIT: YES, ALWAYS
CROSS-REFERENCE: 9000010.707^C
1)= S ^AUPNVICR("C",$E(X,1,30),DA)=""
2)= K ^AUPNVICR("C",$E(X,1,30),DA)
This cross reference allows look-up by patient name.
RECORD INDEXES: AA (#1396), AB (#1025), ACR (#1398), AE (#1399)
9000010.707,.03VISIT 0;3 POINTER TO VISIT FILE (#9000010) (Required) (audited)
Visit
INPUT TRANSFORM: S DIC("S")="I $P(^(0),U,5)=$P(^AUPNVICR(DA,0),U,2)" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
LAST EDITED: MAR 25, 2016
HELP-PROMPT: Enter the visit date/time for this encounter.
DESCRIPTION: This is the encounter defined in the Visit file that represents when and where this immunization
contraindication or refusal event occurred.
TECHNICAL DESCR: This is the pointer to the VISIT file (#9000010). This field is stuffed by the applications. No
editing is allowed.
SCREEN: S DIC("S")="I $P(^(0),U,5)=$P(^AUPNVICR(DA,0),U,2)"
EXPLANATION: Visit must be for current patient.
AUDIT: YES, ALWAYS
CROSS-REFERENCE: 9000010.707^AD
1)= S ^AUPNVICR("AD",$E(X,1,30),DA)=""
2)= K ^AUPNVICR("AD",$E(X,1,30),DA)
This cross reference allows look-up of entries by patient name.
CROSS-REFERENCE: 9000010.707^AV10^MUMPS
1)= D ADD^AUPNVSIT
2)= D SUB^AUPNVSIT
This cross-reference adds and subtracts from the dependent entry count in the VISIT file.
RECORD INDEXES: AA (#1396), AB (#1025), AC (#1397), ACR (#1398)
9000010.707,.04IMMUNIZATION 0;4 POINTER TO IMMUNIZATION FILE (#9999999.14) (Required) (audited)
Immunization
LAST EDITED: DEC 31, 2015
HELP-PROMPT: Enter the immunization contraindicated or refused.
DESCRIPTION:
This is the immunization that is contraindicated or refused.
AUDIT: YES, ALWAYS
RECORD INDEXES: AB (#1025), AC (#1397), ACR (#1398), AE (#1399)
9000010.707,.05WARN UNTIL DATE 0;5 DATE (audited)
Warn Until Date
INPUT TRANSFORM: S %DT="EX" D ^%DT S X=Y K:Y<1 X
LAST EDITED: NOV 19, 2015
HELP-PROMPT: Enter a date until which a warning should be given for this contraindication/refusal.
DESCRIPTION:
This is the date until which a warning of this contraindication/refusal should be presented.
AUDIT: YES, ALWAYS
RECORD INDEXES: ACR (#1398)
9000010.707,.06DATE/TIME RECORDED 0;6 DATE (audited)
Date/Time Recorded
INPUT TRANSFORM: S %DT="ETXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 10, 2016
HELP-PROMPT: Enter the date and time this event was documented.
AUDIT: YES, ALWAYS
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
TRIGGERED by the CONTRAINDICATION/REFUSAL field of the V IMM CONTRA/REFUSAL EVENTS File
9000010.707,1201EVENT DATE AND TIME 12;1 DATE (audited)
Event Date and Time
INPUT TRANSFORM: S %DT="ET" D ^%DT S X=Y K:Y<1 X
LAST EDITED: NOV 12, 2015
HELP-PROMPT: Enter the date and (optional) time if this contraindication/refusal event.
AUDIT: YES, ALWAYS
RECORD INDEXES: ACR (#1398)
9000010.707,1204ENCOUNTER PROVIDER 12;4 POINTER TO NEW PERSON FILE (#200) (audited)
Encounter Provider
LAST EDITED: NOV 12, 2015
HELP-PROMPT: Enter the provider associated with this contraindication/refusal event.
DESCRIPTION:
This is the provider associated with this contraindication/refusal event.
TECHNICAL DESCR:
This person can be any person in the new person file.
AUDIT: YES, ALWAYS
9000010.707,1205REFUSED VACCINE GROUP 12;5 SET (BOOLEAN Data Type)
LAST EDITED: MAY 26, 2021
HELP-PROMPT: Answer "Yes", if refused all immunizations in this group. Answer "No", if refused only this
specific formulation of vaccine.
DESCRIPTION: Yes - Refusal of all immunizations in this group. No - Refusal of only this specific formulation of
vaccine.
9000010.707,80101EDITED FLAG 801;1 SET (audited)
'1' FOR EDITED;
LAST EDITED: MAR 10, 2016
HELP-PROMPT: Enter 1 if this event data is being edited.
DESCRIPTION: This field is automatically set to 1 if PCE detects that any original contraindication/refusal
event data is being edited.
TECHNICAL DESCR: PCE filing logic automatically compares the before and after pictures of the record to determine if
the edited flag should be set to "1".
AUDIT: YES, ALWAYS
9000010.707,80102AUDIT TRAIL 801;2 FREE TEXT (audited)
INPUT TRANSFORM: K:$L(X)>85!($L(X)<2) X
LAST EDITED: NOV 12, 2015
HELP-PROMPT: Answer must be 2-85 characters in length.
DESCRIPTION: This field is populated automatically be the PCE filing logic. The format of the field is as
follows: Pointer to PCE data source file_"-"_A for Add or E for Edit_" "_DUZ of the person who
entered the data_";"...
TECHNICAL DESCR: The PCE filing logic requires a pointer to the PCE data source file. If this is not passed, then
PCE filing logic will not process the data.
If the record is a new record, then an "A" is used to specify the source that added the data. If
the record existed previously, PCE filing logic compares the old and new records of information.
An "E" will be automatically used if the filing logic finds the data has been edited. If "E" is
used, then the Edited Flag field is automatically set to 1.
The DUZ is stored in its internal format to represent the user who performed the adding or editing
of data for this record.
Iterations of editing will be concatenated to the previous data source value, up to 85 characters.
AUDIT: YES, ALWAYS
9000010.707,81101COMMENTS 811;1 FREE TEXT (audited)
Comments
INPUT TRANSFORM: K:$L(X)>245!($L(X)<1) X
LAST EDITED: NOV 12, 2015
HELP-PROMPT: Answer must be 1-245 characters in length.
DESCRIPTION: This is a comment related to this contraindication/refusal event. The provider may enter this
manually via the PCE User Interface.
AUDIT: YES, ALWAYS
9000010.707,81201VERIFIED 812;1 SET (audited)
'1' FOR ELECTRONICALLY SIGNED;
'2' FOR VERIFIED BY PACKAGE;
LAST EDITED: MAR 10, 2016
HELP-PROMPT: Enter 1 if verified by electronic signature or 2 if verified by package.
DESCRIPTION:
This is used to note how the event was verified and is automatically entered by the software.
TECHNICAL DESCR:
This is automatically entered by the software and is uneditable by users.
AUDIT: YES, ALWAYS
9000010.707,81202PACKAGE 812;2 POINTER TO PACKAGE FILE (#9.4) (audited)
LAST EDITED: MAR 10, 2016
HELP-PROMPT: Enter the VistA package from which this record originated.
DESCRIPTION:
This is the VistA package from which this immunization record originated through PCE.
TECHNICAL DESCR:
This is automatically entered by the software and is uneditable by users.
AUDIT: YES, ALWAYS
9000010.707,81203DATA SOURCE 812;3 POINTER TO PCE DATA SOURCE FILE (#839.7) (audited)
LAST EDITED: NOV 12, 2015
HELP-PROMPT: Select the data source for this contraindication/refusal event.
DESCRIPTION: This is the data source for this event, automatically entered through the PCE software and
uneditable by users.
AUDIT: YES, ALWAYS
FILES POINTED TO FIELDS
IMM CONTRAINDICATION REASONS
(#920.4) CONTRAINDICATION/REFUSAL (#.01)
IMM REFUSAL REASONS (#920.5) CONTRAINDICATION/REFUSAL (#.01)
IMMUNIZATION (#9999999.14) IMMUNIZATION (#.04)
NEW PERSON (#200) ENCOUNTER PROVIDER (#1204)
PACKAGE (#9.4) PACKAGE (#81202)
PATIENT/IHS (#9000001) PATIENT NAME (#.02)
PCE DATA SOURCE (#839.7) DATA SOURCE (#81203)
VISIT (#9000010) VISIT (#.03)
File #9000010.707
Record Indexes:
AA (#1396) RECORD MUMPS IR ACTION
Short Descr: Index the patient, contraindication/refusal, inverted visit date.
Description: This cross reference is used for sorting contraindication/refusal events in sequence by patient,
contraindication/refusal, inverted visit date, and internal entry number.
Set Logic: S ^AUPNVICR("AA",X(1),X(2),(9999999-$P(^AUPNVSIT(X(3),0),".")),DA)=""
Set Cond: S X=((X(1)'="")&(X(2)'="")&(X(3)'=""))
Kill Logic: K ^AUPNVICR("AA",X(1),X(2),(9999999-$P(^AUPNVSIT(X(3),0),".")),DA)
Kill Cond: S X=((X(1)'="")&(X(2)'="")&(X(3)'=""))
Whole Kill: K ^AUPNVICR("AA")
X(1): PATIENT NAME (9000010.707,.02) (Subscr 1) (forwards)
X(2): CONTRAINDICATION/REFUSAL (9000010.707,.01) (Subscr 2) (forwards)
X(3): VISIT (9000010.707,.03) (Subscr 3) (forwards)
AB (#1025) RECORD REGULAR IR SORTING ONLY
Short Descr: Sort entries by patient, then by immunization, then by visit date.
Description: This cross-reference sorts contraindication/refusal events in sequence by patient, immunization, and then visit
date.
Set Logic: S ^AUPNVICR("AB",X(1),X(2),X(3),DA)=""
Kill Logic: K ^AUPNVICR("AB",X(1),X(2),X(3),DA)
Whole Kill: K ^AUPNVICR("AB")
X(1): PATIENT NAME (9000010.707,.02) (Subscr 1) (forwards)
X(2): IMMUNIZATION (9000010.707,.04) (Subscr 2) (forwards)
X(3): VISIT (9000010.707,.03) (Subscr 3) (forwards)
Transform (Storage): S X=$P(+^AUPNVSIT(X,0),".",1)
AC (#1397) RECORD REGULAR IR SORTING ONLY
Short Descr: Index the Visit, Immunization, and Contraindication/Refusal fields.
Description: This cross reference is used for sorting contraindications and refusals by immunization type within visits.
Set Logic: S ^AUPNVICR("AC",X(1),X(2),X(3),DA)=""
Kill Logic: K ^AUPNVICR("AC",X(1),X(2),X(3),DA)
Whole Kill: K ^AUPNVICR("AC")
X(1): VISIT (9000010.707,.03) (Subscr 1) (forwards)
X(2): IMMUNIZATION (9000010.707,.04) (Subscr 2) (forwards)
X(3): CONTRAINDICATION/REFUSAL (9000010.707,.01) (Subscr 3) (forwards)
ACR (#1398) RECORD MUMPS IR ACTION
Short Descr: Clinical Reminders index.
Description: This cross-reference builds four indexes, two for finding all patients with a particular immunization
contraindication/refusal and two for finding all the immunization contraindication/refusals a patient has. The
indexes are stored in the Clinical Reminders index global as:
^PXRMINDX(9000010.707,"PIC",DFN,IMM,CONTRA/REFUSAL,START,STOP,DAS)
^PXRMINDX(9000010.707,"PCI",DFN,CONTRA/REFUSAL,IMM,START,STOP,DAS) and
^PXRMINDX(9000010.707,"ICP",IMM,CONTRA/REFUSAL,DFN,START,STOP,DAS)
^PXRMINDX(9000010.707,"CIP",CONTRA/REFUSAL,IMM,DFN,START,STOP,DAS) respectively. For all the details, see the
Clinical Reminders Index Technical Guide/Programmer's Manual.
Set Logic: D VICRFILE^PXPXRM(.X,.DA,"S")
Kill Logic: D VICRFILE^PXPXRM(.X,.DA,"K")
Whole Kill: K ^PXRMINDX(9000010.707)
X(1): CONTRAINDICATION/REFUSAL (9000010.707,.01) (Subscr 1) (forwards)
X(2): PATIENT NAME (9000010.707,.02) (Subscr 2) (forwards)
X(3): VISIT (9000010.707,.03) (Subscr 3) (forwards)
X(4): IMMUNIZATION (9000010.707,.04) (Subscr 4) (forwards)
X(5): EVENT DATE AND TIME (9000010.707,1201) (forwards)
X(6): WARN UNTIL DATE (9000010.707,.05) (forwards)
AE (#1399) RECORD REGULAR IR SORTING ONLY
Short Descr: Index the Patient, Immunization, and Contraindication/Refusal fields.
Description: This cross reference is used for sorting contraindications and refusals by immunization type for a patient.
Set Logic: S ^AUPNVICR("AE",X(1),X(2),X(3),DA)=""
Kill Logic: K ^AUPNVICR("AE",X(1),X(2),X(3),DA)
Whole Kill: K ^AUPNVICR("AE")
X(1): PATIENT NAME (9000010.707,.02) (Subscr 1) (forwards)
Transform (Display):
X(2): IMMUNIZATION (9000010.707,.04) (Subscr 2) (forwards)
Transform (Display):
X(3): CONTRAINDICATION/REFUSAL (9000010.707,.01) (Subscr 3) (forwards)
Transform (Display):
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):