Kernel Toolkit 7.3 APIs Banner
Office of Information and Technology (OIT) Banner
[skip navigation]

RESTART^XDRMERG(): Restart Merge

Reference Type: Supported, Category: Toolkit—Duplicate Record Merge, ICR#: 2365

Description

The RESTART^XDRMERG API restarts a merge that has been stopped. The information necessary for restarting can be viewed using the CHKLOCAL^XDRMERG2 API (see LOCAL MERGE STATUS).

Format

  RESTART^XDRMERG(file,arraynam,phase,currfile,currien)

Input Parameters

file:

(required) Specifies the file number of the file in which the indicated entries are to be merged.

arraynam:

(required) This parameter contains the name of the array as a closed root under which the subscripts indicating the FROM and TO entries are found. The data can have either two or four subscripts descendent from the array, which is passed.

REF: For examples of its usage, see the “Overview” section in the "Toolkit—Duplicate Record Merge" section in the Kernel 8.0 & Kernel Toolkit 7.3 Developer's Guide.

phase:

(required) This parameter indicates the phase of the merge process in which the merge should be restarted. The value is a number in the range of 1 to 3, with no decimal places:

  • Phase 1 is usually quite short and is the merge of the specified entries in the primary file.

  • Phase 2 is the merging of entries in files that are DINUMed to the primary file and changing pointers that can be identified from cross-references.

  • Phase 3 is finding pointer values by searching each entry in a file. This is usually the longest phase of the merge process.

 

currfile:

(required) This is the current file number on which the merge process is operating.

currien:

(required) This is the current internal entry number in the file on which the merge process is operating.

Output

none.