AUTOSAVE—Set or Query Autosave Mode

The AUTOSAVE macro command sets autosave mode, which controls whether changed data is saved when you issue the END command.

The AUTOSAVE assignment statement either sets autosave mode, or retrieves the current setting of autosave mode and places it in variables.

Syntax


Macro command syntax

                      .-ON----------------.   
>>-ISREDIT--AUTOSAVE--+-------------------+--------------------><
                      +-PROMPT------------+   
                      |      .-PROMPT---. |   
                      '-OFF--+----------+-'   
                             '-NOPROMPT-'

ON: Turns autosave mode on. When you enter END, any changed data is saved.
OFF PROMPT: Turns autosave mode off with the PROMPT operand. You are notified that changes have been made and to use either SAVE (followed by END) or CANCEL. If you specify only the PROMPT keyword, OFF is implied.
OFF NOPROMPT: Turns autosave mode off with the NOPROMPT operand. You are not notified and the data is not saved when you issue an END command. END becomes an equivalent to CANCEL. Use the NOPROMPT operand with caution.


Assignment statement syntax

>>-ISREDIT--(var1,var2)-- = --AUTOLIST-------------------------><


                           .-ON----------------.   
>>-ISREDIT--AUTOSAVE-- = --+-------------------+---------------><
                           +-PROMPT------------+   
                           |      .-PROMPT---. |   
                           '-OFF--+----------+-'   
                                  '-NOPROMPT-'

var1: The name of a variable to contain the setting of autosave mode, either ON or OFF.
var2: The name of a variable to contain the prompt value, PROMPT or NOPROMPT.
ON: Same as macro command syntax.
OFF PROMPT: Same as macro command syntax.
OFF NOPROMPT: Same as macro command syntax.

Description

Data is considered changed if you have operated on it in any way that could cause a change. Shifting a blank line or changing a name to the same name does not actually alter the data, but the editor considers this data changed. When you enter SAVE, the editor resets the change status.

Autosave mode, along with the PROMPT operand, is saved in the edit profile.

See the DATA_CHANGED, CANCEL, and END macro commands, and the CANCEL and END primary commands for more information on saving data.

Return codes

0: Normal completion
4: OFF NOPROMPT specified
20: Severe error

Examples

To turn autosave mode on:

ISREDIT AUTOSAVE ON

ISREDIT AUTOSAVE = ON

To turn autosave mode off and have the editor prompt you to use the SAVE or CANCEL command:

ISREDIT AUTOSAVE OFF

ISREDIT AUTOSAVE = OFF

To turn autosave mode off and not have the editor prompt you to use SAVE or CANCEL:

ISREDIT AUTOSAVE OFF NOPROMPT

ISREDIT AUTOSAVE = OFF NOPROMPT