AF - access file.
Usage:
acce af filename["altname"][,permission]
Options:
- "altname"
- specifies the name of the file as it is to appear in the
Available File Table (AFT). "altname" must be
eight characters or less. If not given, the file name is
used. For example, if you say "acce af
/s/dd.b", the file name is "dd.b". If the
file name is longer than eight characters, you must use
an "altname".
- permission
- specifies the permissions to request when accessing the
file. If not present, WRITE is requested. The possible
permissions are described below.
Examples:
acce af fort.tst
acce af fort.tst,r,c
acce af fort.tst"x"
acce af /s/fort.tst,r
acce af /s/linelength.b"x",r
Description:
You use the AF function of ACCESS to bring a file into the
AFT. You may optionally specify an alternate name and/or access
permissions.
The AF function is handy if you are using a command that
cannot access files by itself, or if you want to use an access
permission which is not supported by the command you want to use.
Access permissions:
An access permission is expressed as a one to three character
abbreviation of a keyword. The possible permissions are given
below. Normally, you will want to use one of "e",
"r", "q", or "w".
- e
- EXECUTE. Requires EXECUTE permission.
- r
- READ. Requires READ permission.
- q
- QUERY. Requires READ permission. This differs from
"r" in that a query access will succeed even if
the file is busy or abort locked.
- w
- WRITE. Requires WRITE permission.
- rec
- RECOVERY. Requires RECOVERY and WRITE permissions. The
file must have no other writers. "rec" lets you
access an abort locked file for the purpose of repairing
it.
- c
- CONCURRENT. When used with "r" or
"w", allows readers and writers to access the
file at the same time, provided that all of them request
concurrent access. This will be ignored unless the file
has ACCESS/CONCURRENT/ or ACCESS/RWW/.
- p
- PRIVATE. This requests private write access. It is used
instead of "w" to override the implicit
"c" (concurrent) request assumed for
ACCESS/RWW/ files.
- load
- LOAD. This is a private write request which bypasses the
system monitoring of files with ABORT/ROLLBACK/,
ABORT/ARCHIVE/, and ACCESS/MONITOR/ attributes. It is
intended for initially putting data into a database, when
there is no need for the system monitoring. This is the
only way to access such a file for write in TSS.
Copyright © 1996, Thinkage Ltd.