| account-restore | Index Level | acct1 |
| Syntax |
account-save {account.name} {account.name...} {(options)}
file-save tape label = {tape.label} account name = account.name |
| Category | TCL |
| Type | Verb |
| Description |
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 D3, 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 "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 FlashBASIC 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. |
| Options | |
| See Also | save account-restore sel-restore file-save admin.files check-dx create-file file-save (R83) incremental save dummy save check-account files tape label file-defining item file control block deleting items tlog-restore check-files group format error incremental restore reallocation set-sct restore |
| Example |
account-save
file-save tape label = Thursday account name = dm 1 35 > dm 1 36 > dm > newac 1 37 > dm > newac > newac ... The process displays the files being saved in the following form: Reel#, File#, > , account.name, > , dict.name, > , data.name In all multi-reel operations, if the save detects end of media before completing the save, it prompts with the message: Load volume #n and type 'C' label 08:00:00 16 Jan 1997 DATA ... #_ When the next "reel" is inserted or mounted, "c" continues the process, or "q" will stop it and return control to TCL. The system does not check to determine if a different volume was inserted or mounted. |
| Warnings |
(R83) As of release 2.2, Pick no longer writes a file mark at the beginning of the tape.
(R83) 3.1 : The account name may be provided with the command. |
| Compatibility | D3 7.0 AP R83 |
| account-restore | Index Level | acct1 |