ͻ
                Documentation to the program.                      
                                                                   
 Professional Auto-Copy ( Scatter ) of files  1.11 versions 2001y.  
 In case of detection of mistakes write to the author E-Mail:      
                                                CopyProf@narod.ru  
ͼ

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 1. For what the program is intended?

      Program is intended for automation of routine operations on
    To copying / carry of files. ( Auto-Copy ( Scatter ) of files )

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 2. When there is a sense to use the given program?

      If takes place even 1 of the following items:

   a) When the files act during long time and should be
      Are sent in shortest time (that at manual dispatch results to
      To the large expenses of human time and mistakes).
   b) It is necessary to record actions.
   c) Spelling of bat-files very much difficult because of complexity necessary
      Operations.
   d) The user does not accept absence of processing of mistakes in bat-files
      (For round-the-clock systems, sometimes it is required to continue work
       Despite of mistakes... Or it is necessary to check existence of a disk,
       Spaces on it...).
   e) For automatic creation of archives
      (For example: D:\ARHIV\INPUT\<MONTH>_<YEAR>\<DAY>\<MIN>_<SEC>\).
   f) When it is necessary to keep continuity at transition to another 
      Operational system, or you adjust (work) in Windows,
      And want to use the program in others OS (OS/2, DOS) - 
      It is enough to start other executed module.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 3 How works and what the program can?
  
    3.1  The program for each record on a mask in CopyProf.Cpr searches
         Files in the current input catalogues.
              If the file(s) is found on a mask, before last ouput
         The catalogue copying a file(s), and in last is carried out
         Carry. 
              Thus in the output catalogues are possible various
         acro-variable (date, time, number of a file...), that makes
         the program it is enough flexible.   

    3.2 "Ideology of job of the program"

              In the program at processing a file the technology is used
         "All or anything" - or the file is copied and to be transferred, or
         There is all as was (while the restriction will not be will be executed).
         Therefore before the beginning of copying - carry the program tries
         To check up all restrictions (size of a file, target catalogue...)

    3.3 "The Brief description"

              Automation of routine operations on copying - carry
         Files. To conducting archives (entering) files as current year,
         Month, day, hour, minute... (with adjustment of a kind by the user), 
         Number of a processable file... An opportunity of processing
         The accompanying documents to files.
              In the registered version there is an opportunity of conducting
         broad gullies, Conclusion of the list (input) files, which can not be
         processed at current configuration of the program (does not get under
         one of Masks of files...)
              The console application (version under Win32, DOS and OS/2),
         Text files of a configuration.  

    3.4 "Examples"
          
              With the help of the given program it is possible, to move each
         file from the inpit catalogues in the separate catalogue.
         (Numbered from 1)
              If, for example 1000 files lay in the catalogue 
         D:\Input, and target catalogue D:\Output,
         That is necessary to make such adjustments:

--//   Begin File CopyProf.Cpr:   
D:\Input
Mask: *.*
D:\Output\<NUMBER_FILE>\
Command: Do-All
--//   End   File CopyProf.Cpr 

    The program will transfer 1 file to the catalogue D:\Output\1\
               2 files will transfer to the catalogue D:\Output\2\ 
               And so on...
   To put files also in archive, it is necessary to add a line
In a File CopyProf.CPr:

D:\Input
Mask: *.*
D:\Output\<NUMBER_FILE>\
D:\ARHIV\<MONTH>_<YEAR>\<DAY>\
Command: Do-All
- // a file CopyProf.Cpr Here comes to an end

    Now Program will copy 1 file in the catalogue D:\Output\1\
        Also will transfer to the catalogue D:\ARHIV\12_00\01\
                                (At date of December 01, 2000)
               2 files will copy in the catalogue D:\Output\2\
        Also will transfer to the catalogue D:\ARHIV\12_00\01\
                                (At date of December 01, 2000)
                       And so on... 

For increase of flexibility of the program there is an opportunity after
each cycle Performance CopyProf.CPr to start a bat-file
(by default CopyProf.Bat). 

In real system it can be used for sending files to the addressees
Come and fixed (program) in the certain catalogues. 

