FS - File Save

Files the edited item and retains control in the Editor. The line pointer is set to zero.

Caution

When using this command, you need to be aware of the effects of any file triggers that might be run as a consequence. See File Triggers for more information.

Syntax

FS{K}{O} {(file-specifier} {item-id}{)}

Syntax Elements

K indicates that you wish to terminate the item list.

O indicates that you wish to overwrite an existing item with the same item-id. You only need to specify O if writing to another item or file (if writing to the current item and file, overwrite of any existing item is automatic).

(file-specifier specifies write the item to another file (not the one used with the EDIT command). The item of the same name in the original file is not changed.

Note

A file specifier must be identified by an open parenthesis preceding it.

item-id is a new name for this item, within the current file if file-specifier is omitted, otherwise within the file specified. Omit if you want to use the existing item-id for the item within the current or alternative file.

Overwriting an Existing Item in a Different File

If you attempt to file an item to a different file which already contains an item with the same item-id, and you do not specify O, the Editor displays the message EXISTS, resets the line pointer to the top of the item, and retains control for the Editor processor.

Filing an Item Under a New ID

You can file an item under a new item-id within the current file if you issue FS or FSO without specifying a file.

How to Exit From an Item List

To terminate a multiple item EDITing session after you file an item but before you edit the last item in the list, use the FSK command.

Example - FS

:ED COMPANY XYZ1
Top
.P
001 The ABC Computer Company
002 XYZ
003 123 Main Street
EOI 003
.2
002 XYZ
.R/Z/Z Corporation <Return>
002 XYZ Corporation
.FS
Top
.P
001 The ABC Computer Company
002 XYZ Corporation
003 123 Main Street
EOI 003.

Edit item XYZ1 in the COMPANY file.










File the changes and remain in the Editor.

Example - FSO

:ED COMPANY XYZ1
Top
.P
001 The ABC Computer Company
002 XYZ
003 123 Main Street
EOI 003
.2
002 XYZ
.R/Z/Z Corporation
002 XYZ Corporation
.FSO (CUSTOMER2 XYZ1)
Top
.P
001 The ABC Computer Company
002 XYZ Corporation
003 123 Main Street
EOI 003
.FI
'XYZ1' filed in file 'COMPANY'.

Edit item XYZ1 in the COMPANY file.










File the item into the CUSTOMER2 file, then remain in the Editor.