⟦45cf8acd2⟧

TextFile

*******************************************************

         R E L E A S E   D E S C R I P T I O N

*******************************************************




Module id number: CSS/166
--------------------------

Module name:      RCOPY
-----------------------------------

Actual release:   05.03            Release date: 860821
-----------------------            --------------------


Previous release: 05.02            Release date: 860228
-----------------------            --------------------


New facilities:
---------------


>> vs 05.01<<
1.  Syntax of mask has been changed to be similar to Directory Utilities
    (USM/112).  A '+' at the beginning of a mask specifies an OR-mask.

    PR85296
    -------
2.  Masking has been extended to directory names with the keyword DM.

3.  A new copy mode has been added which copies the input files as
    contiguous output files with optimal allocation size.  This option
    specified as 'C' can be used with three of the previously existing
    modes namely, addto, extend, and dir_create.
>> vs 04.01<<
1.  The syntax for <DATE> is changed so that it is only necessary
    to specify year,month and day.
    The parameters are integers.
    Default is that no time restrictions apply.

2.  Buflength is now always a multiple of 256 (sector).


>> vs 05.01<<
1.  The syntax for <MASK> is changed.


Errors corrected:
-----------------



>> vs 05.01 <<
1.  Garbage output by the system in case of non existing Print, Log, and
    Error files has been corrected (PR 85354).

>> vs 05.02<<
    The program terminated with line trace when the input directory
    is with more than 10 levels, because the work area was too small.
    (AADN-V1 967)

>> vs 05.03 <<
    When omitting the O parameter and having specified a nondirectory
    file as I parameter this inputfile was copied into current directory
    file. Now, if the O parameter is omitted the I parameter must be a
    directory file, otherwise an error message will be issued.
    (PR 86554)
    When using the C:D option different combinations of nonexisting
    volumename or file system name caused the program to enter an
    endless loop. Now the according completioncodes are returned.
    (PR 86588)


Changes:
--------


Reported errors, not corrected:
-------------------------------



CPECRs implemented in current release:
--------------------------------------

 86554 86588

Comments:
---------

                    USER'S GUIDE
                    ============