------------------------------------------------------------------------------- -

 4. Complete set of delivery:

    CopyProf.Exe - executed module for Win32 .
    DOS\CopyProf.Exe - executed module for Dos (DPMI32).
    OS2\CopyProf.Exe - executed module for OS/2.
    
    CopyProf.Cfg - main file of adjustments of the program.       English
    Advanced.Cfg - file of additional adjustments of the program. English
    Register.Cfg - file of adjustments for the registered program.  Engl.

    CopyProf.CPr - file of the input catalogues, masks for search and output 
                   The catalogues for them. (interpretive file) English

    Rus.Cfg\CopyProf.Cfg - main file of adjustments of the program.      Russian 
    Rus.Cfg\Advanced.Cfg - file of additional adjustments of the program.Russian 
    Rus.Cfg\Register.Cfg - file of adjustments for the registered program.Russ.
  
    Rus.Cfg\CopyProf.CPr - file of the input catalogues, masks for search
                           and output the catalogues for them.
                           (interpretive file)  Russian.

    CopyProf.Log - the file of a log programm (occurs at the appropriate
                    adjustments The name can be any).      

    The catalogue Document
      RusDokum.Txt   - Documentation to the program in Russian.
      EngDokum.Txt   - Documentation to the program in English.
      LicFreeRus.Txt - License on free not registered the version In Russian.
      LicRegRus.Txt  - License for the registered version In Russian.
      RegRuss.Txt    - Registration in Russian.
      LicFreeEng.Txt - License on free not registered the version In English.
      LicRegEng.Txt  - License for the registered version In English.
      RegEngl.Txt    - Registration in English.

------------------------------------------------------------------------------


 5. Installation. 

       If at you the operational system Windows95/98/2000/NT is established...
       (32 digit Windows), you can pass this item.
              
                If at you is established Dos, you can save
       CopyProf.exe, having moved it in the catalogue W32, but in any case
       It is necessary for job under DOS to copy/move
       CopyProf\D32\CopyProf.Exe in CopyProf\CopyProf.Exe
       (If you are in the catalogue CopyProf, it can be made 
       By commands "Move CopyProf.Exe .\W32\CopyProf.Exe"
       And then " Copy .\D32\CopyProf.Exe .").
                    
                If at you is established OS/2, you can save
       CopyProf.exe, having moved it in the catalogue W32, but in any case
       It is necessary for job under OS/2 to copy/move
       CopyProf\OS2\CopyProf.Exe in CopyProf\CopyProf.Exe
       (If you are in the catalogue CopyProf, it can be made 
       By commands " Move CopyProf.Exe .\W32\CopyProf. Exe "
       And then " Copy .\OS2\CopyProf.Exe .").

------------------------------------------------------------------------------

  6. Common rules - agreement accepted in the program:

  6.1 Uniform style of the interface:

              Red    - the restriction(s), mistake work
              Cyan(ice) - pay the special attention.
                          (Not past on a condition for attributes files)
              Yellow - pay attention
              Green  - information messages
              White  - conclusion of the current parameters...
              Grey   - successfully done operations. 

   6.2 Uniform rules of syntax in textual files files:
       CopyProf.Cfg (*.Cfg) and CopyProf.CPr, namely:
                                      
        6.2.1 In any place there can be a comment
              The comment works up to the end of the current line.
              As the comment the set is used
              Symbols: --// (as the comment in Java)
                 Example:
              --// Here it is possible to describe as what for is made. 
              If comment is in beginning of a line (that as follows from 
              The descriptions above mentioned) all line is the comment.

        6.2.2 If any word contains in configuration files
              Blank(s) (for example, input catalogue or mask),
              It is necessary to conclude the given word in inverted commas.
                 Example:
              It is necessary to define the input catalogue of a kind:
              C:\Program Files\My Program\
              It is necessary to write in files of a configuration:
              "C:\Program Files\My Program\"

------------------------------------------------------------------------------ 

  7. Adjustment of a file of a configuration of the program.

     Read the comments in a file of adjustments of the program CopyProf.Cfg 

     Further some things requiring explanatories here will be described: 

  7.1 If you want, that files (for example CopyProf.Log...) were created
      Or were read out in/from the current catalogue - simply write down
      them without a name
      - By default <Programm_Path>\CopyProf.Log   

  7.2 Some remarks on the accompanying documents to files:

  7.2.1 Probably easier simply to result an example:

Example of the accompanying document to a file hpt0101.rar

--// ******* a Beginning of a file 30105900. (s) ******* <
            The accompanying document 30105900. (s)
                  Is made: 30.12.99 at 10:59:00

                        The name of Organization
         The executor: a surname .. Ph. (812) 123-45-67
         To whom: departments of a MANAGEMENT INFORMATION SYSTEM
                       of statistics payments 
Ŀ
 N      Name       the Size         Type         
    of a file    of a file  of the information 
                   (byte)                        
