tcl.account-save

saves individual account(s) to the currently attached peripheral storage device.

'account.name' indicates the name of the account to save. If more than one account is specified, each must be separated by a space. If not specified, the system prompts for the account name. On AP, the accounts to save can be specified in a select list.

'tape.label' is an optional 48-character character string which is written into the tape label area at the beginning of each 'reel' of the save.

Unless the 'u' option is specified, the system does a complete account-save. However, 'account-save' does not save a file with 'dx' in attribute 1 of its file-defining item. Although 'account-save' does save a file with 'dy' in attribute 1 of its file-defining item, none of the items in the file are saved.

In order for the 'incremental' account save to work, the system marks any item that is changed. This mark is normally cleared by a complete file-save; however, when using 'account-save', the marks indicating changed items are not cleared.

If a file has a 'dx' or 'dy' code and an item in it is updated, that item is not marked as changed when it is filed; therefore, even if the 'x' or 'y' is removed before the 'account-save' is run, that item is not saved by an 'incremental' account save.

The 'account-save' processor locks groups as it saves them. While the group is locked, no process may access any item in that group. Locking groups prevents spurious Group Format Error messages that would occur if another process changed an item while it was being saved. Up to four groups may be locked at one time. These groups are the ones containing: the mds dictionary pointer, the md pointer, the file dictionary pointer, and the group for the data currently being saved.

If the 'save' is being done to Streaming Cartridge Tape (SCT), an explicit end-of-data sequence must be written since SCT cannot back up. Use either 't-weof' from TCL or the FlashBASIC or Pick/BASIC 'weof' statement to write the second eod needed to indicate the end-of-file. Otherwise, 'account-restore' or 'sel-restore' fails to see the end of the tape.

'account-save' is a Pick/BASIC program which issues the 'save' command with the 'f', 't', 'v' and 'i' options. Any options available to the 'save' command may be added to the command line.