tcl.account-save
| Command | tcl.account-save Verb: Access/TCL Applicable release versions: AP, R83 |
|---|---|
| Category | TCL (746) |
| 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 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. |
| Syntax | account-save {account.name} {account.name...} {(options)} file-save tape label = {tape.label} account name = account.name |
| Options | |
| 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. |
| Purpose | |
| Related |
tcl.save tcl.account-restore tcl.sel-restore tcl.file-save tcl.admin.files tcl.check-dx tcl.create-file tcl.file-save_rp incremental.save dummy.save tcl.check-account files tape.label file.defining.items file.control.block deleting.items tcl.tlog-restore tcl.check-files group.format.error incremental.restore reallocation tcl.set-sct restore |
tape.label
| Command | tape.label Definition/Tape Commands Applicable release versions: AP, R83 |
|---|---|
| Category | Tape Commands (36) |
| Description | defines a Pick "tape" label. Traditionally, Pick "tapes" have an identifying "label" written on the first 80 bytes of the tape. Tape Element Element Position Length Description -------- ------- ---------------------------------- 01 01 Label Identifier. Always an "L". 02 (space) 03 - 06 04 Record Length (in hexadecimal) "01F4" = 500-byte record "03E8" = 1000-byte record "4000" = 16384-byte record 07 (space) 08 - 15 08 System Time at time of tape-writing. "00:00:00" format 16 - 17 02 (spaces) 18 - 28 11 System Date at time of tape-writing. "MMM DD YYYY" format 29 01 (space) 30 - 77 48 Label Header Text. 78 01 (space) 79 - 80 02 Tape volume (reel) number. -------- ------- ---------------------------------- If the tape is created by a "t-dump", the label contains the source filename and text specified in "t-dump"s "heading" option (if any). If the tape is created by a "file-save", "account-save", or "save", then it contains the word "DATA", and optionally, the information entered at the "file-save tape label:" prompt. If the tape is created as Spooler output, the label contains the word "SPOOLER", and optionally, the account name and user-id of the creator. |
| Syntax | |
| Options | |
| Example | |
| Purpose | |
| Related |
access.t-dump tcl.file-save tcl.save tcl.sp-assign tcl.t-read tcl.t-rdlbl tcl.t-wtlbl basic.readtl access.sreformat access.t-load tcl.account-save |