Ĵ
 1   HPT0101.RAR   102241      New tosser        

--// ******* the End of a file 30105900. (s) ******* <

  7.2.2 It is considered, that the accompanying document belongs to a file,
        From here 2 consequences:
        a.) Accompanying document is dispatched on the same ways as file.
        b.) Accompanying document for separate file is not considered in 
            Variable <NUMBER_FILE>.

  7.2.3 That the accompanying document was found, it is necessary to observe
        Conditions:
        1. The file should act not earlier accompanying document
           (Or simultaneously).
        2. A file and accompanying document owe is in one catalogue.
        3. It is very desirable, that the sets of masks of files were
           not crossed With set accompanying document.
           (Differently accompanying document can be accepted for
           independent File and to leave on other route...)  
           Usually use a mask *.(s)
--// Mask of files of the accompanying document
Mask_Sopr *. (s)

 *7.2.4 Only for the 'advanced' users.
              
             The algorithm of a finding accompanying document is simple enough.
        The program searches for files in the catalogue of the found file on
        a mask Files of the covering note, then looks through contents of files
        on lines on a finding there of name of the found file
        (Certainly having resulted them to one register).
             If such entry is found - that a file it is considered
       accompanying document.   

  7.3 In some types of tasks you can be required to execute a file
       The configurations only 1 time, (For example, you want to create archive 
       Incoming mail FIDO), and then to leave from the program automatically -
       For this purpose exists variable in a file of a configuration:
--//
--// Quantity(amount) of cycles of performance of files of a configuration 0 (to not leave)
--// by default 0 
--// Valid_Cycle_Full_Run
--//   

       Write:

Valid_Cycle_Full_Run 1

       And all...

------------------------------------------------------------------------------ 

  8. Adjustment of an interpretive file CopyProf.CPr .
      
         Usually it most often changeable file having following(next) 
      Structure of record:

      1. List of the input catalogues
      2. Description of a mask.
      3. List of the output catalogues.
      4. Command of copying - carry

         Rules:

      1. On termination(ending) a file CopyProf.CPr (before transition to the
         following cycle)  reset list the Input and Output catalogues. 
      2. If in last record of a file CopyProf.CPr the command is absent,
         That the system considers Command: Do-All.

Structure of record:
--// a Beginning of structure of record 
<First input catalogue>
<Second input catalogue>
<Third input catalogue>
<And so on how much it is necessary...>
Mask: <Pattern_Mask>
< First output catalogue >
< Second output catalogue >
< Third output catalogue >
< And so on how much it is necessary... >
Command: a command of copying-carry
--// the End of structure of record 

    Structure CopyProf.CPr: record, next record... Last record.

    Or (too most) as the block diagram:

                    ͻ
   Beginning >>Ķ Record >>    End
   File            ͼ          of a file
                                
                           

    Where the RECORD has the following structure:

        Ŀ       ͻ       Ŀ       ͻ
         Input         Mask         Output          Command  
>>Ĵ  Dir  >>Ķ  of  >>Ĵ   Dir  >>Ķ of copying>
                    search                     /of carry 
             ͼ            ͼ
                                                 
                 

Conditional designations:

    ͻ  
    ͼ  - Obligatory block
    Ŀ
      - Can in some structures be absent..

The note:   amount of the input and output catalogues at achievement
            Commands of copying - carry should be not less than one.
            (Differently command is not meaningful) 
            It is clear, that in 1 record the entrance and target catalogues
            owe to be determined.

Syntax of commands of copying-carry:

1. Copy

   Command: Do --// 1 variant 
   Command: ** --// 2 variant

2. Copy and to reset list of input dir

Command: Do-In --// 1 variant
Command: 0*    --// 2 variant

3. Copy and to reset list of output dir

Command: Do-Out --// 1 variant
Command: *0     --// 2 variant

4. Copy and to reset list of input and output dir

Command: Do-All --// 1 variant
Command: 00     --// 2 variants

Example:

--// a Beginning of record 
--// a MANAGEMENT INFORMATION SYSTEM - > the Information!!! 
D:\Input
Mask: asuinfo.txt
P:\POST\<MONTH>_<YEAR>\<DAY>\
D:\Vologda\POST.OTS\OUT\
D:\Vologda\POST.CLN\OUT\
D:\Vologda\POST.PLT\OUT\
D:\Vologda\POST.DTC\OUT\
D:\Vologda\POST.VAL\OUT\
D:\Vologda\POST.OTO\OUT\
Command: Do-All
--// the End of record 

Still example from 3 records:

