STANDARD DATA DICTIONARY #8925.99 -- TIU PARAMETERS FILE 3/24/25 PAGE 1
STORED IN ^TIU(8925.99, *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 1.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains the site-configurable parameters for the Text Integration Utilities package. It will have one entry for each
division, to support variable definition of package behavior at multi-divisional facilities.
DD ACCESS: @
RD ACCESS: @
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
CROSS
REFERENCED BY: INSTITUTION(B)
LAST MODIFIED: FEB 16,2024@11:32:04
8925.99,.01 INSTITUTION 0;1 POINTER TO INSTITUTION FILE (#4) (Required)
LAST EDITED: JAN 25, 2005
HELP-PROMPT: Enter your Institution.
DESCRIPTION:
Please enter the DIVISION these parameters apply to.
CROSS-REFERENCE: 8925.99^B
1)= S ^TIU(8925.99,"B",$E(X,1,30),DA)=""
2)= K ^TIU(8925.99,"B",$E(X,1,30),DA)
8925.99,.02 ENABLE ELECTRONIC SIGNATURE 0;2 SET (BOOLEAN Data Type)
LAST EDITED: MAR 28, 2023
HELP-PROMPT: Enter 'YES' to enable ELECTRONIC SIGNATURE for TIU Documents.
DESCRIPTION: Electronic signature is enabled when this parameter is set to 1. Until such time as electronic
signature is enabled, signatures are to be written on the chart copy of the TIU document, and
provision must be made for TIU documents to be marked Signed on Chart.
8925.99,.03 CHARACTERS PER LINE 0;3 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>80)!(X<10)!(X?.E1"."1N.N) X
LAST EDITED: JAN 25, 2005
HELP-PROMPT: Enter the number of characters per line, for line count computation (a # from 10 to 80).
DESCRIPTION: This value (default 60) is divided into the total number of 'actual' characters in a given
transcribed document to derive the line count for that document. By 'actual' characters, we mean
all printable ASCII characters, with multiple white space characters stripped. This prevents
transcriptionists from "stuffing" line counts by adding white space.
8925.99,.04 GRACE PERIOD FOR PURGE 0;4 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>7300)!(X<90)!(X?.E1"."1N.N) X
LAST EDITED: JAN 25, 2005
HELP-PROMPT: Type a Number between 90 and 7300, 0 Decimal Digits
DESCRIPTION: OUT OF SERVICE. Purging is disabled.
This is the number of days following transcription for which a document will be kept, prior to
purge. Allowable range is from 90 to 7300 days (20 years).
NOTE: Progress Notes and their addenda are not subject to purge, regardless of this parameter. IF
YOU WANT TO DISABLE PURGING ALTOGETHER, LEAVE THIS PARAMETER EMPTY (or delete any existing value).
8925.99,.05 GRACE PERIOD FOR SIGNATURE 0;5 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>10)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: JAN 30, 2023
HELP-PROMPT: Enter the number of days to wait before notifying physician of an overdue signature (1 to 10 days).
Default is TODAY.
DESCRIPTION: This is the number of days following transcription before an author or Attending Physician is
notified of a deficiency. If no grace period is entered, clinicians are not notified of overdue
signatures.
8925.99,.06 OPTIMIZE LIST BUILDING FOR 0;6 SET
'P' FOR performance;
'S' FOR security;
LAST EDITED: MAR 27, 2023
HELP-PROMPT: Please indicate whether Performance or Security should be optimized.
DESCRIPTION: This parameter determines whether or not TIU list building functions invoke business rules,
excluding from the list any documents the user is not authorized to see. Checking business rules
in this way optimizes list building for security. It may be costly in terms of performance.
When optimized for performance (the default behavior of TIU), business rules excluding notes from
view are bypassed when building lists of documents.
NOTE: This applies only to lists: when an unauthorized user attempts to view the contents of a
document from the resulting list, the user is prevented from doing so, with the following
explanation:
Reviewing Item #1
You may not VIEW this UNSIGNED NURSE'S NOTE.
RETURN to continue...
8925.99,.07 SUPPRESS REVIEW NOTES PROMPT 0;7 SET (BOOLEAN Data Type)
LAST EDITED: MAR 27, 2023
HELP-PROMPT: Indicate whether to suppress the Review Notes prompt on entry.
DESCRIPTION: Applies to Progress Notes only. When this parameter is set to YES, TIU suppresses the prompt which
asks if the user wishes to see available progress notes before entering a new note. This parameter
is overridden by the Personal Preference of same name. If neither parameter is entered, the Review
Notes prompt is NOT suppressed.
8925.99,.08 DEFAULT PRIMARY PROVIDER 0;8 SET
'0' FOR NONE, DON'T PROMPT;
'1' FOR DEFAULT, BY LOCATION;
'2' FOR AUTHOR (IF PROVIDER);
LAST EDITED: JUL 31, 1998
HELP-PROMPT: Please indicate the source of the default for Primary Provider.
DESCRIPTION: This parameter determines the behavior of the Primary Provider prompt for a standalone encounter.
If the parameter has no value, the prompt has no default. If the parameter has value 0, the user is
not prompted for primary provider. If the parameter has value 1, the default for the Primary
Provider prompt is the site's default provider for the given location. If the parameter has value
2, the default is the author if the author is a provider; if the author is not a provider, the
prompt has no default.
8925.99,.09 ASCII UPLOAD SOURCE 0;9 SET
'H' FOR host file server;
'R' FOR remote computer;
LAST EDITED: SEP 11, 1992
HELP-PROMPT: Please specify the source of the ASCII data to be uploaded.
DESCRIPTION: Applies only when the ASCII upload protocol is used. This field specifies the source from which
documents are uploaded. (H)ost indicates to the upload processor that the source of the data is an
ASCII host file (VMS or DOS), while (R)emote indicates that the data is read from an ASCII stream
coming to VISTA from a terminal emulator on a remote computer (for example, an IBM PC or
compatible, or an Apple Macintosh).
8925.99,.1 RECORD HEADER SIGNAL 0;10 FREE TEXT
INPUT TRANSFORM: K:$L(X)>10!($L(X)<1) X
LAST EDITED: FEB 11, 1993
HELP-PROMPT: Enter 1-10 characters to distinguish a record's header from its report text.
DESCRIPTION: This is a free text tag or signal used by the upload process to determine that a new document
record header has been encountered. It may be as simple as the three-character string "MSH" or as
complex as "HEADERBEGIN". The signal "@@@", used by the Surgery Package option to transmit
operative notes, is another possibility.
NOTE: Although you may define this parameter independently for each DIVISION, we recommend that you
choose just one such signal per site.
8925.99,.11 END OF MESSAGE SIGNAL 0;11 FREE TEXT
INPUT TRANSFORM: K:$L(X)>10!($L(X)<3) X
LAST EDITED: OCT 19, 1992
HELP-PROMPT: Enter 3-10 characters to signal end of upload message.
DESCRIPTION: Applies only to transfers made using the ASCII protocol. This is the free text signal to the
upload process that the entire file/stream has been transmitted without difficulty, and no more
lines of data need to be read.
8925.99,.12 BEGIN REPORT TEXT SIGNAL 0;12 FREE TEXT
INPUT TRANSFORM: K:$L(X)>10!($L(X)<1) X
LAST EDITED: OCT 19, 1992
HELP-PROMPT: Enter 1-10 characters to delimit report text from record header.
DESCRIPTION: This is the signal to the upload processor that the fixed-field header for a given report record
has been fully read, and that the body of the narrative report follows.
8925.99,.13 MAJOR DELIMITER 0;13 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1!($L(X)<1)!'(X?1P) X
LAST EDITED: OCT 20, 1992
HELP-PROMPT: Enter the major delimiter of the message header.
DESCRIPTION: This ASCII character separates the various pieces of fixed-field information in the message header.
Please avoid using delimiters such as ",", or ":", which may be contained within the data itself,
using instead less common symbols such as "|", "\" or "~".
8925.99,.14 FUTURE APPOINTMENT RANGE 0;14 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>180)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: OCT 14, 1998
HELP-PROMPT: How many days in advance may future appointments be selected?
DESCRIPTION: This parameter determines how far in advance a future appointment may be selected when entering a
document for outpatient care.
Allowable values range from 1 to 180 days, defaulting to 1 day.
8925.99,.15 PACE CHARACTER 0;15 FREE TEXT
INPUT TRANSFORM: K:$L(X)>3!($L(X)<1) X S:X'?1.3N X=$A(X)
LAST EDITED: MAR 27, 2023
HELP-PROMPT: Enter the character used to prompt the remote for another line of text.
DESCRIPTION: Applies only to transfers which use the ASCII protocol.
This is the ASCII value of the character which VistA sends to the remote computer to acknowledge
receipt of the previous text line and to prompt the remote to transmit another line. You may choose
any character with an ASCII value between 1 and 126.
If you are using the same remote to upload both MailMan messages and textual reports, then we
recommend using the ">" symbol, ASCII 62. Otherwise, we suggest using the ACK character (ASCII 6).
NOTE: you may need to specify the same character as part of the ASCII PROTOCOL parameters of the
terminal emulation software on the remote.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
8925.99,.16 UPLOAD HEADER FORMAT 0;16 SET
'C' FOR captioned;
'D' FOR delimited string;
LAST EDITED: APR 08, 1993
HELP-PROMPT: Enter the preferred format to be used for ASCII record headers.
DESCRIPTION: This field determines whether the upload filer expects delimited string or captioned formats for
the header of each document.
8925.99,.17 UPLOAD PROTOCOL 0;17 SET
'a' FOR ASCII;
'k' FOR KERMIT;
LAST EDITED: FEB 27, 1993
HELP-PROMPT: Select preferred upload protocol
DESCRIPTION:
This is the upload protocol used to transmit documents, with a for ASCII, or k for KERMIT.
8925.99,.18 RUN UPLOAD FILER IN FOREGROUND 0;18 SET (BOOLEAN Data Type)
LAST EDITED: MAR 27, 2023
HELP-PROMPT: Indicate whether the upload filer should run interactively.
DESCRIPTION: This parameter specifies whether to run the filer for the upload process in the foreground or in
the background (as a Task).
If no preference is specified, the filer runs in the BACKGROUND.
8925.99,.22 ENABLE CHART COPY PROMPT 0;22 SET (BOOLEAN Data Type)
LAST EDITED: MAR 27, 2023
DESCRIPTION:
OUT OF SERVICE. See TIU Document Parameter ALLOW CHART PRINT OUTSIDE MAS.
8925.99,.23 ENABLE DICTATION CONTROL 0;23 SET (BOOLEAN Data Type)
LAST EDITED: MAR 28, 2023
HELP-PROMPT: Enter 'YES' to enable dictation functionality.
DESCRIPTION: A YES in this field will turn on dictation functionality introduced by patch TIU*1*297. A NO or
lack of entry will turn off this dictation functionality.
When dictation functionality is turned on and a progress note is started and the phrase "TO BE
DICTATED" is entered in the very first line by an author who holds the TIUDCT security key, the
entire note will be replaced with dictation instructions taken from the DICTATION INSTRUCTIONS
Field (#6).
8925.99,1.05 AMENDMENT SIGNATURE BLOCK 1;5 FREE TEXT
INPUT TRANSFORM: K:$L(X)>80!($L(X)<3) X
LAST EDITED: OCT 26, 1992
HELP-PROMPT: Enter the Privacy Act Officer's signature block.
DESCRIPTION: OUT OF SERVICE. The signer's normal signature block is used for amendments.
This parameter allows the site to specify the format of the signature block for an amendment.
While Business Rules determine who may amend documents, generally it is the user class CHIEF,MIS
who may do so. If this user is not the site's Privacy Act officer, then it may be desirable to
enter a statement indicating that the user is signing on behalf of the Privacy Act Officer.
For example, if the user's name is John Smith, while the site's Privacy Act Officer is Jane Doe,
RRT, then the AMENDMENT SIGNATURE BLOCK might be entered as: "for Jane Doe, RRT, PRIVACY ACT
OFFICER".
The amendment information on the document would then appear as:
AMENDED 10/26/92
/es/ JOHN SMITH
for Jane Doe, RRT, PRIVACY ACT OFFICER
8925.99,1.06 BLANK CHARACTER STRING 1;6 FREE TEXT
INPUT TRANSFORM: K:$L(X)>3!($L(X)<3) X
LAST EDITED: JAN 14, 1993
HELP-PROMPT: Answer must be 3 characters in length.
DESCRIPTION: This string of characters is used by the transcriptionist to represent a "blank" when a word or
phrase in the dictation cannot be understood for inclusion in the transcription.
8925.99,1.07 ENABLE NOTIFICATIONS DATE 1;7 DATE
INPUT TRANSFORM: S %DT="EX" D ^%DT S X=Y K:Y<1 X
LAST EDITED: FEB 03, 1993
HELP-PROMPT: Enter the date on which to enable signature notifications.
DESCRIPTION: This date indicates to TIU when to begin sending signature notifications (available/overdue for
signature) to expected signers/cosigners. Notifications are sent beginning on this date, and only
for documents entered on/after this date.
8925.99,2 UPLOAD ERROR ALERT RECIPIENT 2;0 POINTER Multiple #8925.992
LAST EDITED: APR 13, 1993
DESCRIPTION: These persons receive alerts from the upload/filer process when a document cannot be filed/located
or has missing fields.
This field is OVERRIDDEN by recipients set for the given document type in parameter FILING ERROR
ALERT RECIPIENTS in the TIU DOCUMENT PARAMETERS file.
8925.992,.01 ALERT RECIPIENT 0;1 POINTER TO NEW PERSON FILE (#200) (Multiply asked)
LAST EDITED: MAR 27, 2023
HELP-PROMPT: Enter the NEW PERSON to receive an alert when an upload error occurs.
DESCRIPTION: These persons receive alerts from the upload/filer process when a document cannot be
filed/located or has missing fields.
This field is OVERRIDDEN by recipients set for the given document type in parameter FILING ERROR
ALERT RECIPIENTS in the TIU DOCUMENT PARAMETERS file.
CROSS-REFERENCE: 8925.992^B
1)= S ^TIU(8925.99,DA(1),2,"B",$E(X,1,30),DA)=""
2)= K ^TIU(8925.99,DA(1),2,"B",$E(X,1,30),DA)
8925.99,3.1 START OF ADD SGNR ALERT PERIOD 3;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>5!($L(X)<1)!'((X?1.4N1"D")!(X?1.4N1"W")!(X?1.4N1"M")) X
MAXIMUM LENGTH: 5
LAST EDITED: JAN 30, 2023
HELP-PROMPT: Equivalent to LENGTH OF SIGNER ALERT PERIOD but for ADDITIONAL SIGNATURES. Must be 1-4 NUMBERS
followed by "D", "W" or "M". Default is 7D.
DESCRIPTION: This parameter determines how far back the nightly task will look for overdue additional
signatures.
If blank, defaults to 12M.
This parameter should be set to the same value as the LENGTH OF SIGNER ALERT PERIOD to avoid any
potential gaps in resending alerts.
If this parameter is less than the LENGTH OF SIGNER ALERT PERIOD, documents that fall between the
date ranges will NOT have alerts sent as OVERDUE.
Example: LENGTH OF SIGNER ALERT PERIOD=12M
START OF ADD SGNR ALERT PERIOD=6M
Documents that have outstanding additional signatures between 6M+1-12M will be excluded.
8925.99,3.2 END OF ADD SGNR ALERT PERIOD 3;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>5!($L(X)<1)!'((X?1.4N1"D")!(X?1.4N1"W")!(X?1.4N1"M")) X
LAST EDITED: JAN 13, 2023
HELP-PROMPT: This is equivalent to the GRACE PERIOD FOR SIGNATURE for additional signature. Must be 1-4 NUMBERS
followed by "D", "W", or "M". Default is TODAY.
DESCRIPTION: This is the length in time from the current date that the TIU NIGHTLY TASK will stop regenerating
alerts for overdue additional signatures. The value must be in a FileMan date range format such as
6D, 3W or 4M.
If no value is entered, the TIU NIGHTLY TASK will search for documents in the TIU DOCUMENT File
(8925) up to the current date.
8925.99,3.3 LENGTH OF SIGNER ALERT PERIOD 3;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>5!($L(X)<1)!'((X?1.4N1"D")!(X?1.4N1"W")!(X?1.4N1"M")) X
MAXIMUM LENGTH: 5
LAST EDITED: JAN 13, 2023
HELP-PROMPT: This parameter determines how far back the TIU NIGHTLY TASK will look for OVERDUE signatures. Must
be 1-4 NUMBERS followed by "D", "W", or "M". Default is 12M.
DESCRIPTION: This is the length of time that the TIU NIGHTLY TASK will go back prior to "today" when searching
for documents that have overdue signatures. The value must be in a FileMan date range format such
as 6D, 3W or 4M.
If no value is entered, the TIU NIGHTLY TASK will begin searching for documents starting at 1 year
prior to "today" in the TIU DOCUMENTS file (8925).
8925.99,4.1 MINIMUM COPY WORDS 4;1 NUMBER (Required)
INPUT TRANSFORM: K:+X'=X!(X>99)!(X<5)!(X?.E1"."1N.N) X
LAST EDITED: JUN 26, 2015
HELP-PROMPT: Type a number between 5 and 99, 0 decimal places.
DESCRIPTION: This field defaults to 5 words if no value is set. As this determines what is captured as copied
text, this value can play a significant role in what is tracked. The smaller this number, the more
copy actions will be captured. Each site will need to determine the appropriate level of capture
which is ideal for their individual needs.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
8925.99,4.2 COPY/PASTE VERIFY PERCENTAGE 4;2 NUMBER (Required)
INPUT TRANSFORM: K:+X'=X!(X>100)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: JUN 26, 2015
HELP-PROMPT: Type a number between 1 and 100, 0 decimal digits.
DESCRIPTION: This field defaults to 90% if no value is set. This field plays a significant part in determining
when pasted text is identified as originating from a previously captured copy action. The higher
the percentage, the less likely pasted text will be identified as originating from copied text.
Each site will need to determine the appropriate level of percentage match which is ideal for their
individual needs.
8925.99,4.4 COPY/PASTE USERCLASS 5;0 POINTER Multiple #8925.9901
DESCRIPTION: This field is empty to begin. The copy/paste software will always provide the "CHIEF, HIMS",
"CHIEF, MIS", and the "PRIVACY ACT OFFICER" userclasses as having the ability to view copy/paste
highlighting in CPRS. If sites wish to provide another userclass these rights, then they should add
an existing userclass to this entry.
8925.9901,.01 USERCLASS 0;1 POINTER TO USR CLASS FILE (#8930) (Multiply asked)
INPUT TRANSFORM: S DIC("S")="I $D(^USR(8930,""D"",1,Y))" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
LAST EDITED: JUN 26, 2015
HELP-PROMPT: Choose a userclass to have authorization to view pasted text in documents.
DESCRIPTION: This field is empty to begin. The copy/paste software will always provide the "CHIEF, HIMS",
"CHIEF, MIS", and the "PRIVACY ACT OFFICER" userclasses as having the ability to view copy/paste
highlighting in CPRS. If sites wish to provide another userclass these rights, then they should
add an existing userclass to this entry.
SCREEN: S DIC("S")="I $D(^USR(8930,""D"",1,Y))"
EXPLANATION: Allow selection of active userclasses only.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
CROSS-REFERENCE: 8925.9901^B
1)= S ^TIU(8925.99,DA(1),5,"B",$E(X,1,30),DA)=""
2)= K ^TIU(8925.99,DA(1),5,"B",$E(X,1,30),DA)
8925.99,6 DICTATION INSTRUCTIONS 6;0 WORD-PROCESSING #8925.9902
DESCRIPTION: This field is only meaningful when the ENABLE DICTATION CONTROL (#.23) field is set to YES. This
field should contain text instructions specific to this institution for dictating text into a
patient's progress note.
Within this field you may reference local variables or expressions by placing them between vertical
bars. For example, to reference the internal entry number of this document type |TIUDA|.
Local variables available are TIUDA, TIUL5, and TIUINST. TIUDA is the internal entry number of the
current document. TIUL5 is the last 5 digits of TIUDA. TIUINST is the internal entry number of the
INSTITUTION of the currently logged in user. Kernel's software-wide variables as defined in the
kernel technical manual and FileMan's package-wide variables as defined in the FileMan technical
manual may be used as well.
LAST EDITED: APR 23, 2017
HELP-PROMPT: Enter instruction for this Dictation Control
FILES POINTED TO FIELDS
INSTITUTION (#4) INSTITUTION (#.01)
NEW PERSON (#200) UPLOAD ERROR ALERT RECIPIENT:ALERT RECIPIENT (#.01)
USR CLASS (#8930) COPY/PASTE USERCLASS:USERCLASS (#.01)
INPUT TEMPLATE(S):
TIU BASIC PARAMETER EDIT JAN 13, 2023@09:31 USER #0
TIU UPLOAD PARAMETER EDIT MAR 27, 1996@11:15 USER #0
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):