STANDARD DATA DICTIONARY #15.2 -- XDR MERGE PROCESS FILE 3/24/25 PAGE 1
STORED IN ^VA(15.2, *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 7.3)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
When a merge process is set up, all its information is stored in this file. Once a merge process has completed, that entry may be
purged using the Purge Merge Process File option in the managers menu.
DD ACCESS: @
WR ACCESS: #
DEL ACCESS: #
LAYGO ACCESS: #
AUDIT ACCESS: #
POINTED TO BY: MERGE PROCESS field (#.2) of the DUPLICATE RECORD File (#15)
CROSS
REFERENCED BY: NAME(B)
15.2,.01 NAME 0;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>30!(X?.N)!($L(X)<3)!'(X'?1P.E) X
HELP-PROMPT: NAME MUST BE 3-30 CHARACTERS, NOT NUMERIC OR STARTING WITH PUNCTUATION
CROSS-REFERENCE: 15.2^B
1)= S ^VA(15.2,"B",$E(X,1,30),DA)=""
2)= K ^VA(15.2,"B",$E(X,1,30),DA)
15.2,.02 MERGE FILE NUMBER 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1)!'(X?.N.".".N) X
LAST EDITED: APR 16, 1996
HELP-PROMPT: Answer must be 1-20 characters in length and indicate the primary FILE NUMBER in which entries are
being merged.
DESCRIPTION:
This field indicates the primary file for which this merge process is being run.
15.2,.03 START DATE/TIME 0;3 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This field indicates the date/time on which the merge process originally started (or is scheduled
to start, if in the future).
DESCRIPTION: This field indicates the original date and time when the merge process began, or if in the future,
is scheduled to start.
15.2,.04 STATUS 0;4 SET
'S' FOR SCHEDULED;
'A' FOR ACTIVE NOW;
'C' FOR COMPLETED;
'U' FOR UNKNOWN-LOST;
'R' FOR RESCHEDULED;
LAST EDITED: NOV 29, 1995
HELP-PROMPT: This field indicates the current status of this merge process.
DESCRIPTION: This field is used to track the current status of the merge process. The choices are:
SCHEDULED - this process is scheduled to run as a task - the start
date/time should be indicated in field .03
ACTIVE - the process is currently running and is actively updating
the current time value for the process.
COMPLETED - the process ran through the all entries to normal
completion.
UNKNOWN-LOST - this is an abnormal status and is set when a supposedly
active process is no longer updating the current time
value for the process (and has not for a period of time).
RESCHEDULED - the process is scheduled to restart and continue from its
last checkpointed location. The restart time should be
indicated in field .05
15.2,.05 RESTART DATE/TIME 0;5 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: NOV 29, 1995
HELP-PROMPT: This value indicates the date and time at which the LAST restart for the merge process began or is
scheduled (if in the future).
DESCRIPTION: This value indicates the date and time when the merge process was last restarted or, if in the
future, is scheduled to restart. A restart date/time would only be entered if the merge process
was not successful in completing in its first run. If multiple restarts are required to reach
completion, only the last restart would be indicated.
15.2,.06 COMPLETION DATE/TIME 0;6 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: NOV 29, 1995
HELP-PROMPT: This value indicates the Date and Time when the merge process was completed
DESCRIPTION:
This value indicates the date and time when the merge process was successfully completed.
15.2,.07 NUMBER OF RESTARTS 0;7 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>100)!(X<0)!(X?.E1"."1N.N) X
LAST EDITED: NOV 29, 1995
HELP-PROMPT: This value indicates the number of times that the merge process was restarted.
DESCRIPTION: This field is a simple count of the number of restarts which were required prior to completion of
the merge process.
15.2,.08 TASK NUMBER 0;8 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1)!'(X?1.N) X
LAST EDITED: NOV 29, 1995
HELP-PROMPT: This field contains the task number currently associated with the merge process (scheduled, active,
or completed).
DESCRIPTION: This field shows the task number currently associated with this merge process (scheduled, active,
or completed).
15.2,.09 HALT FLAG 0;9 SET
'1' FOR HALT;
LAST EDITED: JUN 17, 1996
HELP-PROMPT: This flag is set if the merge process is to halt.
DESCRIPTION: This field is a flag which is set if the merge process is supposed to halt. While the flag might
be set manually, it normally would be set by the process when taskmanager indicates the process is
to halt, or if a halt merge process option sets the flag. The flag is necessary to permit
communication to multiple threads during processing of phase 3.
15.2,2 MERGE ENTRY 2;0 Multiple #15.22 (Add New Entry without Asking)
15.22,.01 MERGE ENTRY 0;1 FREE TEXT (Multiply asked)
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1)!'(X?.N.".".N) X
LAST EDITED: NOV 29, 1995
HELP-PROMPT: This is the internal entry number to be merged in the merge process.
DESCRIPTION:
This is the internal entry number to be merged during the merge process.
CROSS-REFERENCE: 15.22^B
1)= S ^VA(15.2,DA(1),2,"B",$E(X,1,30),DA)=""
2)= K ^VA(15.2,DA(1),2,"B",$E(X,1,30),DA)
15.22,.02 MERGE TO 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1)!'(X?.N.".".N) X
LAST EDITED: NOV 29, 1995
HELP-PROMPT: This is the internal entry number to which the MERGE ENTRY is being merged.
DESCRIPTION:
This is the internal entry number to which the MERGE ENTRY (field .01) is being merged.
15.22,.03 DUPLICATE FILE ENTRY 0;3 POINTER ***** TO AN UNDEFINED FILE (#15), STORED IN ^VA(15) *******
LAST EDITED: APR 19, 1996
HELP-PROMPT: This is a pointer back to the Duplicate File Entry for this pair.
DESCRIPTION: This pointer back to the entry in the duplicate file for this pair is used to easily mark the
correct entries on completion of the merge.
15.2,3 PACKAGE BEING MERGED 3;0 Multiple #15.23 (Add New Entry without Asking)
LAST EDITED: APR 17, 1996
15.23,.01 PACKAGE BEING MERGED 0;1 FREE TEXT (Multiply asked)
INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X
LAST EDITED: APR 17, 1996
HELP-PROMPT: Answer must be 1-30 characters in length.
DESCRIPTION: During a merge process, there is the merge of the primary file. There may also be merges of
related files which require special processing (as indicated by entries within the 'Affects
Merge' multiple of the package file). This entry indicates which file merge the associated data
is related to. The entry is a file number for which a merge is being run.
CROSS-REFERENCE: 15.23^B
1)= S ^VA(15.2,DA(1),3,"B",$E(X,1,30),DA)=""
2)= K ^VA(15.2,DA(1),3,"B",$E(X,1,30),DA)
15.23,.02 START DATE/TIME 0;2 DATE (Required)
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This value indicates the date and time that the merge process was actually initiated or is
scheduled to be started (if it is in the future).
DESCRIPTION:
The date and time at which the merge process actually began.
15.23,.03 STATUS 0;3 SET
'A' FOR ACTIVE;
'C' FOR COMPLETED;
'U' FOR UNKNOWN-LOST;
'R' FOR RESCHEDULED;
'S' FOR SCHEDULED;
'H' FOR HALTED;
'E' FOR ERROR EXIT;
LAST EDITED: APR 18, 1996
HELP-PROMPT: This field indicates the current status of this merge process.
DESCRIPTION: This field is used to track the current status of the merge process. The choices are:
SCHEDULED - this process is scheduled to run as a task - the start
date/time should be indicated in field .02
ACTIVE - the process is currently running and is actively updating
the current time value for the process.
COMPLETED - the process ran through the all entries to normal
completion.
UNKNOWN-LOST - this is an abnormal status and is set when a supposedly
active process is no longer updating the current time
value for the process (and has not for a period of time).
RESCHEDULED - the process is scheduled to restart and continue from its
last checkpointed location. The restart time should be
indicated in field .05
15.23,.04 RESTART DATE/TIME 0;4 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This value indicates the date and time at which the LAST restart for the merge process began or
is scheduled (if in the future).
DESCRIPTION: This value indicates the date and time when the merge process was last restarted or, if in the
future, is scheduled to restart. A restart date/time would only be entered if the merge process
was not successful in completing in its first run. If multiple restarts are required to reach
completion, only the last restart would be indicated.
15.23,.05 COMPLETION DATE/TIME 0;5 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This value indicates the Date and Time when the merge process was completed.
DESCRIPTION:
This value indicates the Date and Time when the merge process was successfully completed.
15.23,.06 NUMBER OF RESTARTS 0;6 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>100)!(X<0)!(X?.E1"."1N.N) X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This value indicates the number of times that the merge process was restarted.
DESCRIPTION: This field is a simple count of the number of restarts which were required prior to completion of
the merge process.
15.23,.07 TASK NUMBER 0;7 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1)!'(X?1.N) X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This field contains the task number currently associated with the merge process (scheduled,
active, or completed).
DESCRIPTION: This field shows the task number currently associated with this merge process (scheduled, active,
or completed).
15.23,.08 TAG FOR MERGE ROUTINE 0;8 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<1)!'(X?1U.7UN) X
LAST EDITED: APR 19, 1996
HELP-PROMPT: This indicates the TAG to be used for entry into the merge routine.
DESCRIPTION: This field contains the TAG for entry into the merge routine for the package. This will
generally be in the form of TAG^ROUTINE(ARRAY)
15.23,.09 PACKAGE ROUTINE 0;9 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<3) X
LAST EDITED: APR 17, 1996
HELP-PROMPT: Answer must be 3-8 characters in length.
DESCRIPTION: This is the name of the routine as specified in the package file under the 'Affects Merge' entry
that specifies special processing for this package.
15.23,1.01 CURRENT TIME 1;1 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This value indicates the most recent date/time checkpoint of the active process.
DESCRIPTION: This value indicates the last date/time recorded as a checkpoint by the process. This value is
used to determine whether the process is still active or not.
15.23,1.02 STAGE - CURRENT 1;2 SET
'0' FOR FASTER;
'1' FOR LATTER;
LAST EDITED: APR 16, 1996
HELP-PROMPT: This field is used to indicate which processing stage it currently is in.
DESCRIPTION: This field is used to indicate which processing stage this merge process is currently in. The
merge process goes through three stages, but since the first is rapid and doesn't require any
effort to repeat (since the entries have already been merged) only two stages are recorded. The
FASTER (or EARLY) stage indicates the processing of pointers which either DINUMmed or
cross-referenced so that they can be identified rapidly. The LATTER stage indicates the
processing of pointers which can only be found by stepping through each entry within a file -
these are the pointers which require longer periods to sucessfully complete the re-pointing.
15.23,1.03 FILE - CURRENT 1;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1)!'(X?.N.".".N) X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This field indicates the current file being processed as indicated at the last checkpoint of the
active merge process.
DESCRIPTION: This value indicates the file currently being processed as recorded at the last checkpoint by the
active merge process.
15.23,1.04 ENTRY-CURRENT 1;4 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1)!'(X?.N.".".N) X
LAST EDITED: APR 16, 1996
HELP-PROMPT: This value indicates the most recent internal entry number as checkpointed within the FILE -
CURRENT file by the active merge process.
DESCRIPTION: This value indicates the last internal entry number recorded as a checkpoint (within the
checkpointed file) by the active merge process. This value (in conjunction with the other
checkpoint data) is intended for use in tracking the progress of the merge process and, if
necessary, to permit the merge process to be restarted in the vicinity where it was last
processing.
15.23,2 FILE FOR THREAD 2;0 Multiple #15.232 (Add New Entry without Asking)
15.232,.01 FILE FOR THREAD 0;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>10!($L(X)<1) X
LAST EDITED: SEP 20, 1996
HELP-PROMPT: This is the file number for one file to be processed by this thread.
DESCRIPTION: Entries in this sub-file are created during the merge processing when a new thread is created
to assist in processing the third phase. The values are removed upon completion of the
processing.
CROSS-REFERENCE: 15.232^B
1)= S ^VA(15.2,DA(2),3,DA(1),2,"B",$E(X,1,30),DA)=""
2)= K ^VA(15.2,DA(2),3,DA(1),2,"B",$E(X,1,30),DA)
FILES POINTED TO FIELDS
}UNDEFINED FILE (#15) MERGE ENTRY:DUPLICATE FILE ENTRY (#.03)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):