--// > a file CopyProf. Cpr < Here begins
--// a MANAGEMENT INFORMATION SYSTEM - > the Information!  
D:\Input1
D:\Input2
D:\Input3
Mask: asuinfo.txt
P:\POST\<MONTH>_<YEAR>\<DAY>\
D:\Vologda\POST.OTS\OUT\
D:\Vologda\POST.CLN\OUT\
D:\Vologda\POST.PLT\OUT\
D:\Vologda\POST.DTC\OUT\
D:\Vologda\POST.VAL\OUT\
D:\Vologda\POST.OTO\OUT\
Command: Do-Out
--// the End of record    
Mask: 1a*.rar
P:\POST\<MONTH>_<YEAR>\<DAY>\
D:\Vologda\POST.OTS\OUT\
D:\Vologda\POST.CLN\OUT\
D:\Vologda\POST.OTO\OUT\
Command: Do-Out
--// the End of record 
Mask: 2c*.rar
P:\POST\<MONTH>_<YEAR>\<DAY>\
D:\Vologda\POST.OTS\OUT\
D:\Vologda\POST.CLN\OUT\
D:\Vologda\POST.PLT\OUT\
Command: Do-All --// And this line Is unessential;)
--// the End of record    
--// End file CopyProf.CPr   

The note: the author reserves the right to modify syntax,
          But with preservation of an old configuration.

The program in a file of a configuration of the target catalogues
            Understands the following variable:

ͻ
                    In decimal     In digital-symbolical 
                    performance    performance           
                   Ķ
 Current year         <YEAR>                             
         Month        <MONTH>          <MONTH_CHAR>      
         Day          <DAY>            <DAY_CHAR>        
         Hour         <HOUR>           <HOUR_CHAR>        
         Minute       <MIN>                              
         Second       <SEC>                              
Ķ 
 Number of a file   <NUMBER_FILE>                         
 Found On a mask                                         
ͼ

The note is understood digital-symbolical representation:
           0-0; 1-1; 2-2; 3-3; 4-4; 5-5; 6-6; 7-7; 8-8; 9-9;
           10-A; 11-B; 12-C; 13-D; 14-E; 15-F; 16-G; 17-H; 18-I; 19-J;
           20-K; 21-L; 22-M; 23-N; 24-O; 25-P etc.

The expressions should be in the TOP register!!!

The program "understands" the following variable:

Ŀ
 Directory - where the program     <PROGRAMM_PATH> 
 Initial Directory of the program  <START_PATH>    


In practice often it is required to create archives of the come files of a kind:
     2000-01-01
     2000-01-02
     2000-02-28
     2000-03-05
     Year-month-day
The target catalogue will look as follows:
D:\Output\20<YEAR>-<MONTH>-<DAY>\

--------------------------------------- --------------------------------------- -

   9. How correctly to make a file CopyProf.Cpr?

   The recommendations:

   9.1 Be defined as where to copy.

   9.2 Allocate the common catalogues
        Whether (Input and output) also decide the common catalogues
        will change (In the future at updating) simultaneously whether or not.

EXAMPLE:

  If the catalogues will change simultaneously for different masks,
That is better for writing down:

--// Example variant 1
C:\Input1\
C:\Input2\
Mask: *.Lzh
C:\OutPut1\
C:\OutPut1\
Command: Do
Mask: 1.Arj
Command: Do-All

And if the list of the entering catalogues will change for each mask 
On any other business, it is better to write:

--// Example variant 2
C:\Input1\
C:\Input2\
Mask: *.Lzh
C:\OutPut1\
C:\OutPut1\
Command: Do-In
C:\Input1\
C:\Input2\
Mask: 1.Arj
Command: Do-All

And if the list of the target catalogues will change for each mask
On any other business, it is better to write:

--// Example variant 3
C:\Input1\
C:\Input2\
Mask: *.Lzh
C:\OutPut1\
C:\OutPut1\
Command: Do-Out
Mask: 1.Arj
C:\OutPut1\
C:\OutPut1\
Command: Do-All

And if the list of the entrance and target catalogues will change 
For each mask on any other business, it is better to write:

--// Example variant 4
C:\Input1\
C:\Input2\
Mask: *.Lzh
C:\OutPut1\
C:\OutPut1\
Command: Do-All
C:\Input1\
C:\Input2\
Mask: 1.Arj
C:\OutPut1\
C:\OutPut1\
Command: Do-All

9.3 What for it is necessary?

     To reduce the size of a file of a configuration, (to make it less).
     Simplicity of updating.