The RCOPY program is used to copy a substructure of the directory structure
into another substructure.
When used on a simple file (contiguous or random) it is compatible to
CSS/110 COPY.
When used on a directory it is compatible to CSS/111 DCOPY.

  SYNTAX:
                                                  default

 RCOPY  [Input    : <FILE_ID>]                current directory
        [Output   : <FILE_ID>]                current directory
        [Errors   : <FILE_ID>]                no file
        [Print    : <FILE_ID>]                current output
                                               (compacted somewhat)
        [Test     : <FILE_ID>]                no file
        [Levels   : <INTEGER> ]                1
        [Copymode : <MODE>    ]                Extend
                          10
        {Masks    : <MASK>}                    no mask
                          0
                          10
        {DMasks   : <MASK>}                    no mask
                          0
        [Buflength: <INTEGER> ]                2048
        [Setrigths: <YESNO>   ]                No
        [After    : <DATE>    ]                No restrictions
        [BEfore   : <DATE>    ]                No restrictions
        [Workvol  : <VOLNAME> ]                current volume
        [WFilesize: <INTEGER> ]                worst case
        [Fingerprint: <YESNO> ]                fingerprint option inclusion

  <MODE>     ::=  Replace |  [ C ] [  Append  |  Extend  |  Dir_create ]
  <MASK>     ::=  [+][-][% | #]<NAME>[#]
                                                    oo
  <NAME>     ::=  { <LETTER> | <DIGIT> | _ | . | ? }
                                                    1
  <YESNO>    ::=  Yes  |  No

  <DATE>     ::=  [-]<YEAR>.<MONTH>.<DAY> [<HOUR>[:<MIN>[:<SEC>]]]
  <YEAR>,
  <MONTH>,
  <DAY>,
  <HOUR>,
  <MIN>,
  <SEC>      ::=  <INTEGER>

CAPITALS in keywords are mandatory; lowercase letters are optional.

The Errors file is extracted from the Print file, which is extracted
from the Test file. (The Test file is intended for program maintenance
only)
The Print file is the normal log file, specifying the files copied
successfully and the exceptional conditions encountered.
The Errors file contains the exceptional conditions encountered and
may be used for quick inspection.

Levels specifies the maximum level of recursion.
Thus RCOPY with
  Levels = 1 yields the same as DCOPY.
  Levels = 2 yields the same as DCOPY on the Input file and on all direc-
              tories of the input file, except that multilinked files are
              treated properly even when residing in different directories.
              And so on, up to a maximum Level = 10.

Copymode restricts the files to be copied:
  Append    : only files NOT existing in the output tree are copied.
  Replace   : only files     existing in the output tree are copied.
  Extend    : files are copied irrespectively of existance.
  Dir_create: nonexisting outputdirectories are created and files are
              copied as in extend-mode.
  Contiguous: output files are created as contiguous files with optimal
              allocation size.
              If only C is specified, Append becomes default.
              CD works the same way as CE.


The mask works as follows:
  M:ABC            matches all names containing the string 'ABC'
  M:#ABC           matches all names beginning with 'ABC'
  M:%ABC           matches all names beginning with 'ABC'
  M:#ABC#          matches the name 'ABC' only
  M:%ABC#          matches the name 'ABC' only
  M:+%ABC M:+DEF   matches all names beginning with 'ABC' or
                   containing the string 'DEF'.
  M:ABC M:DEF      matches all names containing 'ABC' and 'DEF'
  M:-ABC           matches all names not containing 'ABC'

Directory Mask works similar to Mask, but applies to directory names.
It applies to all directory names that are contained in the input
directory.  When directory mask is specified, the level specified in
the command should be greater than 1.

Setrights specifies, if the created output files should be protected
as the input files. If not, they get the access rights as when
created by the caller. Setrights = Yes is ment for backup use and
volume restructuring.

Buflength specifies the word length of the 4 copy buffers, and will
always be a multiplum of 256 (sector).

After specifies that the file must have been changed on that date
or later to be copied. A minus in front of the time specification
makes After relative to the current date and time.
BEfore specifies that the file must have been changed on that date
or earlier to be copied. A minus in front of the time specification
makes BEfore relative to the current date and time.
After and BEfore go together to form an interval in which the file
must have been changed to be copied. The facility is intended for
backup use.
Discrimination via dates is only applied to non_directory files i.e.
directories are always copied.
NOTICE!! After and BEfore can only be used if the file system opdate
the access date and time, because a directory's access date must
be in the interval to be used for descent.

Fingerprint option inclusion will cause the program to collect a
total fingerprint of the outputfiles.  Refer to the Fingerprint-
program.  Please note, that only in the default modes and masks
and by copying to the bottom of a tree-structure is
this fingerprint identical to the one collected by the Fingerprint
program.

Workfile size is the area_size of the random file used as workfile.
It should be in the range 1 to 255.

  EXAMPLES:

    RCOPY I:@**USERS.D*PHF.D*RCOPY.D*AMOS.C O:@**RCOPY

  will copy this program out into the main directory.

    RCOPY I:@*DISK1 O:@*DISK2*MD E:BACKUP_ERRORS P:BACKUP.P L:10 S:Y

  will copy the volume DISK1 to DISK2, thus making a restructured volume
  with faster access.

    RCOPY O:@*DISK2*SAFE.D A:1982.9.10 11:11:0

  will copy files in current directory to specified directory provided
  that they have been changed since the given date.

    RCOPY I:@**USERS.D*NA.D*TEST_RCOPY.D O:A*B*C L:5 C:CD

  will create the nonexisting directories A*B*C in the current directory
  and copy five levels from TEST_RCOPY.D into A*B*C.  The output files are
  created as contiguous files with optimal allocation size.

    RCOPY I:@**USRES.D*BAS.D*RCOPY.D O:OUT.D DM:+#RCO DM:.J# L:4

  will copy five levels of RCOPY.D onto OUT.D under the current directory,
  subject to the condition that the directory names start with 'RCO' or
  end with '.J' .
 «a5»
DataMuseum.dk

CR80 Hard and Floppy Disks

⟦45cf8acd2⟧ TextFile

Derivation

TextFile
