Restart

In Windows-based systems, the Restart built-in extract file method restarts the offset (positions the offset at the beginning) of the external file attached to the extract file.

If the external file is not already open, this method is ignored.

In MCP-based systems, the behaviour of this method is the same as the Restart LDL command – it will purge the file leaving the file empty.

Notes:

The Restart() will be deprecated in the future and you need to use the Restart LDL logic command or the Position() method, depending upon which behavior you want. When the Restart() is deprecated, you might need to modify your models as follows:

  • Windows-based systems

    Change all occurrences of <extract>.Restart() to <extract>.Position(0)

  • MCP-based systems

    Change all occurrences of <extract>.Restart() to Restart <extract>

Failure behavior

If the offset of the external file is not successfully restarted, the Restart method sets the Glb.Status built-in segment attribute to "*****".

Syntax

<<extract file>>::Restart(void) : void

Owner

Any extract file.