|
DataMuseum.dkPresents historical artifacts from the history of: CR80 Hard and Floppy Disks |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about CR80 Hard and Floppy Disks Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - download
Length: 8056 (0x1f78)
Types: TextFile
Names: »RELDESCR.T«
└─⟦e0c43619c⟧ Bits:30005797 CR80 Disc pack ( Vol:FNJ1 861029/EC CR80 S/W Package II+III+IV+V+VII )
└─ ⟦this⟧ »CSP002_V0701.D!CSS934.D!RELDESCR.T«
«ff»
*******************************************************
R E L E A S E D E S C R I P T I O N
*******************************************************
Module id number: CSS/934
--------------------------
Module name: DIREC3
------------------------
Actual release: 05.01 Release date: 860826
----------------------- --------------------
Previous release: 04.01 Release date: 860617
----------------------- --------------------
New facilities:
---------------
>> V0501 <<
- The mode described in >>V0401<< is included for copy too.
The output file is NOT reset, if it's too small and the 'L' option
not is specified.(PR86560)
>> V0401 <<
- A new mode: REMOVE_MODE is included for DCOPY. It is
entered by specifying an option 'L' in the mode parameter e.g.
C:CLE.
If the option 'L' is specified then, if the output file exist and it
is too small then the output file is removed and a new larger one is
created. The new file gets the same organization, but the size is as
the input files. (PR86211)
>> V0201 <<
- A new function, APPEND, added. Works as COPY, but the output file
is not reset.
- The buffer size may now be specified by giving B:<words> to
DCOPY, COPY or APPEND.
The buffer size will be adjusted to first higher 512 words.
If the buffer size is respecified (in DIREC mode) to another size
(outside the 512 words), a message is output stating that the
specification is ignored.
>> V0101 <<
- The program accepts as input (current input or file given as
C:<file-id>) commands for copying files and the set of
DIREC and DCOPY commands.
The files in a directory having a specfic BFD number can be listed
(possibly masked as DLIST, DLISTA).
Also, facilities for getting the BFD number of a file in
hexadecimal and decimal notation and for setting the size
of a file are offered.
When copying, the output file may be created with the same
attributes as the input file or with minimal contiguous
allocation if it does not exist.
Some of the functions may use masks on file-names.
Commands and syntax:
CREATE <file-id> <org> / <long integer>
ENTER <file-id> <file-id>
RESET <file-id>
RENAME <file-id> [ / ] <file-name>
REMOVE <file-id>
LIST { <file-id> | M:<mask> }
ATTR <file-id>
PROTECT <file-id> <user> <access-rights>
BFDN <file-id>
SETSIZE <file-id> <long integer> (AMOS only)
CHSECP <file-id> <integer> (DAMOS only)
COPY [ I:<file-id> ] [ O:<file-id> ] [ C:<mode> ]
DCOPY [ I:<file-id> ] [ O:<file-id> ] [ PR:<yes/no] ] [ C:<mode> ]
DENTER [ I:<file-id> ] [ O:<file-id> ] [ PR:<yes/no] ]
DRESET [ D:<file-id> ] [ PR:<yes/no] ]
DREMOVE [ D:<file-id> ] [ PR:<yes/no] ]
DLISTA [ D:<file-id> ]
DLIST [ D:<file-id> ]
DPROTECT [ D:<file-id> ] [ PR:<yes/no> ]
U:<user> R:<access-rights>
BLISTA [ D:<file-id> ] B:<long integer>
BLIST [ D:<file-id> ] B:<long integer>
All DCOPY functions (DCOPY, DLIST, DLISTA, DENTER, DREMOVE, DRESET
DPROTECT, BLIST and BLISTA) may be qualified with one or more masks.
Parameter syntaxes:
{ } means, that the parameter may be repeated several times.
[ ] means, that the parameter is an option.
<org> ::= C | R | D
C for Contiguous
R for Random
D for Directory
<mode> ::= [ C ] [ L ] [ A | R | E ]
C for Contiguous Create (if Create)
L for Remove_mode. If the output file exists and it
is too small, it will be removed
and a new larger one is created.
A for Append-only (do not copy to old files)
R for Replace-only (do not create new files)
This is default for COPY
E for Extend (auto-create if non-existing)
This is default for DCOPY
<yes/no> ::= YES | NO
YES means, that the user is asked for each file
<user> ::= <integer>
<access-rights> ::= <integer> | <symbolic-accesses>
<symbolic-accesses> ::= [+|-]<symbolic-access> |
<symbolic-accesses> / [+|-]<symbolic-access>
<symbolic-access> ::= READ | MODIFY | APPEND | ENTER |
LOOKUP | RENAME | REMOVE | RESET |
GETINF | PROTECT | OFFER
<mask> ::= <or-mask> <minus-mask> [<align> | <start name>]
<mask-letters> <align>
<or-mask>::= + (the mask value is OR'ed to the other masks)
<minus-mask> ::= - (the mask value is negated)
<align> ::= # (the mask must be aligned with the front
or the back of the file-name)
<start name> ::= % (the mask must be aligned with the front
of the file-name)
<mask-letters> ::= <mask-letter> | <mask-letters> <mask-letter>
<mask-letter> ::= A..Z | a..z | 0..9 | . | _ | ?
Example:
Invocation: DIREC C:CMDS.T
The file CMDS.T contains the following commands:
CREATE NEWDIREC.A.C R/2
COPY I:@**DIREC O:NEWDIREC.A.C
CREATE NEWCMDS.T R/1
COPY I:CMDS.T O:NEWCMDS.T C:C
COPY I:DIREC.A.P O:SAVE_DIREC.P
ENTER SAVE_DIREC.A.P SD
REMOVE SD
RENAME SAVE_DIREC.A.P/SDIR
RESET SDIR
CREATE SAVED.D D/1
DCOPY O:SAVED.D
LIST M:.C M:#A SAVED.D M:+-.T
"List all files in SAVED.D that contain .C and starts with A
"and all the files that don't contain .T .
CREATE SAME.D D/1
DENTER I:SAVED.D O:SAME.D
DREMOVE D:SAME.D PR:NO
REMOVE SAME.D
The program is terminated by an end-of-file or the command
'QUIT' or 'Q' in the input file.
All command words are recognized by as few letters as possible
(at least 3).
E.g. CRE for CREATE, DLI for DLIST, DLISTA in full, DREM for
DREMOVE etc.
The C: specification in the invocation may be replaced by
an I: specification.
In the DCOPY functions, the D: and I: specifications are
synonyms.
Changes:
--------
>> V0501 <<
- CONV_TIME.I is now fetched from @**PREFIXES.D*MXAMOS.D*CONV_TIME.D*
V0201.D*SWELL.D*CONV_TIME.I
>> V0301 <<
- Relative access rights are implemented e.g
PROTECT USERS.D PUB +ENTER
>> V0201 <<
- The functions ATTR and BFDN no longer opens the file, so the
access-date for the file will not be changed for the file when
using these functions.
The function REMOVE will now only open the file if it is a
directory.
- The function LIST will flag files met before with an '*'
between the BFD # and the creation date (if internal
tables do not overflow).
- Masks may now have '%' as qualifing "start of name".
'#' is still possible.
Errors corrected:
-----------------
>> V0501 <<
- The program now gives an error message when copy is done to a
too small file.(PR86559)
Reported errors, not corrected:
-------------------------------
CPECRs implemented in current release:PR86559 PR86560
--------------------------------------
Comments:
---------
>> V0101 <<
The program may be entered with the names of its different
subfunctions (e.g. COPY, CREATE etc) and will function as
a single-shot program.
«a5»