10.0; edmtdesc (edit_magtape_descriptor), revision 1.0, 88/01/21
edmtdesc (edit_magtape_descriptor) - edit magtape descriptor file.
usage: edmtdesc pathname {-c | -l [var...] | -s {var value...}... } {cl}
DESCRIPTION
edmtdesc allows you to create, list, and modify the magnetic tape
descriptor object. The descriptor file provides information to the
streams manager so that it can handle subsequent tape operations.
pathname (required)
Specify name of magtape descriptor file to be created,
listed, or edited.
OPTIONS
At least one of the following options must be specified.
-c Create a new magtape descriptor object with the name given
in the pathname argument.
-l [var...] List the values of the variable(s) specified. If no
variables are named, the entire magtape descriptor is
listed.
-s {var value}...
Set the variable(s) indicated to the specified value(s).
At least one variable/value pair is required if -s is
specified. Multiple variable/value pairs are permitted,
separated by blanks.
Variables
The variables known to edmtdesc are listed below, along with their types
and default values. The variable types are: integer (int), Boolean
(y/n), character string of n letters (c [n]), and date (in format
yy/mm/dd.hh:mm).
Name Type Default Definition
________________________________________________________
Device type ('m' for magtape,
d
uev c
i[
n1
t] 0
m Magtape unit number (normally
0)
lab y/n yes 'Yes' if magtape is ANSI
labeled, 'no' if unlabeled
reo y/n no 'Yes' to reopen previously
used volume, 'no' to open new
volume ( 'yes' suppresses
rewind)
clv y/n yes 'Yes' closes volume when file
is closed, 'no' leaves volume
open
Name____Type____Default___Definition____________________
spos y/n no 'Yes' saves volume position
when volume is closed (for
reopen), 'no' rewinds volume
when closed
vid c[6] -auto Volume identifier (labeled
volumes)
vacc c[1] Volume accessibility (labeled
volumes)
own c[14] -auto Volume owner (labeled volumes)
f int* 1 file sequence number: integer
or "cur" for current file, or
"end" for new file at end of
labeled volume
rf c[1] D record format -- "F" for fixed
length, "d" for variable
length, "s" for spanned, "u"
for undefined
bl int 2048 block length, in bytes
rl int 2048 (maximum) record length, in
bytes
ascnl y/n yes 'Yes' for ASCII newline
handling (strip newlines on
write, supply them on read),
'no' for no newline handling
fsect int 1 File section number (labeled
volumes)
fid c[17] File identifier (labeled
volumes)
fsid c[6] File set identifier (labeled
volumes)
gen int 1 Generation of file (labeled
volumes)
genv int 1 Generation version of file
(labeled volumes)
cdate date -auto Creation date of file (labeled
volumes)
edate date -auto Expiration date of file
(labeled volumes)
facc c[1] File accessibility (labeled
volumes)
sysc c[xx] System code (labeled volumes)
sysu c[xx] System use (labeled volumes)
boff int 0 Buffer offset (labeled
volumes, should be 0)
For cartridge tape (dev c), you must change the block length (bl) and the
record length (rl) to be 512 or less and the record format to be fixed
("rf F").
EXAMPLES
Edit file set_tape; set the tape unit number to 1; declare tape as ANSI
labeled.
$ edmtdesc set_tape -s u 1 lab yes
Create descriptor file ct for cartridge tape, blocking 4 records of
maximum length 128 to each block.
$ edmtdesc ct -c -s dev c bl 512 rl 128 rf F
SEE ALSO
More information is available. Type
help magtape For general information on magnetic tape usage
help cartridge
For general information on cartridge tape usage and
support