STANDARD DATA DICTIONARY #820 -- SPECIAL AUTHORITIES FILE 5/26/26 PAGE 1
STORED IN ^PXIND(820, (11 ENTRIES) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 1.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file is used to define each Special Authority (SA) indicator and its respective behavior. This will allow for multiple SAs to
be created in the future and the ordering software, e.g. CPRS, can adapt its dialog dynamically and avoid altering code each time.
The key to this file is an internal code of 2-3 characters, e.g. AO = Agent Orange or MST = Military Sexual Trauma.
This file has various fields and multiples to further define the SA. e.g. Disabled?, the display hierarchy sequence, display name,
WP display text, abbreviation characters, default value for the SA, Package multiple, and When Values multiple.
The When Values multiples allow dynamic business rules and associations with other SAs in this file, e.g. visible on display when
exists, default indicator value, and field enabled/disabled on screen.
POINTED TO BY: SPECIAL AUTHORITY field (#.01) of the SPECIAL AUTHORITIES sub-field (#100.0112) of the ORDER File (#100)
LINKED SPECIAL AUTHORITIES field (#.01) of the LINKED SPECIAL AUTHORITIES sub-field (#820.022) of the WHEN VALUES
sub-field (#820.02) of the SPECIAL AUTHORITIES File (#820)
SPECIAL AUTHORITY field (#.01) of the SPECIAL AUTHORITIES sub-field (#9000010.01) of the VISIT File (#9000010)
SPECIAL AUTHORITY field (#.01) of the SPECIAL AUTHORITIES sub-field (#9000010.08) of the V POV File (#9000010.07)
SPECIAL AUTHORITIES field (#.01) of the SPECIAL AUTHORITIES sub-field (#9000011.02) of the PROBLEM File (#9000011)
CROSS
REFERENCED BY: NAME(B), CODE(C), SCHEDULING SEQUENCE(S)
LAST MODIFIED: MAY 26,2026@00:43:55
820,.01 NAME 0;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>30!($L(X)<3)!'(X'?1P.E) X
MAXIMUM LENGTH: 30
LAST EDITED: JAN 27, 2025
HELP-PROMPT: Enter the name for this Special Authority.
DESCRIPTION:
This is the name of the Special Authority in upper case, e.g. SERVICE CONNECTED and AGENT ORANGE.
PRE-LOOKUP: I $G(DIC(0))["L",'$G(PXNAT) K X D EN^DDIOL("Entries cannot be added, modified, or deleted.","","!?5
")
CROSS-REFERENCE: 820^B
1)= S ^PXIND(820,"B",$E(X,1,30),DA)=""
2)= K ^PXIND(820,"B",$E(X,1,30),DA)
820,1 DISABLED 0;8 SET (BOOLEAN Data Type)
LAST EDITED: JAN 27, 2025
HELP-PROMPT: Enter 1 for YES to disable this Special Authority.
DESCRIPTION: This field allows you to set a Special Authority indicator to disabled, i.e. turn off all features
of this indicator.
820,2 CODE 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>4!($L(X)<2) X
MAXIMUM LENGTH: 4
LAST EDITED: JAN 31, 2025
HELP-PROMPT: Enter a 2-4 character upper case internal code for this Special Authority.
DESCRIPTION: This is an internal abbreviated upper case code and not the abbreviation displayed to users.
Example: Internal code for Southwest Asia Conditions is EC vs SWAC for the external displayable
code.
TECHNICAL DESCR: This is the internal code that is in use in existing M code, e.g. EC instead of SWAC (user
displayable abbreviation).
CROSS-REFERENCE: 820^C
1)= S ^PXIND(820,"C",$E(X,1,30),DA)=""
2)= K ^PXIND(820,"C",$E(X,1,30),DA)
This cross reference is used to find the IEN of a special authority by internal code.
820,3 DISPLAY NAME 0;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>40!($L(X)<2) X
MAXIMUM LENGTH: 40
LAST EDITED: JAN 31, 2025
HELP-PROMPT: Enter the proper case name to be displayed and printed for the users (2-40 characters).
DESCRIPTION:
This is the proper case display name, e.g. Agent Orange.
820,4 SEQ 0;4 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999)!(X<1)!(X?.E1"."1.N) X
LAST EDITED: JAN 27, 2025
HELP-PROMPT: Enter a 1-3 digit number for this Special Authority's display sequence.
DESCRIPTION: The sequence is 1-999 and the lower the number the greater the hierarchy. For example, the value 10
would display above another Special Authority Indicator with a value 20.
Recommend using values, e.g. 10, 20, 30, etc. for existing Special Authority Indicators, so later
adding of new indicators will allow insertion into the current schema without renumbering all other
existing indicators.
820,5 ABBREVIATION 0;5 FREE TEXT
INPUT TRANSFORM: K:$L(X)>4!($L(X)<2) X
MAXIMUM LENGTH: 4
LAST EDITED: JAN 31, 2025
HELP-PROMPT: Enter an external abbreviation of (2-4) upper case characters for this Special Authority.
DESCRIPTION: This is a displayable abbreviation for this Special Authority (SA) indicator and not the internal
code value.
820,6 SCHEDULING SEQUENCE 0;6 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>99)!(X<1)!(X?.E1"."1.N) X
LAST EDITED: OCT 08, 2024
HELP-PROMPT: Type a number between 1 and 99, 0 decimal digits.
DESCRIPTION:
The scheduling sequence for the original 8 indicators including SC.
CROSS-REFERENCE: 820^S
1)= S ^PXIND(820,"S",$E(X,1,30),DA)=""
2)= K ^PXIND(820,"S",$E(X,1,30),DA)
820,7 DEFAULT APPLICABILITY 0;7 SET
'0' FOR No;
'1' FOR Yes;
LAST EDITED: JAN 27, 2025
HELP-PROMPT: Enter the default value for this Special Authority.
DESCRIPTION: This is the default value to show for this Special Authority (SA), when the patient is eligible for
this SA and it is currently unanswered.
820,8 DESCRIPTION 3;0 WORD-PROCESSING #820.08 (IGNORE "|")
LAST EDITED: JUN 25, 2024
DESCRIPTION: This field contains additional help text about this Special Authority that can be displayed to end
users of clinical or administrative applications.
LAST EDITED: JUL 09, 2025
HELP-PROMPT: Enter a detailed description to display to the user.
DESCRIPTION:
This is additional help text information to be displayed to a user about this Special Authority.
820,10 PACKAGE 1;0 POINTER Multiple #820.01
LAST EDITED: MAY 13, 2024
DESCRIPTION: The package multiple will allow rules to be defined on how this package should process a Special
Authority.
820.01,.01 PACKAGE 0;1 POINTER TO PACKAGE FILE (#9.4) (Multiply asked)
LAST EDITED: MAR 25, 2025
HELP-PROMPT: Enter a valid Package namespace.
CROSS-REFERENCE: 820.01^B
1)= S ^PXIND(820,DA(1),1,"B",$E(X,1,30),DA)=""
2)= K ^PXIND(820,DA(1),1,"B",$E(X,1,30),DA)
820.01,1 EXCLUDED 0;2 SET (BOOLEAN Data Type)
LAST EDITED: JAN 31, 2025
HELP-PROMPT: Enter "Y" for yes this Special Authority is excluded from this package.
DESCRIPTION:
This is used to exclude a special authority for use by a package namespace by selecting Yes.
820.01,2 MUMPS CODE 1;E1,245 MUMPS
INPUT TRANSFORM: K:$L(X)>245 X D:$D(X) ^DIM
LAST EDITED: JUL 01, 2025
HELP-PROMPT: Enter valid M code to determine when to ask if Special Authority is related.
DESCRIPTION:
Enter Mumps code to call to determine if this patient is eligible for this special authority.
TECHNICAL DESCR: Mumps code called in advance to determine if the user should be prompted for if treatment is
related to this special authority.
WRITE AUTHORITY: @
820,20 WHEN VALUES 2;0 SET Multiple #820.02
DESCRIPTION: Multiple rules can be entered to control the behavior of other Special Authorities.
When a Special Authority has a specific value, then actions can be taken on multiple linked other
Special Authorities.
820.02,.01 WHEN VALUE IS 0;1 SET (Multiply asked)
'NO' FOR No;
'YES' FOR Yes;
'UNA' FOR Unanswered;
LAST EDITED: JAN 31, 2025
HELP-PROMPT: Enter a specific value that this Special Authority needs and for a special action to be
performed.
DESCRIPTION: This is a specific value for this Special Authority, for which an action should be taken on
another linked Special Authority.
CROSS-REFERENCE: 820.02^B
1)= S ^PXIND(820,DA(1),2,"B",$E(X,1,30),DA)=""
2)= K ^PXIND(820,DA(1),2,"B",$E(X,1,30),DA)
820.02,1 ACTIONS 1;0 SET Multiple #820.021
DESCRIPTION: This file contains actions to be taken on any linked Special Authorities for this Special
Authorities specific value.
820.021,.01 ACTIONS 0;1 SET (Multiply asked)
'NO' FOR SetNo;
'YES' FOR SetYes;
'UNA' FOR SetUnanswered;
'DIS' FOR Disable;
'ENA' FOR Enable;
LAST EDITED: JAN 27, 2025
HELP-PROMPT: Enter a valid action to perform on the linked Special Authorities.
DESCRIPTION: This is the action to be taken on other linked authorities based on the current value of this
authority.
CROSS-REFERENCE: 820.021^B
1)= S ^PXIND(820,DA(2),2,DA(1),1,"B",$E(X,1,30),DA)=""
2)= K ^PXIND(820,DA(2),2,DA(1),1,"B",$E(X,1,30),DA)
820.02,2 LINKED SPECIAL AUTHORITIES 2;0 POINTER Multiple #820.022
LAST EDITED: JUN 25, 2024
DESCRIPTION: This multiple will link this Special Authority to other Special Authorities for the purpose of
applying special workflow relationship actions.
820.022,.01 LINKED SPECIAL AUTHORITIES 0;1 POINTER TO SPECIAL AUTHORITIES FILE (#820) (Multiply asked)
LAST EDITED: JAN 31, 2025
HELP-PROMPT: Enter a Special Authority to link to and perform actions on.
DESCRIPTION: This is another Special Authority that is linked to this Special Authority entry for actions
to be taken upon.
CROSS-REFERENCE: 820.022^B
1)= S ^PXIND(820,DA(2),2,DA(1),2,"B",$E(X,1,30),DA)=""
2)= K ^PXIND(820,DA(2),2,DA(1),2,"B",$E(X,1,30),DA)
FILES POINTED TO FIELDS
PACKAGE (#9.4) PACKAGE:PACKAGE (#.01)
SPECIAL AUTHORITIES (#820) LINKED SPECIAL AUTHORITIES:LINKED SPECIAL AUTHORITIES (#.01)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):