Parameters and Commands › PROCESS Statement › RESTART Parameter

RESTART Parameter

RESTART is an optional parameter that allows you to return to a reorganization and resume processing at the step you specify. Restart is required if you have used the STOPAFTER parameter to halt processing.

With the RESTART parameter you can:

• Recover from a system failure--In the event of a system failure, you can restart CA IDMS/DB Reorg at the reorganization step that was executing when the failure occurred by specifying RESTART=NEXT (or a particular step name) instead of having to rerun the entire utility. CA IDMS/DB Reorg continues processing reorganization steps in their logical sequence (see Concepts for information about the reorganization steps).
• Re-create files--When intermediate files are accidentally damaged, scratched, or lost during a system failure, you can re-create those files by reexecuting steps that created the files originally.

Because each reorganization step must be executed in its logical sequence, you can restart CA IDMS/DB Reorg in one of these ways:

• Enter the keyword NEXT
• Supply the name of the next logical step in the reorganization sequence (such as MATCH)
• Supply the name of a step (in the reorganization sequence) that has already executed successfully

RESTART Syntax and Options

[,RESTART= {NEXT
            OPTALLOC
            PRIALLOC
            SECALLOC
            MATCH
            IIXSDBK
            UPDLINK
            STORE}]

[,RESTART={step-name}]

This option indicates that a RESTART option follows. You select the reorganization step at which CA IDMS/DB Reorg resumes execution (steps are detailed in Concepts).

Default: None. If you enter the RESTART parameter you must choose one of the options.

Note: If the UPDLINK step has begun or completed execution, the databasehas been modified and you cannot restart at or before the OPTALLOC step until you restore the areas that were updated.

NEXT

Resumes execution at the next logical reorganization step in the sequence. CA IDMS/DB Reorg automatically determines which reorganization step is next and resumes execution. Reorganization continues until all reorganization steps have executed successfully or until the step specified in the STOPAFTER parameter has completed.

OPTALLOC

Resumes with the Optimum Allocation Pointer Extract (OPTALLOC) step.

PRIALLOC

Resumes with the Primary Allocation (PRIALLOC) step.

SECALLOC

Resumes with the Secondary Allocation (SECALLOC) step.

MATCH

Resumes with the Match (MATCH) step.

IIXSDBK

Resumes with the IIX sorted db-key (IIXSDBK) step.

UPDLINK

Resumes with the Update Set Linkage (UPDLINK) step.

STORE

Resumes with the Store (STORE) step.

Rules

• The RESTART parameter can only be used after the first reorganization step (the Analysis step) has executed successfully.
• To successfully restart CA IDMS/DB Reorg, all steps preceding the step at which you are restarting must have executed successfully.
• The RESTART parameter must be used to resume processing after the STOPAFTER parameter was used to halt processing