STANDARD DATA DICTIONARY #3.077 -- ERROR TRAP SUMMARY FILE 6/27/25 PAGE 1
STORED IN ^%ZTER(3.077, *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 8.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This is a tool for capturing the VistA errors at each site. These findings can be used locally and pushed to a central repository
to help to prioritize the efforts to seal up the hot spots in the applications.
CROSS
REFERENCED BY: ERROR TEXT(B), ERROR TEXT(C), DATE/TIME OF ERROR(D), USER NAME(USER)
3.077,.01 ERROR TEXT 0;1 FREE TEXT (Required)
ERR TXT
INPUT TRANSFORM: K:$L(X)>60!($L(X)<3)!'(X'[U) X
LAST EDITED: MAR 05, 2008
HELP-PROMPT: Answer must be 3-60 characters in length
DESCRIPTION: This is the text captured with the error. It is a means of providing a common key for the errors
to be clustered under. Each one will has a series of characteristics which will be captured for
later analysis even after the error has been purged off of the ^%ZTER global. The first date and
time is stored as will be the most recent occurrence.
TECHNICAL DESCR: This string will be parsed off of the $ZE sting. If the string is not there, then an "[Unknown
Xecute]" will be created to store these cases.
CROSS-REFERENCE: 3.077^B
1)= S ^%ZTER(3.077,"B",$E(X,1,30),DA)=""
2)= K ^%ZTER(3.077,"B",$E(X,1,30),DA)
CROSS-REFERENCE: 3.077^C^KWIC
1)= S %1=1 F %=1:1:$L(X)+1 S I=$E(X,%) I ",~<>():;"[I S I=$E($E(X,%1,%-1),1,30),%1=%+1 I $L(I)>2,^D
D("KWIC")'[I S ^%ZTER(3.077,"C",I,DA)=""
2)= S %1=1 F %=1:1:$L(X)+1 S I=$E(X,%) I ",~<>():;"[I S I=$E($E(X,%1,%-1),1,30),%1=%+1 I $L(I)>2 K
^%ZTER(3.077,"C",I,DA)
3)= Used to make lookup easy
3.077,1 FIRST DATE/TIME 0;2 DATE
INPUT TRANSFORM: S %DT="EST" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 05, 2008
DESCRIPTION: This is the first date and time that the error has occurred. It is of historic importance and can
be used to find the causative event of the error that is being reported.
3.077,2 MOST RECENT DATE/TIME 0;3 DATE
INPUT TRANSFORM: S %DT="EST" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 24, 2009
DESCRIPTION: This is the most recent time that the situation has happened. It is important in that it is the
most likely to still be in the error trap global, ^%ZTER.
TECHNICAL DESCR: As this gets updated, the date is compared with the date/time stored here. This will help to
identify any items which may need to be accessioned into this summary. It may also be used to help
purge any errors which have not been active in a long time (and perhaps is now obsolete code).
3.077,3 ROUTINE NAME 0;4 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<2) X
LAST EDITED: MAR 05, 2008
HELP-PROMPT: Answer must be 2-20 characters in length.
DESCRIPTION: This is the name of the routine in question. It will be parsed out of the error string in .01.
This will make the errors much easier to cluster around the causitive routine. This may actually
be amended from the error string presentation if the causative program is found to be different.
3.077,3.1 APPLICATION 0;5 POINTER TO PACKAGE FILE (#9.4)
LAST EDITED: MAR 05, 2008
DESCRIPTION: This field will help to identify who are the responsible parties for this problem. Eventually, as
a package is identified, the primaries and secondaries will be notified of the problem
automatically as the problem happens.
TECHNICAL DESCR: This is a pointer to the Package File. Each package should indicate a mail group that tracks the
responsible parties for this specific package. This should include any IRM primary and secondary
folks as well as any ADPAC personnel in the specific area of concern with this package. The groups
should be self-enrolling and be able to receive the generated email that will be batched for the
errors of the day.
3.077,4 FREQUENCY 0;6 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>99999999)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: OCT 23, 2007
HELP-PROMPT: Type a Number between 1 and 99999999, 0 Decimal Digits
DESCRIPTION: This is the number of times that the error has been encountered, ever. See FREQUENCY DISTRIBUTION
below for how the error is occurring during the run of the day.
3.077,5 FREQUENCY DISTRIBUTION 4;0 Multiple #3.0775 (Add New Entry without Asking)
LAST EDITED: OCT 23, 2007
3.0775,.001 HOROLOG DATE NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999999)!(X<10000)!(X?.E1"."1.N) X
OUTPUT TRANSFORM: S Y=$$HTE^XLFDT(Y)
LAST EDITED: NOV 01, 2007
HELP-PROMPT: Type a number between 10000 and 999999, 0 Decimal Digits
3.0775,.01 FREQUENCY DISTRIBUTION 0;1 FREE TEXT
INPUT TRANSFORM: K X
LAST EDITED: DEC 18, 2007
HELP-PROMPT: Type a Frequency Distribution, 3 to 100 characters
WRITE AUTHORITY: ^
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
3.077,6 LAST GLOBAL 3;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>240!($L(X)<2) X
LAST EDITED: DEC 17, 1999
HELP-PROMPT: Answer must be 2-240 characters in length.
DESCRIPTION: This is the last global referenced with the first such error recorded. If subsequent errors are
recorded, and have different globals listed, they will be recorded in the following detail under
ERROR EVENTS.
3.077,7 STACK LIST 6;E1,245 FREE TEXT
INPUT TRANSFORM: K:$L(X)>245!($L(X)<3) X
LAST EDITED: OCT 31, 2007
HELP-PROMPT: Answer must be 3-245 characters in length
DESCRIPTION: This is generated from the GETSTK^XTERSUM function call. It is the chain of calling levels which
were accessed to bring about the error.
WRITE AUTHORITY: @
3.077,8 UPLOADED DATE/TIME 0;7 DATE
INPUT TRANSFORM: S %DT="ESTX" D ^%DT S X=Y K:X<1 X
LAST EDITED: APR 03, 2008
HELP-PROMPT: (No range limit on date)
DESCRIPTION: This field holds the date/time that the Error Summary was set to a consolidation site. A message
will be sent if this field in empty or less than the "Last seen" field.
3.077,10 ERROR EVENTS 1;0 Multiple #3.07701
DESCRIPTION: This is the $H date and the Sequence number of this error on that $H date. It provides an easy way
to scan quickly historic occurrences of these errors. Long period failures will become more
evident when they start showing up as reoccurring situations which will need to be dealt with.
TECHNICAL DESCR: This will be pulled from the $H day subscript in ^%ZTER( and the sequence number which provides the
error profile. It will look like; 58054:3
3.07701,.01 ERROR EVENTS 0;1 FREE TEXT (Multiply asked)
INPUT TRANSFORM: K:$L(X)>30!($L(X)<2)!'(X?5.6N1":"1.E) X
LAST EDITED: MAR 05, 2008
HELP-PROMPT: Answer must be 2-30 characters in length
DESCRIPTION: This is the list of captured errors of this type in the form of +$H:NN where $H is the +$Horolog
day count, and NN is the sequence number that records the nnth error for that day. So if the
error is still available, then, the details can be collected. This scheme will ensure that each
occurrence is unique.
CROSS-REFERENCE: 3.07701^B
1)= S ^%ZTER(3.077,DA(1),1,"B",$E(X,1,30),DA)=""
2)= K ^%ZTER(3.077,DA(1),1,"B",$E(X,1,30),DA)
3.07701,1 DATE/TIME OF ERROR 0;2 DATE
INPUT TRANSFORM: S %DT="EST" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 05, 2008
DESCRIPTION:
This is the date and time as described in the error report, but converted to FileMan format.
CROSS-REFERENCE: 3.077^D
1)= S ^%ZTER(3.077,"D",$E(X,1,30),DA(1),DA)=""
2)= K ^%ZTER(3.077,"D",$E(X,1,30),DA(1),DA)
This cross reference gives the time frames of these events and makes it easier to reconstruct the
chain of events.
3.07701,2 LINE IF DIFFERENT 1;E1,245 FREE TEXT
INPUT TRANSFORM: K:$L(X)>245!($L(X)<3) X
LAST EDITED: OCT 31, 2007
HELP-PROMPT: Answer must be 3-245 characters in length
DESCRIPTION:
This is the offending line of code as captured by the interpreter.
WRITE AUTHORITY: @
3.07701,3 LAST GLOBAL IF DIFFERENT 2;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>240!($L(X)<2) X
LAST EDITED: DEC 17, 1999
HELP-PROMPT: Answer must be 2-240 characters in length.
3.07701,4 $ZHOROLOG DETAIL 0;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>40!($L(X)<1) X
LAST EDITED: OCT 31, 2007
HELP-PROMPT: Answer must be 1-40 characters in length
3.07701,5 USER DUZ 0;4 FREE TEXT
INPUT TRANSFORM: K:$L(X)>12!($L(X)<1)!'(X!(X?1.12N)) X
LAST EDITED: DEC 30, 1999
HELP-PROMPT: Answer must be 1-12 characters in length.
DESCRIPTION: This is the user who experienced the problem. This will make it easier for us to check if this
is a needs problem or a training problem.
TECHNICAL DESCR: This and the rest of this record are loaded from the Error Trap, ^%ZTER(1,. The routine to do
this transformation and consolidation is XTERSUM. It is in the name space reserved by Chris
Richardson and was built during his time at the San Diego VA in La Jolla.
3.07701,6 STACK PATH 6;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>250!($L(X)<2) X
LAST EDITED: MAR 24, 2009
HELP-PROMPT: Answer must be 2-250 characters in length.
DESCRIPTION: This is the path by which the error level of execution was accessed. It is a series of segments,
each representing a level of execution in the model as it was being performed. Occasionally this
list of segments will exceed the string length so some judicious exiting has been done to keep
the stack list manageable. Should the list need to be trimmed, segments will be taken out of the
middle of the stack to accommodate the string limits. These omissions are marked with an
ellipsis "..." where a segment or segments have been deleted.
A segment looks like this;
LABEL[+offset]^RTN:command step
The set of segments is wrapped in square brackets and stored in its entirety in the event node
for comparison with other events.
3.07701,11 USER NAME 3;1 POINTER TO NEW PERSON FILE (#200)
LAST EDITED: MAR 24, 2009
DESCRIPTION:
User Pointer who was on when the error occurred.
CROSS-REFERENCE: 3.077^USER
1)= S ^%ZTER(3.077,"USER",$E(X,1,30),DA(1),DA)=""
2)= K ^%ZTER(3.077,"USER",$E(X,1,30),DA(1),DA)
This allows the lookup by Users.
3.07701,12 OPTION USED 3;2 POINTER TO OPTION FILE (#19)
LAST EDITED: DEC 23, 1999
DESCRIPTION:
This is the POINTER to the Option File that was being used at the time of the error.
3.07701,13 OPTION NAME 3;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<2) X
LAST EDITED: DEC 23, 1999
HELP-PROMPT: Answer must be 2-30 characters in length.
DESCRIPTION:
This is the name of the option pointed to in field 2.
3.07701,14 TASK REFERENCED 3;4 POINTER TO FILE (#14.4)
LAST EDITED: DEC 23, 1999
DESCRIPTION:
This is the task being performed (if it was a task).
3.07701,15 GLOBAL VOLUME 3;5 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<2) X
LAST EDITED: OCT 31, 2007
HELP-PROMPT: Answer must be 2-8 characters in length
DESCRIPTION:
This is the Global Volumes being accessed when the task started.
3.07701,16 ROUTINE VOLUME 3;6 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<2) X
LAST EDITED: MAR 05, 2008
HELP-PROMPT: Answer must be 2-8 characters in length
DESCRIPTION:
This is the Routine Set being used when the Error Occurred.
TECHNICAL DESCR:
This and the surrounding variables came from the Error Trap and XUENV.
3.07701,17 HOST CPU 3;7 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<2) X
LAST EDITED: OCT 31, 2007
HELP-PROMPT: Answer must be 2-8 characters in length
DESCRIPTION:
This is the Name of the CPU the program was running on.
3.07701,18 RPC BROKER STATE 3;8 FREE TEXT
INPUT TRANSFORM: K:$L(X)>40!($L(X)<2) X
LAST EDITED: DEC 23, 1999
HELP-PROMPT: Answer must be 2-40 characters in length.
DESCRIPTION:
This is the description of the Broker Task being performed.
3.07701,19 UPLOADED 0;5 SET
'0' FOR No;
'1' FOR Yes;
LAST EDITED: MAR 26, 2009
DESCRIPTION:
This field tells if this error has been reported to a central repository.
3.077,20 LINE OF CODE 2;E1,245 FREE TEXT
INPUT TRANSFORM: K:$L(X)>245!($L(X)<3) X
LAST EDITED: MAR 05, 2008
HELP-PROMPT: Answer must be 3-245 characters in length
DESCRIPTION: This is the original line of code which caused this problem. It should be the same for all
occurrences, but may reflect other failures on the same line.
WRITE AUTHORITY: @
3.077,30 DISCUSSION 30;0 WORD-PROCESSING #3.07702
LAST EDITED: MAR 29, 2000
DESCRIPTION: This is the set of notes used to track special handling or corrective actions taken to solve the
problem.
3.077,31 SUPPORT PERSONNEL 31;0 POINTER Multiple #3.077031 (Add New Entry without Asking)
3.077031,.01 SUPPORT PERSONNEL 0;1 POINTER TO NEW PERSON FILE (#200)
LAST EDITED: MAR 29, 2000
DESCRIPTION: This is the person assigned to deal with the problem. The date assigned will be a companion data
item to this information.
TECHNICAL DESCR: The chain of support folks should be easy to follow and track who is working on a specific
problem.
CROSS-REFERENCE: 3.077031^B
1)= S ^%ZTER(3.077,DA(1),31,"B",$E(X,1,30),DA)=""
2)= K ^%ZTER(3.077,DA(1),31,"B",$E(X,1,30),DA)
3.077031,1 WHEN ASSIGNED 0;2 DATE
INPUT TRANSFORM: S %DT="EST" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 29, 2000
DESCRIPTION:
This is the date that the SW Engineer was assigned the problem.
3.077031,2 LAST ACTIVITY DATE 0;3 DATE
INPUT TRANSFORM: S %DT="EST" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 29, 2000
DESCRIPTION:
This is the date and time of the last operation on this problem.
FILES POINTED TO FIELDS
NEW PERSON (#200) ERROR EVENTS:USER NAME (#11)
SUPPORT PERSONNEL:SUPPORT PERSONNEL (#.01)
OPTION (#19) ERROR EVENTS:OPTION USED (#12)
PACKAGE (#9.4) APPLICATION (#3.1)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
XTER ERROR SUMMARY FEB 27, 2008@13:36 USER #0 ^XUCT ERROR TRAP SUMMARY LIST
XTER SUMMARY MOVE OCT 31, 2007 USER #0
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):