Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

FS - File Save (Editor) (m618503+fs.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

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 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-specifierspecifies 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 specification 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.