EXIT Command

Description:

This command causes execution of the current script to terminate immediately. No further input will be provided from the script file and no commands executed.

An optional status value can be returned when the script in question has been called from another script. This is achieved by using the status variable to place a value into the return status variable specified on the call to this script. If no status is specified, but the caller is expecting one, then the status returned will be that returned by the last script which exited with a status. This allows a status to be retrieved from a deeply nested script where no explicit status returning has been employed.

At run-time, a script is automatically terminated when the end of the script is reached. It is not necessary to include an EXIT command as the last command in a script, to terminate script execution.

If the script has been called, using the CALL SCRIPT command, execution of the calling script will resume at the command immediately following the CALL SCRIPT command.

When an EXIT command is processed and there are no other threads executing the script, the script data is discarded. However, if the ",KEEPALIVE" option is specified on the EXIT command, then the script data that will not be deleted even if there are no other threads executing it. This allows subsequent threads to execute the script and access any script data set up by a previous thread.

Format:

 EXIT {status} {,KEEPALIVE}

Parameter:

status

An integer variable or integer value to be returned as the status from this script to the caller. The status will be returned into the integer variable specified on the CALL command.

Examples:

 EXIT
 EXIT RETURN-STATUS

See also:

Flow Control Commands