For example, let is given:

The list of the entrance catalogues will extend for all masks.
At first it was necessary
To copy from C:\AB1\ files with a mask *.rar in D:\Arhiv\
                                And to transfer in D:\Ab\
And also: 
To copy from C:\AB2\ files with a mask *.rar in D:\Arhiv\
                                And to transfer in D:\Ab\
Then 
To copy from C:\AB1\ files with a mask *.bat in D:\Arhiv\
                                And to transfer in D:\Ab\
And also: 
To copy from C:\AB2\ files with a mask *.bat in D:\Arhiv\
                                And to transfer in D:\Ab\

Then the task has changed:
To copy from C:\AB1\ files with a mask *.rar in D:\Arhiv\
                                And to transfer in D:\Ab\
To copy from C:\AB2\ files with a mask *.rar in D:\Arhiv\
                                And to transfer in D:\Ab\
And also: 
To copy from C:\AB3\ files with a mask *.rar in D:\Arhiv\
                                And to transfer in D:\Ab\

Then 
To copy from C:\AB1\ files with a mask *.bat in D:\Arhiv\
                                And to transfer in D:\Ab\
To copy from C:\AB2\ files with a mask *.bat in D:\Arhiv\
                                And to transfer in D:\Ab\
And also: 
To copy from C:\AB3\ files with a mask *.bat in D:\Arhiv\
                                And to transfer in D:\Ab\

Recommended way of the decision of a problem:
--// At first was:
C:\AB1\
C:\AB2\
Mask: *.rar
D:\Arhiv\
D:\Ab\
Command: Do
Mask: *.bat
Command: Do-All

--// Then became
C:\AB1\
C:\AB2\
C:\AB3\
Mask: *.rar
D:\Arhiv\
D:\Ab\
Command: Do
Mask: *.bat
Command: Do-All

------------------------------------------------------------------------------ 

  10. Description of job and interface of the program.

     For start of the program it is necessary to enter a command:
         CopyProf.Exe 
And to press a key <Enter>.

     After start of the program there is a following window:

Free Version                 Friday, 22 June 2001 year.                 12:03:48
 History of search  The list of unknown files Ŀ
            1 Programm  work  And it only in Registration version!           
     pru*.(s) 0 Day 00:00:07                                                 
    1okd*.lzh         Cycles                                                 
            1              2                                                 
     pru*.(s)   Found  files                                                 
    1okd*.lzh              0                                                 
               Size of bytes                                                 
                           0                                                 
              In   7 Out   2                                                 
 The done operations ͵
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              

     Professional Auto-Copy ( Scatter ) of files 1.10 version ( Win+ ) 2001y.


 Let's consider in detail appointment of each of windows.

     10.1 Window a History of search.
          Is intended for a conclusion of the information: 
             On what mask there is a search.
             The program what is the time works.
             (In the given realization the time is taken into account only 
             Jobs of the  program - the time is not taken into account
             When the external bat-file) is carried out
             With what under the bill the cycle is carried out at the given
             moment.
             How much is found of files.(without the account got under
                                                          restriction)
             Size in bytes of the found files.(without account got under 
                                                            Restrictions)
             Amount of the input and output catalogues (for each mask) 

     10.2 Window the List of unknown files.
             Is intended that to the man from time to time not it was necessary
             to look through contents of the input catalogues,
             On case if will come files, which do not fall under
             One of masks, and the program does not know that with them to do.          

                At the given list there are files 2 types selected 
             By various colours:
             1. Got under one of masks of a file of a configuration
                - Are allocated with yellow colour.
             2. Got even under 1 mask of a file of a configuration but
                Not past on a condition for  attributes of files.
                - Are allocated cyan(ice) colour.  


     10.3 Window the Done operations.
             The information window - displays operations, made 
             By the program on creation of the catalogues, copying, carry
             Files, and also information messages.

             *=> - designates copying a file.
             O=> - designates carry of a file.


  EXIT FROM the PROGRAM:
            For an exit from the program it is enough to press any key.
            (The program can leave and on adjustments of a file of a
                                                        configuration.) 

------------------------------------------------------------------------------ 

 11. Some remarks concerning the versions for different operational systems.

     1. The version under DOS (DPMI32) does not support long files.
     2. It is recommended to use the version for the operational system.
        (You certainly can use DOS (DPMI32) the version in Win32 and OS/2
          Operational systems - and she will work, but the author recommends
          To use the version for the operational system.)

----- END of a FILE ---------------------------------------------------------




