tcl.account-save Verb: Access/TCL, tape.label Definition/Tape Commands

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